DX APM Wily Java Agent fails to load in Identity Suite v15 via idg.yaml

Products

• CA Identity Suite

Issue/Introduction

When attempting to instrument Identity Governance (IG) v15 with the DX APM Java Agent, the agent does not load even after adding the -javaagent arguments to the idg.yaml file. The Java process command line does not show the agent argument, and no agent logs are created.

Users may have tried variations of the following in idg.yaml without success:

jvm_args: - "-javaagent:/opt/brcm/apm_ig/Agent.jar"

Environment

IGA v15

Cause

The Identity Governance v15 configuration loader does not recognize the key jvm_args. For YAML-based configuration in this version, the correct variable for passing JVM arguments is java_opts.

• java_opts is the global variable used by the v15 wrapper to inject parameters into the startup command.

Resolution

To successfully load the DX APM agent, use one of the two following methods:

Method 1: Update idg.yaml

Modify the idg.yaml file to use the java_opts key. Ensure the syntax is formatted as a single line or a valid YAML list:

yaml

 

java_opts: -javaagent:/opt/brcm/apm_ig/Agent.jar -Dcom.wily.introscope.agent.agentName=IdentityGovernance -Dorg.osgi.framework.bootdelegation=com.wily.*

Method 2: Use the Identity Governance Xpress (IGX) Console

Engineering recommends using the console for a more managed configuration:

1. Log in to the IGX (Xpress) Console.
2. Navigate to the Services screen.
3. Locate the Service Configuration page for the service you wish to instrument.
4. Add the required agent strings into the JAVA OPTIONS field.
5. Save the configuration and restart the service.

Verification

After restarting the service, run the following command to confirm the JVM has picked up the agent: ps -ef | grep java | grep Agent.jar