Connect to Tomcat

After you install OverOps on your machine, you’ll need to connect it to your Tomcat server.

Please choose the Tomcat launch configuration you’re using:

Standalone Tomcat

Windows Service

Eclipse Plugin

IntelliJ Plugin

NetBeans Plugin

 

Standalone Tomcat

Linux / macOS:
  • Locate the catalina.sh file you use to run Tomcat.
  • Create setenv.sh in the same folder if it doesn’t already exist.
  • Add the following line to the end of setenv.sh: CATALINA_OPTS="$CATALINA_OPTS -agentlib:TakipiAgent"
  • Restart Tomcat.
  • Test the installation – head back to app.overops.com and click .

    If the connecting process was successful, you will get a “Monitoring” message next to your JVM.

  • Throw an exception, or make sure your application throws exceptions.
Windows:
  • Locate the catalina.bat file you use to run Tomcat.
  • Create setenv.bat in the same folder if it doesn’t already exist.
  • Add the following line to the end of setenv.bat:set CATALINA_OPTS=%CATALINA_OPTS% -agentlib:TakipiAgent
  • Restart Tomcat.
  • Test the installation – head back to app.overops.com, and click .


    If the installation was successful, a “OverOps is active” message will be displayed, and a green “Monitoring” message will appear next to your JVM(s).

  • Throw an exception, or make sure your application throws exceptions.

 

Windows Service

Apache Tomcat has a configuration application which allows you to specify JVM arguments for the server when running as a service. To install the OverOps agent on Tomcat (Windows):

  • Click Start > All programs > Apache Tomcat (version) > Configure Tomcat.
  • Switch to the Java tab.
  • In the Java Options box, add: -agentlib:TakipiAgent.
  • Select Apply.
  • Restart your machine.
  • Test the installation – head back to app.overops.com and click .

    If the connecting process was successful, you will get a “Monitoring” message next to your JVM.

  • Throw an exception, or make sure your application throws exceptions.

 

Eclipse Plugin

  • Open Debug Configurations.
  • Select Apache Tomcat -> <Your Tomcat configuration>.
  • Switch to the Arguments tab.
  • In the VM arguments box, add -agentlib:TakipiAgent
  • Click Apply.
  • Start Tomcat.
  • Test the installation – head back to app.overops.com and click .

    If the connecting process was successful, you will get a “Monitoring” message next to your JVM.

  • Throw an exception, or make sure your application throws exceptions.

 

IntelliJ Plugin

  • Edit Tomcat Run/Debug configurations.
  • In the VM options box, add: -agentlib:TakipiAgent
  • Click OK.
  • Start Tomcat.
  • Test the installation – head back to app.overops.com and click .

    If the connecting process was successful, you will get a “Monitoring” message next to your JVM.

  • Throw an exception, or make sure your application throws exceptions.

 

NetBeans Plugin

  • Enter the Services window (Window | Services).
  • Expand Servers.
  • Right click on the Apache Tomcat server.
  • Select Properties.
  • Switch to the Platform tab.
  • In the VM Options box, add: -agentlib:TakipiAgent.
  • Start Tomcat.
  • Test the installation – head back to app.overops.com and click .

    If the connecting process was successful, you will get a “Monitoring” message next to your JVM.

  • Throw an exception, or make sure your application throws exceptions.

 

Have more questions? Submit a request