Configuring the Java Agent on Apache Tomcat for DevTest using CATALINA_OPTS
search cancel

Configuring the Java Agent on Apache Tomcat for DevTest using CATALINA_OPTS


Article ID: 9469


Updated On:


Service Virtualization CA Continuous Application Insight (PathFinder)


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.



All supported DevTest platforms and releases.




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 scripts are:

  • Windows: startup.bat
  • Unix/Linux:

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\x.x\LisaAgent2.jar=name=tomcat-3,url=tcp://[server]:2009

where x.x is the version of DevTest you are on.

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.

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