Performing the Agent for Java installation

Deploy and configure the BMC Application Diagnostics Agent for Java on the computer before connecting it to the application server instance. You can use the interactive mode, as described in this topic, or the silent installation.

The installation utility checks the computer for existing versions of the Agent:

• If version 1.3 or earlier, you are instructed to uninstall the existing version before running the installation.
• If version 2.0 or later, you can upgrade to version 2.5.01.
  After upgrade, the Agent uses the same log files and configuration, and the already applied agent policy and recording configuration.
• If no version is detected, version 2.5.01 is installed.
• If version 2.5.01 is detected, you can uninstall the Agent.

To install the Agent, you must have administrative privileges for the application server that will be monitored.

Before you begin

Ensure that you have completed all tasks to prepare the environment for Agent installation.

To install the BMC Application Diagnostics Agent for Java

1. Copy and extract the files to a temporary directory on the target computer.

2. Open a command shell, run the adops-agent-install.sh (for Linux) or adops-agent-install.bat (for Windows) command, and then press Enter.

   The script prompts for configuration information. Some parameters have default values assigned.

   Success

   Tip

   Run the command adops-agent-install.sh -h (for Linux) or adops-agent-install.bat -h (for Windows) to see a description of all parameters.

3. Accept the defaults or enter the required parameters. If the field is blank and you want to keep the default value, leave the field blank.
4. The system displays the installation parameters. Verify that the displayed parameters reflect your installation correctly.
5. Enter Yes to continue and press the Enter key to start the installation.

6. After the installation is complete, you are prompted to add the BMC Application Diagnostics parameters to the JVM options of your application server. Enter the following parameters for JVM options according to each application server type:

   • Windows

     -javaagent:<installationDirectory>\ADOPsInstall\adops-agent.jar
     -Dcom.bmc.adops.agent.server.id="<uniqueID>"

   • Linux
     

     -javaagent:<installationDirectory>/ADOPsInstall/adops-agent.jar
     -Dcom.bmc.adops.agent.server.id="<uniqueID>"

     Replace the variables as follows:

     • Replace <installationDirectory> with the destination directory in which the BMC Application Diagnostics Agent was installed.
        The javaagent option is required to connect the BMC Application Diagnostics Agent to the JVM process. Enter the information that is relevant to your installation.
     • Replace <uniqueID> with a unique name to identify the application server instance.
        You can remove the -Dcom.bmc.adops.agent.server.id option if there is only one JVM process connected to an BMC Application Diagnostics Agent on the same computer.

   Warning

   Notes

   • The BMC Application Diagnostics Agent log file is named bmc_ad_agent_install.log and is created in the same folder as the installation script and the agentInstaller.jar file.
   • If you are using WebSphere, WebLogic, or GlassFish application servers and the server ID was not provided, it will be automatically generated by the BMC Application Diagnostics Agent according to application server instance properties.
   • If you are using Tomcat or JBoss application servers, you must either enter the unique instance ID for each application server, or install a dedicated BMC Application Diagnostics Agent for each Tomcat or JBoss instance that you install in parallel with another application server on the same computer. View the defaults used in the logs located in <agent_installation_directory>/instances/default/logs.
7. If your application server is using Java 2 security, set Java 2 security options for application servers that have Java 2 security enabled. See Granting-Java-2-permissions-to-the-Agent.
8. Restart the application server or JVM process.

Where to go from here

Verify that the installation of the BMC Application Diagnostics Agent for Java is successful.
Configure BMC Application Diagnostics Portal in BMC Application Performance Management Console, if you haven't already done so.
Log on to the BMC Application Performance Management Console.

Related topic

Installing-the-Agent-for-NET
Changing-settings-of-the-Agent-for-Java