IBM WebSphere and InfoSphere Startup Settings

The Java Agent passes the -javaagent argument command line option to WebSphere to ensure the App Server Agent has the correct permissions to monitor your app.

Instrument WebSphere 7.x, 8.x, and 9.x, or InfoSphere 8.x

Note: When using certain IBM Java 8 runtimes (earlier than SR6 FP25), the Java agent might default to using TLSv1.0 for outbound communication to the Controller. To ensure that the agent utilizes TLSv1.2, set the following additional JVM argument in the generic arguments for the WebSphere JVM.
CODE 
-Dappdynamics.agent.ssl.protocol=TLSv1.2
For more information, see Splunk AppDynamics Agent SSL Protocol.
  1. Log in to the administrative console for the WebSphere node where you want to install the App Server Agent.
  2. In the administrative console, select Servers > Server Types > WebSphere application servers .
  3. Select the name of your server.
  4. In the Server Infrastructure section, select Java and Process Management > Process Definition.
  5. Under the Additional Properties section, select Java Virtual Machine.
  6. Enter the javaagent option with the full path to the Splunk AppDynamics javaagent.jar file in the Generic JVM arguments field.
    For Windows:
    CODE 
    -javaagent:<Drive Letter>:<agent install location>\javaagent.jar
    For Linux:
    CODE 
    -javaagent:<agent install location>/javaagent.jar
  7. Click OK.
WebSphere uses Equinox as its OSGi container. In some cases, you may also need to add the Java agent packages to the OSGi bootdelegation system property:
CODE 
-Dorg.osgi.framework.bootdelegation=META-INF.services,com.singularity.*,com.ibm.*

Instrument WebSphere 6.x

  1. Log in to the administrative console for the WebSphere node where you want to install the Java Agent.
  2. In the left navigation tree, select Servers > Application servers .
  3. Click the name of your server in the list of servers.
  4. In the Configuration tab, select Java and Process Management.
  5. Enter the javaagent option with the full path to the Java Agent javaagent.jar file in the Generic JVM arguments field.
    For Windows:
    CODE 
    -javaagent:<Drive Letter>:<agent install location>\javaagent.jar
    For Linux:
    CODE 
    -javaagent:<agent install location>/javaagent.jar
  6. Click OK.

Instrument WebSphere 5.x

  1. Log in to the administrative console of the WebSphere node where you want to install the App Server Agent.
  2. In the administrative console, click Servers.
  3. Click Application Servers.
  4. Click the name of your server.
  5. Under Additional Properties, click Process Definition.
  6. On the next page, under Additional Properties, click Java Virtual Machine.
  7. Enter the javaagent option with the full path to the Java Agent javaagent.jar file in the Generic JVM arguments field.
    For Windows:
    CODE 
    -javaagent:<Drive Letter>:<agent install location>\javaagent.jar
    For Linux:
    CODE 
    -javaagent:<agent install location>/javaagent.jar
  8. Click OK.

Verify the Java Agent Configuration

Verify the configuration settings by checking the server.xml file of the WebSphere node where you installed the Java Agent. The server.xml file should have this entry:

CODE 
<jvmEntries ... genericJvmArguments='-javaagent:E:\test1\AppServerAgent\javaagent.jar' disableJIT="false"/>