To upgrade the Tomcat agent to toolkit build 7.3.0.15.0, you must ensure the
prerequisites given in this topic are complete.
Procedure
-
Before agent upgrade, remove the DC startup parameters from
setenv.sh/setenv.bat file. Remove following DC startup parameters from
setenv.sh/setenv.bat file.
export LD_LIBRARY_PATH="/opt/ibm/apm/agent/otdchome/7.3.0.13.0/toolkit/lib/lx8266":$LD_LIBRARY_PATH
export RUNTIME_DIR="/opt/ibm/apm/agent/otdchome/7.3.0.13.0/runtime":$RUNTIME_DIR
export JAVA_OPTS="-agentlib:am_ibm_16=<Agent_Install_Dir>/otdchome/7.3.0.13.0/runtime/<Tomcat_Application_Server>
-Xbootclasspath/p:<Agent_Install_Dir>/otdchome/7.3.0.13.0/toolkit/lib/bcm-bootstrap.jar
-Djava.security. policy=<Agent_Install_Dir>/otdchome/7.3.0.13.0/itcamdc/etc/datacollector.policy
-Dcom.ibm.tivoli.itcam.ai.runtimebuilder.inputs=<Agent_Install_Dir>/otdchome/7.3.0.13.0/runtime/<Tomcat_Application_Server>/<Tomcat_Agent_Instance>_DCManual.txt
-Dcom.ibm.tivoli. itcam.serverHome=<Tomcat_Server>/apache-tomcat-<Version>
-Dam.home=<Agent_Install_Dir>/otdchome/7.3.0.13.0/itcamdc
-Dcom.ibm.tivoli.itcam.toolkit.runtime.dir=<Agent_Install_Dir>/otdchome/7.3.0.13.0/runtime":$JAVA_OPTS
- Restart the server.
- Stop the server.
- Upgrade the agent with new upgraded toolkit build (7.3.0.15.) build
- Verify the agent version and required /otdchome and
otdchome_backup folders.
- Start the Tomcat Server
- Restart the Tomcat agent
- Verify that the setenv.sh/setenv.bat has the upgraded toolkit
7.3.0.15.0 DC startup parameters.
- Restart the Tomcat Server. Server should stop properly without any issues
- Verify the End-To-End agent functionality.