Performing the installation of an App Visibility agent for Java

Install the App Visibility agent for Java on the computer with the application server you want to monitor. After you install the agent, connect it to the application server instance. You can use the installation wizard, as described in this topic, or perform a silent installation .

This topic contains the following sections:

• • Before you begin
  • To install the App Visibility agent for Java
  • To configure Java options
  • Where to go from here
  • Related topics

Before you begin

Before you install the App Visibility agent for Java, ensure that your environment meets the following requirements:

• Your system meets all requirements for App Visibility Manager.
• You completed all tasks to prepare the environment for agent installation.

To install the App Visibility agent for Java

1. Log on to the computer with the user that runs the application server.
   On Windows computers, you must run the installation with a user that has administrator privileges.
2. Copy and extract the files to a temporary directory on the target computer.
3. Launch the installation wizard:
   • (Windows) Double-click setup.exe.
   • (Unix) Double-click setup.bin.
4. On the Welcome page, click Next.
5. On the License Agreement page, read the agreement, click I agree to the terms of the license agreement, and click Next.
   If you do not agree to the terms of the license agreement, you cannot proceed with the installation.
6. Enter, or browse to, the installation directory and click Next. 
   The default directory is:
   • (Windows) C:\Program Files (x86)\BMC Software\App Visibility\Agent for Java
   • (Linux, AIX, Solaris) /opt/bmc/App_Visibility/Agent_for_Java
7. On the Agent Details page, enter the Application Server Display Name, which is displayed in the TrueSight console, and click Next. The default name is the DNS host name.
8. On the Portal Connection Details page, provide values for the following parameters.
   1. Enter the Portal connection details:
      
      • Portal Server—Enter the IP address or host name on which the App Visibility portal is (or will be) installed.
        If a load balancing server manages access to the portal, enter the host name or IP address of the load balancer.
      • Portal Port—Enter the App Visibility portal port number.
        If a load balancing server manages access to the portal, enter the port number of the load balancer.

   2. If your environment requires the agent to use a proxy server when communicating with the portal and collector, enter Proxy Server Details:

      Note

      Proxy server details are required only if you are using a reverse proxy server or load balancing server. This server is not the same server as the App Visibility proxy, which is used to collect end-user browser data.

      • Proxy Server—Select one of the following:

        • No Proxy
        • HTTPS Proxy
        • SOCKS Proxy

        Default: No Proxy

      • Proxy Host  Name or IP Address—Enter the web proxy server host name or IP address.
        If the App Visibility portal is behind a proxy server, enter the server host name or IP address.
      • Proxy Port—Enter the web proxy server port number for outbound connection. If you use a proxy server, this property cannot be blank.
   3. Click Next. 
      The installation utility tests the connection.
      
      • If the system successfully connects to the App Visibilityportal, the Installation Preview page is displayed.
      • If the system fails to connect to the App Visibilityportalor the proxy server, a validation error is displayed. Do one of the following:
        • Click Previous to verify the connection details and test the connection again. 

        • Continue with the installation and change the connection details post-installation .

9. Review the settings displayed on the Installation Preview page and click Install.
10. On the Installation Summary page, you can view the log or click Done to end the installation process. 
11. Perform the following procedure, "To configure Java options," to configure Java options for the agent.

To configure Java options

After you install the agent, you need to add the agent to the Java command line. The javaagent option is required to connect the App Visibility agent to the JVM process. Enter the information that is relevant to your installation.

1. Add the following agent JVM options to the Java command line of your application server.

   Replace <installationDirectory> with the destination directory in which the App Visibility agent was installed.

   The procedure to update Java options is different for each application server type.

   • Windows

     -javaagent:<installationDirectory>\ADOPsInstall\adops-agent.jar
     

   • Linux, AIX, Solaris
     

     -javaagent:<installationDirectory>/ADOPsInstall/adops-agent.jar
     
2. If you have a single App Visibility agent installation directory that is used by multiple JVM processes, you can assign meaningful names to distinguish each instance. For information, see To distinguish multiple JVM processes using the same agent installation.
3. If your application server is using Java 2 security, set Java 2 security options for application servers that have Java 2 security enabled. For information, see Granting-Java-2-permissions-to-the-App-Visibility-agent.
4. Restart the application server or JVM process.

Where to go from here

After you install the App Visibility agent for Java, perform the following tasks:

1. Verify the installation of App Visibility agent for Java.
2. Configure the App Visibility agents for Java after installation.

3. Access the TrueSight console.

Related topics

Installing-an-App-Visibility-agent-for-NETChanging settings of the App Visibility agent for Java