Preparing for installation of App Visibility agent for Java

• Set JAVA_HOME to the top level directory of the Java installed and used by the application server.
• Ensure that the JAVA_HOME environment variable is configured with a version that is later than Java 1.5.

The JVM platform enables you to run multiple monitoring agents, and the App Visibility agent for Java generally runs as expected with other agents. Yet other agents might significantly alter the runtime environment and such changes, over which BMC has no control, might cause unexpected results or malfunction in the App Visibility agent for Java with your web application.

Therefore, BMC strongly recommends that you disable or remove any non-BMC application performance monitoring agent from the application server where you install the App Visibility agent for Java.

• Windows
  • adops-agent-install.bat
  • agentInstaller.jar
• Linux
  • adops-agent-install.sh
  • agentInstaller.jar

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

• (Windows) Install with a user who belongs to the Administrator group.
• (Linux) Install the agent with the same user as the one that runs the application server.

Verify the memory requirements. The 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.