Performing the TEA Agent installation silently

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.

Before you begin

Identify the exact host computers where you want to install TEA Agents. TEA Agents are grouped into Locations, which are logical groups (such as by geographical location or application type), that are used for load balancing and high availability.
Verify that all requirements described in TEA Agent system requirements are met.
Download the necessary installation files according to the instructions in Downloading the installation files.
Perform the relevant tasks listed in Preparing to install the TrueSight Operations Management solution.
Perform the procedure in Preparing for installation of the TEA Agent.
Complete or review the installation planning worksheet.

Encrypting the password for silent installations

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.

To encrypt a password for a silent installation in a GUI

Log on to the host computer as a user with administrator privileges.
In the folder with the TEA Agent installation files, go to the Disk1\utility folder, and run the TEAAgentMaintenanceTool.cmd file.
On the Encrypt tab, enter your password in the Password and Confirm Password fields and click Encrypt.
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
```
Save the TEAAgent-silent-option.txt file.

Defining properties and running the silent installation

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.

To define properties and run the silent installation

Log on to the host computer as a user with administrator privileges.
From the Disk1 directory, open the TEAAgent-silent-option.txt file, which is the options file provided with the product installer.
Accept the installation directory path, or edit the -P installLocation parameter.
The default path is C:\Program Files (x86)\BMC Software\BMCTEAAgent.
Perform one of the following:
- If you are installing a single TEA Agent, enter a name for the tea_service_name .
- If you are using an installation deployment tool to deploy multiple TEA Agents, ignore the 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.
Example
Example of an automatically generated TEA Agent name:
0be49679-f1da-4149-b9b7-ec8542a07f8b

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. If the Agent Group name already exists in the system, the Agent is associated with that group. If the Agent Group name does not exist, a new group is created.
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: 0 - No proxy (default value) 1 - HTTP proxy 2 - SOCKS proxy

Save the TEAAgent-silent-option.txt file.
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.
Example
setup.exe -i silent -DOPTIONS_FILE="C:\temp\Disk1\utility\TEAAgent-silent-option.txt"

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.

To verify that the TEA Agent installation was successful

Using Windows Administration Tools to view local services, ensure that the service for the BMC TEA Agent is running.
If the service is not running, check in the bmcteaagent_install_log.txt file (located in the %temp% directory) for warnings or errors.
Log on to the Presentation Server with Administrator access.
From the navigation menu, select Administration > App Visibility Agents.
Ensure that your installed Agent is listed in the table and that the Agent status is Online.

Where to go from here

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 .

Content

Space Tools