Previous Topic: Options for Agent Parameters StringNext Topic: Example 1 - Pure Java Agent

Agents › DevTest Java Agent › Java Agent Installation › Agent Install Assistant

Agent Install Assistant

The agent install assistant is a command-line utility that helps you determine the value for the agent parameters string.

The agent install assistant also verifies that the JVM runs properly with the agent installed.

Note: If you intend to create TIBCO BusinessWorks baselines, add the heap option to the agent parameters string and set the value to true.

Automatic Configuration

The agent install assistant provides an option to automatically configure the Java agent on platforms that are based on the user values in the JavaAgentInstaller.xml file. This XML file is a template that contains the platform and the version information that is supported by DevTest. The JavaAgentInstaller.xml file is located in the same directory as the LisaAgent.jar file.

The following prerequisite steps must be performed to use the option to configure the Java agent automatically:

Follow these steps:

  1. Search for the platform that is based on the platform name and operating system type that is listed in the JavaAgentInstaller.xml file.
  2. Define the environment variable, if applicable.

    The environment variable is embedded in ${}, for example ${JBOSS_HOME}.

  3. Replace any customized value, if applicable.

    The customized value is embedded in {}, for example: 

    <ConfigFileName>${ORACLE_HOME}\user_projects\domains\{custom domain name}\bin\startWebLogic.cmd<ConfigFileName>

    Replace it with your project name: 

    <ConfigFileName>${ORACLE_HOME}\user_projects\domains\lisa_domain\bin\startWebLogic.cmd</ConfigFileName>
  4. Review all the predefined values and edit values that are based on your system.
Run the Agent Install Assistant

The following procedure has separate steps for entering the path of the java executable, the broker URL, and the agent name. However, you can specify any of these values in the second step instead.

Follow these steps:

  1. Go to the computer where you are installing the agent.
  2. Run the LisaAgent.jar file with the -ia option.
  3. When prompted, enter the path of the java executable. The default value is the path of the java executable that is executing.
  4. When prompted, enter the broker URL. The default value is tcp://localhost:2009.
  5. When prompted, enter the agent name. The default value is {{x}}, which means that a unique name is generated at runtime.
  6. Review the output.
  7. (Optional) To configure the agent automatically, enter Yes and follow the prompts.

For more information, see the following examples: