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.
• 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.

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.
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.
   The utility checks the environment for required software components and available space. 

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

   The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
   
   

   
   

7. On the App Visibility Portal Connection page, enter the following values and click Next:

   Notes

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

   
   

   The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
   The installation utility tests the connection with the App Visibility portal or the proxy server. If the connection fails, modify the details immediately.
   

   
   

   Note

   At this stage in the installation you may see the following message:

   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 Applying private certificates to Synthetic TEA Agents for more details.

    

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.

To verify that the TEA Agent installation was successful

1. 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.
2. Log on to the Presentation Server with Administrator access.
3. From the navigation menu, select Administration > App Visibility Agents.
4. 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.

Related topics

Performing-the-TEA-Agent-installation-silently

Known-and-corrected-issues

Uninstalling-the-TEA-Agent