To install the BMC Synthetic Transaction Execution Adapter (TEA) Agent for monitoring of synthetic transactions, you can use a silent (unattended) installation, as described in this topic, or an installation wizard.
The following topics describe how to set up and run a silent installation:
You can run the installation utility more than once to install more than one TEA Agent on a single computer. Each agent must have a unique name and a separate installation directory.
The Maintenance Tool enables you to encrypt a password. You must use encrypted passwords when you define properties for the silent installation so that the passwords are not exposed in the TEAAgent-silent-option.txt file.
Copy and paste the value from the Encrypted Password field to the TEAAgent-silent-option.txt file for your silent installation.
For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the archive_password
property as follows:
-J archive_password=DES\:d70cbe3669602717ce66af37cce7ecf0
If you want to install more than one TEA Agent on the same computer, you must run the installation more than once. Each run must have a unique tea_service_name
and a separate installLocation
directory.
-P installLocation
parameter. Perform one of the following:
tea_service_name
.tea_service_name
parameter and set the auto_generated_tea_service_name
parameter to true
to generate a unique name for each agent automatically.Each TEA Agent name must be unique in the synthetic transaction monitoring system.
Enter or edit the values for the following properties.
For a description of the properties, see Performing the TEA Agent installation.
Ensure that all passwords are encrypted, as described above.
-J agent_group_name= -J archive_password= -J archive_confirm_password= -J portal_host_name= -J portal_port=8100 -J proxy_host_name= -J proxy_port= -J proxy_type=0
Installation parameter | Description | |
---|---|---|
Agent Group Name | Agent Group name to which the Agent will be associated. | |
Archive Password | Password to extract data from archived files in the execution logs. When a TEA Agent executes an Execution Plan, a local results file and related files are archived in a secure zip file that is protected with this password. The password uses Triple-DES encryption in ECB mode (DES_ecb3_encrypt). Note: You can set a different results archive password for each TEA Agent, or use the same password. | |
Archive Confirm Password | Enter the password again. | |
Portal Host Name (FQDN) | Fully qualified domain name of the App Visibility portal computer | Note If access to the App Visibility portal is through a load balancing server, such as in a high-availability environment, enter the connection information for the load balancer. |
Portal Port | Port number for the App Visibility portal The default port is 8100. | |
Proxy Host Name | Host name or IP address of the proxy server your agent uses to communicate. | |
Proxy Port | Port number of the proxy server your agent uses to communicate. | |
Proxy Type | Proxy server type for connecting to the portal, if applicable. Possible values:
|
From the directory where the installer file is stored, open a command prompt and run the silent installation using the following command:
setup.exe -i silent -DOPTIONS_FILE="<filePath>\TEAAgent-silent-option.txt"
The <filePath> is the full location of the options file.
Note
You may see the following message in the installation log file:
Test connection could not establish a secure connection with App Visibility. If you are using a custom certificate, after you install, use the certificate replacement tool to replace the agent certificate.
If you see this message, you need to replace your TEA Agent security certificate after installation is finished. See
Changing security certificates in App Visibility components
for more details.
After you install the BMC Transaction Execution Adapter Agent, the service automatically starts and the Agent is automatically registered by the Presentation Server. The Agent is ready to receive
configuration information
.