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:
- Your system meets all requirements for App Visibility Manager.
- You completed all tasks to prepare the environment for agent installation.
To install the agent for Java in silent mode
- 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. - Copy and extract the installation files to a temporary directory on the target computer.
- Open the silent options file javaagent-silent-options.txt in a text editor.
- Enter the destination directory where the agent for Java will be installed.
The default value is: - (Windows) C:\Program Files (x86)\BMC Software\App Visibility\Agent for Java
- (Linux, AIX, Solaris) /opt/bmc/App_Visibility/Agent_for_Java
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.
If your environment requires the agent to use a proxy when communicating with the portal and collector, enter connection details:
ProxyType=
HTTPProxyServerHost=
HTTPProxyServerPort=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
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.
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.jarLinux, AIX, Solaris
-javaagent:<installationDirectory>/ADOPsInstall/adops-agent.jar
- 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.
- 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.
- 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:
- Verify the installation of App Visibility agent for Java.
- Configure the App Visibility agents for Java after installation.
Access the TrueSight console.
Related topics
Installing-an-App-Visibility-agent-for-NETChanging settings of the App Visibility agent for Java