Installing Java Agent in Tomcat Server 6.x and above

Installing Java Agent in Tomcat Server 6.x & above

1. Extract the zip file to a new directory to find agent jar and its configuration files.
2. Open apminsight.conf file in any text editor and add license.key value, which can be obtained from Site24x7 APM Insight page. Refer here to fine tune the agent settings.
3. For Tomcat as non-service installation:
   In Windows, edit <TOMCAT_HOME>\bin\catalina.bat and add the following entry to the top and save the file.
   
   set JAVA_OPTS=%JAVA_OPTS% -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar
   In Linux, edit <TOMCAT_HOME>/bin/catalina.sh and add the following entry to the top and save the file.
   
   export JAVA_OPTS="$JAVA_OPTS -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar"
4. For Tomcat as service installation, navigate to Configure Tomcat > JAVA tab and add the entry in Java Options textbox.
   
   -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar
   
   
   Though the above screenshot is for Windows installation, all the steps given are applicable for Linux installation as well.
5. After adding the entry, click Apply.
6. Start the tomcat server.

Video

Here's a quick video on how to install a Site24x7 APM Insight Java agent in Tomcat Server (6.x and above) on Linux.