Unsupported contentThis version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

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

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 agent for Java in silent mode using default values

  1. Copy and extract the files to a temporary directory on the target computer.
  2. Open a command shell, and from the directory with the agent installation files, run the following command:

    • Windows

      adops-agent-install.bat -s

    • Linux

      adops-agent-install.sh -s

      The -s parameter specifies to install in silent mode, using the following default values:

      • Installation directory: The directory from which the installation script is run
      • Portal port: 8100
      • Portal host: localhost
  3. Configure the Java options according to the application server type.

To install the agent for Java in silent mode using customized configuration settings

You can customize the silent installation to suit your deployment by running the install command with specified parameter values.

  1. From the directory with the agent installation files, run the following command, and enter the values for the relevant parameters (see Installation command optionsfor parameter information):

    Tip

    Run the relevant command to display all parameters:

    • (Windows) adops-agent-install.bat -h
    • (Linux) adops-agent-install.sh -h

     

    • Windows

      adops-agent-install.bat -s -d <destination_path> -n <host_display_name> -ph <portal_IP_Address> -t <portal_port> -phttpsh <proxy_https_host> -phttpsp <proxy_https_port> -psocksh <proxy_socks_host> -psocksp <proxy_socks_port>

    • Linux

      adops-agent-install.sh -s -d <destination_path> -n <host_display_name> -ph <portal_IP_Address> -t <portal_port> -phttpsh <proxy_https_host> -phttpsp <proxy_https_port> -psocksh <proxy_socks_host> -psocksp <proxy_socks_port> 


  2. To verify the installation, view the parameters selected during installation in the bmc_ad_agent_install.log file, which is usually located in the same folder as the installation script and the agentInstaller.jar.
  3. Configure the Java options according to the application server type.

Installation command options

To run the silent installation, you must enter the -s (or -silent) option. The remaining options use the default values. The following table describes the options that you can customize and their default values.

Examples of customized configuration settings

  • A customized silent installation on Windows. The agent is installed in c:\BMC\AD\Agent, and connects to the portal on goodhost.abcd.com

    adops-agent-install.bat -s -d c:\BMC\AD\Agent -host FrontEndMachine -portalHost goodhost.abcd.com

  • A customized silent installation on Linux. The agent is installed in /usr/BMC/AD/agent, and connects to the portal on goodhost.abcd.com

    adops-agent-install.sh -s -d /usr/BMC/AD/agent -host BackEndRHMachine -portalHost goodhost.abcd.com

  • A customized silent installation on Windows, using a proxy, with customized configuration of the proxy web host and port

    adops-agent-install.bat -s -phttpsh 10.64.180.2 -phttpsp 443

  • A customized silent installation on Linux, using a proxy, with customized configuration of the proxy SOCKS host and port

    adops-agent-install.sh -s -psocksh 10.64.180.2 -psocksp 3128

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 Operations Management Console.

Related topics

Installing-an-App-Visibility-agent-for-NET

Changing-settings-of-the-App-Visibility-agent-for-Java

 

 

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