Preparing for installation of App Visibility agent for Java

Server installation

Install the App Visibility server components before installing the agent.

Java installation

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.

File download

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

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

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