Page tree

This topic provides information about preparing your environment to install the BMC Application Diagnostics Agent for Java.

Before installing the Agent, ensure that your environment satisfies the following requirements:

RequirementDescription
Server installationInstall the BMC Application Diagnostics Server before installing the BMC Application Diagnostics Agent for Java.
Java installationOn the computer where you are installing the BMC Application Diagnostics Agent for Java, you must have Java already installed. The Agent installation script requires the following settings:
  • Set JAVA_HOME to the top level directory of your Java installed and used by the Application Server.
  • Ensure that the JAVA_HOME environment variable is configured with Java 1.5 or above.
File downloadDownload the following Agent installation files from the Electronic Product Distribution site:
  • (Windows)
    • adops-agent-install.bat
    • agentInstaller.jar
  • (Linux)
    • adops-agent-install.sh
    • agentInstaller.jar
Access and permissions

Ensure that you have execute privileges on the installation and upgrade scripts, and write access to the upgrade location.

  • (Windows) You must be a user who belongs to the Administrator group.
  • (Linux) You need root privileges. You can log on as one of the following users:
    • root user
    • User defined in sudo file with root privilege
Increase JVM heap memory
(If the Agent is running in the same JVM memory space as the monitored application)

The BMC Application Diagnostics Agent for Java requires up to 256 MB of JVM heap memory. If the Agent is running in the same JVM memory space as the monitored application, BMC recommends adding 256 MB to the Max heapsize Java options flag -Xmx.

Example

set JAVA_OPTS=%JAVA_OPTS% -Xmx1024m

For full details about both the -javaagent and Xmx options, refer to the Java options for each application server type.

Where to go from here

Select an installation method for the Diagnostics Agent for Java:

Related topic

System requirements for BMC Application Diagnostics