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.
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:
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
To verify the agent is working:
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.