• Spaces
  • Collections
  • Help
    • ×
     
     
    •  
    BMC TrueSight Operations Management 10.1

    Page tree

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

    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

     

     

    © Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.