Page tree

This section provides information about migrating the BMC Synthetic Transaction Execution Adapter (TEA) Agent from version 2.6.XX to version 10.1.0

You can migrate using an interactive wizard, or run a silent (unattended) migration script.

The following sections are presented:

Before you begin

To migrate the synthetic TEA Agent

  1. Log on to the host computer as a user with administrator privileges and extract the downloaded files to a temporary directory.
  2. To start the migration utility, run setup.exe.
  3. On the welcome page, 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, select the installation directory of the current TEA Agent installation.


     Make sure to enter the correct path to the existing installation directory.

  6. On the Agent Configuration page, the Agent Group and Results Archive Password  are entered automatically from the current installation. You can change them if necessary.
  7. On the App Visibility Portal Connection page, enter the details for your TrueSight App Visibility Portal, and if you use a proxy server, enter the details here as well.

    Installation parameterDescription

    Portal Server

    Host name or IP address of the computer with the Portal

    Portal Port

    Port number for the Portal
    The default port is 443.
    Proxy ServerDefault value for this is No Proxy. If you are connecting to the Portal using a proxy server, select the type of proxy server you use 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 AddressHost name or IP address of the proxy server your agent uses to communicate.
    Proxy PortPort number of the proxy server your agent uses to communicate.

  8. Review the details in the Installation Preview page, confirming that the Installation Type is Configuration Change, and click Install.
    One of the following responses occurs:
    • Migration begins, using the parameters provided from the previous installation.
    • Migration cannot begin because the TEA Agent is running. Click Previous and wait for the TEA Agent to stop (or manually stop the TEA Agent) before proceeding.
  9. On the Installation Summary page, click View Log to examine the migration log, then click Done to exit the 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_upgrade_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.