This topic provides information about preparing your environment to install the App Visibility agent for Java.

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

RequirementDescription
Install the App Visibility serverInstall the App Visibility server components before installing the agent.
Install Java
On the computer where you are installing the 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 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.
Disable or remove other agents

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.

Download files
Download 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
Set access and permissions

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 JVM heap memory
(If the Agent is running in the same JVM memory space as the monitored application)

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.

Where to go from here

Select an installation method for the App Visibility agent for Java:

Related topic

App Visibility system requirements

 

 

Was this page helpful? Yes No Submitting... Thank you
© Copyright 2013-2015 BMC Software, Inc.
© Copyright 2013-2015 BladeLogic, Inc.
Legal notices