Performing the TEA Agent installation

To install the BMC Synthetic Transaction Execution Adapter (TEA) Agent for monitoring of synthetic transactions, you can use an interactive installation wizard, as described in this topic, or a silent (unattended) installation.

When you install the TEA Agent, you configure settings for the Agent service and connections to the BMC TrueSight App Visibility portal.

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.
• Perform the relevant tasks listed in Preparing for installation.
• Perform the procedure in Preparing for installation of the TEA Agent.
• Complete or review the installation planning worksheet.

To install the Transaction Execution Adapter Agent

1. Log on to the host computer where you will install the TEA Agent as a user with administrator privileges and extract the downloaded files to a temporary directory.
2. Run the setup.exe file.
3. On the welcome page of the product installer, click Next.
4. Review the license agreement, select I agree to the terms of the license agreement, and click Next.
   The utility checks the environment for required software components and available space.

5. On the Directory Selection page, enter the path for the installation directory or click Browse to select a directory, and then click Next. 
   The default installation directory is C:\Program Files (x86)\BMC Software\BMCTEAAgent.

6. On the Agent Configuration page, enter the following values and click Next:

   Installation parameter	Description
   TEA Agent Name	Name of the service that runs the Transaction Execution Adapter Agent on the host computer, and the Agent Name in the BMC Application Management Console. The service name has a prefix, BMC TEA Agent, so the final name is BMC TEA Agent yourName. Your part of the service name (yourName) can be up to 40 characters. Note: TEA Agent names must be unique. If you install more than one agent, enter a unique name for each agent.
   Location	Location name to which the TEA Agent will be associated. If the Location name already exists in the system, the TEA Agent is associated with that location. If the Location name does not exist, a new Location is created.
   Results Archive Password	Define a 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.
   Confirm Password	Enter the password again.

   
   

7. (Optional) On the TrueSight App Visibility Portal and Proxy Configuration page, enter the following values and click Next:

   Note

   Proxy server details are required only if you are using a proxy server.

   
   

   Installation parameter	Description
   Portal Server	Host name or IP address of the computer with the server
   Portal Port	Port number for the App Visibility portal The default port is 8100.
   Proxy Server	Type of proxy server if applicable Default value is No Proxy. If you are connecting to the portal using a proxy server, select the type of proxy server from the list. Possible values are HTTP or SOCKS. When you select a value, additional fields for proxy server details are enabled.
   Proxy Host Name or IP Address	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.

   The installation utility tests the connection with the Portal or the proxy server. If the connection fails, modify the details immediately.

8. Review the details in the Installation Preview page and click Install.
   Installation begins. A progress bar indicates the percentage of the installation that has completed.

9. On the Installation Summary page, click View Log to examine the installation log, then click Done to exit the installation utility.

Related topics

Performing the TEA Agent installation silently

Known and corrected issues

Uninstalling the TEA Agent