Configuring the Java Agent on Apache Tomcat

Document ID:  TEC603956
Last Modified Date:  07/13/2017
{{active ? 'Hide' : 'Show'}} Technical Document Details


  • CA Continuous Application Insight
  • CA Application Test
  • CA Service Virtualization


  • CA Continuous Application Insight:Release:10.0
  • CA Continuous Application Insight:Release:7.1
  • CA Continuous Application Insight:Release:7.5.0
  • CA Continuous Application Insight:Release:7.5.1
  • CA Continuous Application Insight:Release:7.5.2
  • CA Continuous Application Insight:Release:8.0.0
  • CA Continuous Application Insight:Release:8.0.1
  • CA Continuous Application Insight:Release:8.0.2
  • CA Continuous Application Insight:Release:8.1
  • CA Continuous Application Insight:Release:8.2
  • CA Continuous Application Insight:Release:8.3
  • CA Continuous Application Insight:Release:8.4
  • CA Continuous Application Insight:Release:8.5
  • CA Continuous Application Insight:Release:9.0
  • CA Continuous Application Insight:Release:9.1
  • CA Continuous Application Insight:Release:9.5
  • CA Continuous Application Insight:Release:9.5.1
  • CA Service Virtualization:Release:10.0
  • CA Service Virtualization:Release:10.1.0
  • CA Service Virtualization:Release:7.1
  • CA Service Virtualization:Release:7.5.0
  • CA Service Virtualization:Release:7.5.1
  • CA Service Virtualization:Release:7.5.2
  • CA Service Virtualization:Release:8.0.0
  • CA Service Virtualization:Release:8.0.1
  • CA Service Virtualization:Release:8.0.2
  • CA Service Virtualization:Release:8.1
  • CA Service Virtualization:Release:8.2
  • CA Service Virtualization:Release:9.1
  • CA Service Virtualization:Release:9.0
  • CA Service Virtualization:Release:8.5
  • CA Service Virtualization:Release:8.4
  • CA Service Virtualization:Release:8.3
  • CA Service Virtualization:Release:9.5
  • CA Service Virtualization:Release:9.5.1



Tomcat is an unsupported environment.

However, the DevTest agent has been successfully deployed to several Tomcat environments and is working as expected.


Prerequisite: Tomcat must run on a supported OS and java version.
Please see the DevTest documentation for supported OS and java versions.

Ensure Tomcat is running correctly before adding the DevTest agent.

Note: Since Tomcat is an unsupported environment, support will offer a best effort and can offer general guidelines for your unique environment.

All supported DevTest platforms.

Tomcat is highly configurable and the below instructions are for a default Tomcat install.
Adjustments maybe necessary based on your exact configuration.

Insert the agent startup/configuration command at the beginning of the first startup script.
The variable CATALINA_OPTS should be used instead of JAVA_OPTS or JAVA_TOOL_OPTIONS.
From Tomcat documentation:
CATALINA_OPTS   (Optional) Java runtime options used when the "start", "run" or "debug" command is executed.
Include here and not in JAVA_OPTS all options, that should only be used by Tomcat itself, not by the stop process, the version command etc. Examples are heap size, GC logging, JMX ports etc.

The usual startup script is:
Windows: startup.bat

Insert the agent startup/configuration command as the first non-comment line:
set CATALINA_OPTS=-javaagent:<pathTo LisaAgent2.jar>=name=<agentName>,url=<connectionToBroker>

<pathTo LisaAgent2.jar> = Complete path to the LisaAgent2.jar
<agentName> =  Must be a unique name and will be the name used in the portal.
<connectionToBroker> = Connection to broker usually something like: tcp://<RegistryHost>:2009

set CATALINA_OPTS=-javaagent:C:\DevTest_Agents\10.1.0\LisaAgent2.jar=name=tomcat-3,url=tcp://localhost:2009

To verify the agent is working:
Restart Tomcat
In the DevTest portal (a page refresh maybe needed):
Settings -> Agents
The agents unique name should appear in the list of agents.

If further assistance is needed, please open a support ticket.
Since Tomcat is an unsupported environment, support will offer a best effort and can offer general guidelines for your unique environment.


Additional Information:

Not applicable

Please help us improve!

Will this information enable you to resolve your issue?

Please tell us what we can do better.

{{feedbackText.length ? feedbackText.length : '0'}}/255


Not what you were looking for?

Search Again >

Product Information

Support by Product >


Join a Community >