Upgrading a synthetic TEA Agent silently

To upgrade the synthetic Transaction Execution Adapter (TEA) Agent, you can use a silent (unattended) installation, as described in this topic, or the installation wizard.


 This topic describes how to upgrade from version 10.5 and later.

The following procedures describe how to set up and run a silent upgrade:


The upgrade procedure uses the same wizard as the installation. When upgrading, you must make sure that the installLocation matches the existing value of your TEA Agent installation.

You can run the installation wizard to upgrade more than one TEA Agent on a single computer. For each agent you must supply the specific agent installation directory.

Before you begin


 Multiple versions of TEA Agents are not supported on the same computer. Make sure to upgrade all of them to the latest version.

Defining properties and running the silent installation

If you want to upgrade more than one TEA Agent on the same computer, you must run the installation more than once. For each run, make sure that the installLocation matches the existing value of your TEA Agent installations.

To define properties and run the silent upgrade

  1. Log on to the host computer as a user with administrator privileges.
  2. From the Disk1 directory, open the TEAAgent-silent-option-upgrade.txt file, the options file provided with the product installer.

  3. Make sure that installation directory path that you enter in installLocation  matches the value for your existing TEA Agent installation.

  4. Save the TEAAgent-silent-option-upgrade.txt file.

  5. From the directory where the installer file is stored, open a command prompt and run the silent upgrade using the following command:

    setup.exe -i silent -DOPTIONS_FILE="<filePath>\TEAAgent-silent-option-upgrade.txt"

    The <filePath> is the full location of the options file.


    setup.exe -i silent -DOPTIONS_FILE="C:\temp\TEA-Agent-Windows-11.0.00\Disk1\TEAAgent-silent-option-upgrade.txt"
  6. If your TEA Agent is installed on a Windows Server operating system, you need to restart the computer. See  After upgrading Silk Performer and installing or upgrading the TEA Agent, the TEA Agent doesn't run  for more details.


You may see the following message in the upgrade 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 upgrade is finished. See Implementing private certificates for App Visibility components and Synthetic TEA Agents for more details.


If you are upgrading to a high-availability environment you need to re-register your TEA Agents with the TrueSight Presentation Server. Go to the Administration > App Visibility Agents screen in your Presentation Server and delete the TEA Agents. The TEA Agents will automatically re-register with the Presentation Server on the next heartbeat (which occurs every 30 seconds).

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 .

Was this page helpful? Yes No Submitting... Thank you