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:

Requirement

Description

Install the App Visibility server

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
    ad_java_agent_win_11.3.01.zip

  • Unix
    ad_java_agent_unix_11.3.01.tar.gz

    The Unix file contains files for the following versions:
    • Linux
      ad_java_agent_linux_11.3.01.tar.gz
    • AIX
      ad_java_agent_aix_11.3.01.tar.gz
    • Solaris
      ad_java_agent_solaris_11.3.01.tar.gz

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.

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.

Watch videos on YouTube

video_icon.png

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

 Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*