Connect to Tomcat

When OverOps is installed on your machine, connect it to your Tomcat server.

Follow the instructions of the relevant Tomcat launch configuration:

Standalone Tomcat

Windows Service

Eclipse Plugin

IntelliJ Plugin

NetBeans Plugin

 

Standalone Tomcat

To connect OverOps to Tomcat running on Linux/macOS:

  1. Locate the catalina.sh file used to run Tomcat.
  2. If it doesn’t already exist, create a setenv.sh file in the same folder.
  3. Add the following line to the end of setenv.sh file:
    CATALINA_OPTS="$CATALINA_OPTS -agentlib:TakipiAgent"
  4. Restart Tomcat.
  5. Test the installation: From the OverOps web application dashboard, click Add Server and then, from the dialog box, click Next and then click Test Installation.

    When the connection is established, the JVM status is 'Monitoring'.

  6. Test that your application throws exceptions.

 

To connect OverOps to Tomcat running on Windows:

  1. Locate the catalina.bat file used to run Tomcat.
  2. Create setenv.bat in the same folder if it doesn’t already exist.
  3. Add the following line to the end of setenv.bat file: 
    set CATALINA_OPTS=%CATALINA_OPTS% -agentlib:TakipiAgent
  4. Restart Tomcat.
  5. Test the installation: From the OverOps web application dashboard, click Add Server and then, from the dialog box, click Next and then click Test Installation.



    When the connection is established, the JVM status is 'Monitoring'.

  6. Test that 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):

  1. In the Start menu, from All programs, select Apache Tomcat (version), and click Configure Tomcat.
  2. From the Apache Tomcat Properties, switch to the Java tab and in the Java Options field, add:
    -agentlib:TakipiAgent.

  3. Select Apply and then OK.
  4. Restart your machine.
  5. Test the installation: From the OverOps web application dashboard, click Add Server and then, from the dialog box, click Next and then click Test Installation.

    When the connection is established, the JVM status is 'Monitoring'.

  6. Test that your application throws exceptions.

 

Eclipse Plugin

  1. From Eclipse, click Run and select Debug Configurations.
  2. From the Debug Configurations dialog box, select Apache Tomcat and then click the relevant Tomcat configuration.
  3. In the right pane, switch to the Arguments tab, and in the VM arguments field, add: 
    -agentlib:TakipiAgent



  4. Click Apply and then Close.
  5. Restart Tomcat.
  6. Test the installation: From the OverOps web application dashboard, click Add Server and then, from the dialog box, click Next and then click Test Installation.

    When the connection is established, the JVM status is 'Monitoring'.

  7. Test that your application throws exceptions.

 

IntelliJ Plugin

  1. From IntelliJ, open Edit Configurations.

  2. From Run/Debug Configurations, in the VM options field, add: -agentlib:TakipiAgent

  3. Click OK.
  4. Restart Tomcat.
  5. Test the installation: From the OverOps web application dashboard, click Add Server and then, from the dialog box, click Next and then click Test Installation.

    When the connection is established, the JVM status is 'Monitoring'.

  6. Test that your application throws exceptions.

 

NetBeans Plugin

  1. From NetBeans, from the Services window (Window | Services), click Servers.
  2. Right click the Apache Tomcat server and select Properties.
  3. In the Server Properties dialog box, switch to the Platform tab.
  4. In the VM Options field, add: -agentlib:TakipiAgent



  5. Click Close.
  6. Restart Tomcat.
  7. Test the installation: From the OverOps web application dashboard, click Add Server and then, from the dialog box, click Next and then click Test Installation.

    When the connection is established, the JVM status is 'Monitoring'.

  8. Test that your application throws exceptions.

 

Have more questions? Submit a request