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:
  • 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.

  • 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 Open link (starting at 1:20) to tune the agent by increasing the JVM heap memory in WebLogic.

Where to go from here

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

Related topics

System requirements for App Visibility Manager

Known and corrected issues

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


  1. Mohamed Eraky

    How is the App visibility java agent work and collect the tracing details?

    Mar 08, 2018 02:45