Preparing for installation of App Visibility agent for Java

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:

Install the App Visibility server
Install the App Visibility server components before installing the agent.
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 anynon-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:

Note: BMC Software recommends that you install the products or components from a local copy of the installation image and not from a network drive. Installing from a network drive can cause delays in completing the installation.

  • Windows

  • Unix

    The Unix file contains files for the following versions:
    • Linux
    • AIX
    • Solaris
Set access and permissions

Ensure that you have the required privileges to run the installation.

Note: The Linux installation files and directories have executable permissions. You can modify the permissions after you complete the installation successfully.

  • On Unix platforms, to ensure proper functioning of the agent, install the agent with the user that runs the application server.
  • On Windows platforms, you must run the installation as administrator. Only the user that installed the agent will be able to uninstall or upgrade it.
    There are no restrictions on which user can run the application server with the agent.
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.


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.

Watch videos on YouTube

Watch Installing App Visibility Part 5 | Agent for Java Startup and Tuning (starting at 1:20) to tune the agent by increasing the JVM heap memory in WebLogic.

Where to go from here

 If you are installing the product, perform the other preinstallation tasks listed in the Preparing to install the TrueSight Operations Management solution page. 

Was this page helpful? Yes No Submitting... Thank you