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

Body

Symptom:

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

Cause:

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

Solution:

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

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 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>,

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

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