Requirement to install the DevTest Java Agent:
Java Agent Startup Parameters:
- Supported Applications: The agent works with most Java applications but only a few applications are supported. A supported application means it has been fully tested and should work without issues. An unsupported application indicates little or no testing has been performed. However, most unsupported applications work with little effort. An unsupported application becomes a "Best Effort" on the part of CA Support and Development.
- Other Java Agents: Only one DevTest Agent can be installed in an application. Other vendors agents may or may not work with the DevTest Agents. The way any Java agents works will sometimes force the agents to complete against each other. If you need to install agents from another vendor, please list the DevTest agent first on the command line.
- Memory: The agent captures transactions from several protocols and sends this information to the DevTest broker. As a result it is common for the application to require a little more memory. Use the -Xmx java command line parameter to set the heap size.
- Agent Jars: There are three agents jars required to install the DevTest Agent. InsightAgent.jar, LisaAgent.jar and LisaAgent2.jar. Note: InsightAgent.jar and LisaAgent2.jar are almost identical files. The only difference is the way the jars are compiled. Most applications will reference InsightAgent.jar but some application prefer LisaAgent2.jar (see below).
- Agent Jars Location: The three jar files can be placed in any directory anywhere on the machine running the application. However, the directory must be located outside the application's classpath.
- Agent Jar Directory: The directory must have read and write permission for the user that starts the application. The DevTest agent will write a new log file every time the application is restarted.
- Agent Names: The DevTest java agent must have a unique name (see below). The unique name is used for communication with the broker. If two or more agents have the same name, communication will break down and errors will occur.
Some application start using a script and some have a User Interface for setup parameters. Please consult the DevTest documentation for specific installation instructions. However, they all have the same basic format.
-javaagent:<path to agent jars>=name=<agent_name>,url=<broker_url>
At startup, tells the Java JVM this is a special kind of jar and will act as a Java Agent.<path to agent jars>:
Fully qualified path to the agent jar files. Example: "C:\DevTest_Agents\InsightAgent.jar"<agent_name>:
A unique name for this agent. Usually the name includes information about the machine or application where the agent is running.<broker_url>:
Connection information to the DevTest Broker. Examples: tcp://192.168.1.1:2009 or ssl://localhost:2009 The port is the port the broker is listening on and must be open for two way communication.Environment Not Supported:
- Open JDK all versions
- Java Scripting environments such as Node.js