Update or Change Tomcat Application Server

To update or change Tomcat application server after Tomcat agent configuration, follow the steps given in this topic. These steps are common for both, Tomcat configured through Windows and Linux®.

Procedure

  1. Stop Tomcat agent instance and Tomcat Server
  2. Go to <TOMCAT_SERVER>/bin and open setenv.sh file in editor
  3. Remove all the startup parameters for Data Collector from setenv.sh. Remove following lines from the file 
    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"
  4. Save the changes and start Tomcat Server
  5. Reconfigure the Tomcat agent to update or change Tomcat Application Server
  6. Update or Change only the Tomcat Application Server and do not change any the other configuration setting
  7. Start Tomcat agent instance
  8. Check setenv.sh file is updated with new Tomcat Application Server in startup parameters for Data Collector
  9. Restart Tomcat Server
  10. Verify the changes made to Tomcat Application Server are reflected in Agent Machine and IBM® Cloud Application Performance Management dashboard
    • Verify Tomcat Application Server change at
      <CANDLE_HOME>/otdchome/7.3.0.13.0/runtime/<Tomcat_Application_Server> location on Agent machine
    • Verify Tomcat Application Server change on Aggregate Transaction Topology page and appserver attribute under KOT_Server Attribute Group on IBM Cloud Application Performance Management dashboard