Page tree
Skip to end of metadata
Go to start of metadata

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 interactive installation mode, as described in this topic, or perform a silent installation .

This topic contains the following sections:

Before you begin

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

To install the App Visibility agent for Java

  1. Log on to the computer with the required privileges to run the installation scripts:

    • (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.
  2. Copy and extract the installation files to a temporary directory on the target computer.
  3. Open a command shell, run the adops-agent-install.sh (for Linux) or adops-agent-install.bat (for Windows) command, and then press Enter.

    (Linux) If you run the installation script as a root user, you must confirm to continue.

  4. As the script prompts you for configuration information, enter the required parameters, or press Enter to accept the default values.

    Parameter

    Description

    Enter installation destination directory.

    Enter the path for the installation directory. The directory is created if it does not already exist.

    Default: Directory from which the installation script is run

    Notes:

    • In Windows systems, do not install directly on the C directory.
    • In Linux systems, do not install directly on the root directory.

    Enter a display name for the application server computer.

    Enter a display name for the application server in the TrueSight console and integrated products. The name must be no longer than 255 characters and can include only alphanumeric Latin characters, spaces, underscore characters (_), and hyphens (-).

    Default: Blank (current server host name)

    Enter the App Visibility portal host name or IP address.

    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.

    Default: localhost

    Enter the App Visibility portal port number.

    Enter the listening port of the App Visibility portal. If a load balancing server manages access to the portal, enter the port number of the load balancer.

    Default: 8100

    If the App Visibility portal is behind a web proxy server, enter the server host name or IP address of proxy.

    (For web proxy server) If the App Visibility portal is behind a web proxy server, enter the server host name or IP address.

    If blank, this proxy is not used.

    Default: Blank (no proxy)

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

    Enter the web proxy server port.

    (For web proxy server)  Proxy server port for outbound connection

    Default: No default. If you use a web proxy, this property cannot be blank.

    If the App Visibility portal is behind a SOCKS proxy server, enter the server host name or IP address of proxy.

    (For SOCKS proxy server) If the App Visibility portal is behind a SOCKS proxy server, enter the server host name or IP address.

    If blank, this proxy is not used.

    Default: Blank (no proxy)

    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.

    Enter the SOCKS proxy server port.

    (For SOCKS proxy server) Proxy server port for outbound SOCKS connection

    Default: No default. If you use a SOCKS proxy, this property cannot be blank.

  5. Verify that the displayed parameters correctly reflect your installation.
    If you want to change a parameter, enter No and run the installation utility again.
  6. Enter Yes to continue and press the Enter key to start the installation.
  7. 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

      -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. 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 .NET

Changing settings of the App Visibility agent for Java