The Tomcat agent was not able to register the startup parameters (for DC) if there were different startup scripts

Body

Symptom:

The Tomcat agent was not able to register the startup parameters (for DC) if there were different startup scripts.

Cause:

The Tomcat agent was not able to register the startup parameters(for DC).

Solution:

1. To register the startup parameters(for the DC) using a non-root user, add the following parameters in the existing startup script present under the <TOMCAT_HOME>/bin directory.

export LD_LIBRARY_PATH="<CANDLE_HOME>/otdchome/7.3.0.13.0/toolkit/lib/lx8266"
export RUNTIME_DIR="<CANDLE_HOME>/otdchome/7.3.0.13.0/runtime"export JAVA_OPTS="-agentlib:am_ibm_16=<CANDLE_HOME>/otdchome/7.3.0.13.0/runtime/<Tomcat_Application_Server>
-Xbootclasspath/p:<CANDLE_HOME>/otdchome/7.3.0.13.0/toolkit/lib/bcm-bootstrap.jar
-Djava.security.policy=<CANDLE_HOME>/otdchome/7.3.0.13.0/itcamdc/etc/datacollector.policy
-Dcom.ibm.tivoli.itcam.ai.runtimebuilder.inputs=<CANDLE_HOME>/otdchome/7.3.0.13.0/runtime/<Tomcat_Application_Server>/<Agent_Instance>_DCManual.txt
-Dcom.ibm.tivoli.itcam.serverHome=<TOMCAT_HOME>
-Dam.home=<CANDLE_HOME>/otdchome/7.3.0.13.0/itcamdc
-Dcom.ibm.tivoli.itcam.toolkit.runtime.dir=<CANDLE_HOME>/otdchome/7.3.0.13.0/runtime"

Note: <Tomcat_Application_Server> is a server name used while configuring tomcat agent.

2. Save the changes.

3. Restart the Tomcat Server.

4. Generate some requests to the web applications which are hosted on Tomcat Server.

5. To access ".jso" files, go to <CANDLE_HOME>/otdchome/7.3.0.13.0/runtime/<Tomcat_Application_Server>,

    Insure the permissions to the newly created /data/request directories are correct.
    a. If the Tomcat agent is using non-root user, give read/write permissions to the newly created /data/request directories.
    b. If the tomcat agent is using root user, ensure the newly created /data/request directories is owned by the root user.

6. Verify there are Deep Dive and Transactional Tracking Data on APM UI.