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

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

  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 installation files to a temporary directory on the target computer.
  3. Open the silent options file javaagent-silent-options.txt in a text editor. 
  4. Enter the destination directory where the agent for Java will be installed.
    The default value is:

    • (WindowsC:\Program Files (x86)\BMC Software\App Visibility\Agent for Java
    • (Linux, AIX, Solaris) /opt/bmc/App_Visibility/Agent_for_Java
  5. Enter or modify the values for the following agent configuration parameters:

    -J ApplicationServerDisplayName=
    -J PortalServer=
    -J PortalPort=

    The agent configuration parameters are described in the following table: 

    Agent configuration parameters

    Parameter

    Description

    ApplicationServerDisplayName

    Host name, which is displayed in the TrueSight console as the application server’s display name. The default name used is the DNS host name.

    PortalServer

    Host name or IP address of the computer on which the App Visibility portal is installed

    If a load balancing server manages access to the portal, enter the host name or IP address of the load balancer.

    PortalPort

    Portal HTTPS port

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

  6. If your environment requires the agent to use a proxy when communicating with the portal and collector, enter connection details:

    ProxyType=
    HTTPProxyServerHost=
    HTTPProxyServerPort=

    Note

     Proxy server details are required only if you are using a web 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.

     

    Description of proxy server values

    Parameter

    Description

    ProxyType

    Type of proxy server host for outbound connection

    • 0-No proxy
    • 1-HTTPS proxy
    • 2-SOCKS proxy

    HTTPProxyServerHost

    Web proxy server host for outbound connections. The default is blank, which means that no web proxy is used.

    HTTPProxyServerPort

    Web proxy server port for outbound connections

  7. In a command line, run the following command:

    (Windows)

    setup.exe -i silent -DOPTIONS_FILE="<Full-File-Path>\<Silent Options Filename>"

     

    For example:

    setup.exe -i silent -DOPTIONS_FILE="C:\JavaAgentInstaller\Disk1\javaagent-silent-options.txt"

    (Linux, AIX, Solaris)

    ./setup.bin -i silent -DOPTIONS_FILE="<Full-File-Path>/<Silent Options Filename>"

    For example:

    ./setup.bin -i silent -DOPTIONS_FILE="/home/Admin/JavaagentInstaller/Disk1/javaagent-silent-options.txt"

     

    Make sure to specify the full path and filename for the silent options file.

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

 

 

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