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

Ensure that you have completed all tasks to prepare the environment for agent installation.

To install the App Visibility agent for Java

  1. Copy and extract the files to a temporary directory on the target computer.
  2. Open a command shell, run the adops-agent-install.sh (for Linux) or adops-agent-install.bat (for Windows) command, and then press Enter.

    The script prompts for configuration information. Some parameters have default values assigned.

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

    Default: localhost

    Enter the App Visibility portal port number.

    Enter the listening port of the App Visibility portal.

    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.

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

Verifying the installation of App Visibility agent for Java

Access the TrueSight console.

Related topics

Installing an App Visibility agent for .NET

Changing settings of the App Visibility agent for Java

 

 

Was this page helpful? Yes No Submitting... Thank you
© Copyright 2013-2015 BMC Software, Inc.
© Copyright 2013-2015 BladeLogic, Inc.
Legal notices