Upgrading a synthetic TEA Agent

This section provides information about upgrading the BMC Synthetic Transaction Execution Adapter (TEA) Agent from version 2.5.01 to version 2.6.10

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

The following sections are presented:

Before you begin

• Verify that all requirements described in System requirements for synthetic monitoring are met.
• Perform the tasks listed in Preparing for installation of TEA Agent for synthetic monitoring.
• Update BMC Real End User components to version 2.6.
• Download installation files for the TEA Agent.
• (Recommended) Upgrade to Borland Silk Performer Synthetic Transaction Monitoring for BMC Software version 15.5, or install the execution module.
• Implement the Synthetic Device Configuration Pack.

To upgrade 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 upgrade 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. Review the details in the Installation Preview page, confirming that the Installation Type is Upgrade, and click Install.
   One of the following responses occurs:
   
   • Upgrade begins, using the parameters provided from the previous installation.
   • Upgrade 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.

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

To upgrade the synthetic TEA Agent silently

1. Log on to the host computer as a user with administrator privileges.

2. From a command prompt, run the silent upgrade from the TEA Agent installation directory using the following command:

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

   For example: setup.exe -i silent -DOPTIONS_FILE="C:\Disk1\TEAAgent-silent-option-upgrade.txt"

One of the following responses occurs:

• You receive a message that upgrade completed successfully.  The parameters are provided from the previous installation.
• Upgrade cannot begin because the TEA Agent is running. Wait for the TEA Agent to stop (or manually stop the TEA Agent) before you run the command again.

You can verify that the BMC Synthetic Transaction Execution Adapter (TEA) Agent upgrade was successful by reviewing the log files created during the upgrade process, and examining server processes and services.

To verify that the TEA Agent upgrade 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 BMC Application Management Console with Administrator-level access, or higher.
3. Click the Synthetic tab, and on the navigation menu, click TEA Agents.
   Ensure that your upgraded Agent is listed in the table and that the Agent status is Active.

Where to go from here

Ensure that the configuration for synthetic monitoring is up to date for the current version.

Related topic

Uninstalling the TEA Agent