To upgrade the BMC Synthetic Transaction Execution Adapter (TEA) Agent, you can use a silent (unattended) installation, as described in this topic, or the installation wizard.
The following topics describe how to set up and run a silent upgrade:
Note
The upgrade procedure uses the same wizard as the installation. When upgrading, you must make sure that the installLocation
and tea_service_name
match the existing values 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 and the unique agent name.
The Maintenance Tool enables you to encrypt a password. You must use encrypted passwords when you define properties for the silent installation so that the passwords are not exposed in the TEAAgent-silent-option.txt file.
You can run the Maintenance Tool in a GUI or from the command line.
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
and tea_service_name
match the existing values of your TEA Agent installations.
From the Disk1 directory, open the TEAAgent-silent-option.txt file, the options file provided with the product installer.
Make sure that installation directory path that you enter in installLocation
matches the value for your existing TEA Agent installation.
Enter a name for the tea_service_name
. Make sure that the value for tea_service_name
that you enter matches the existing value of your existing TEA Agent installation. If you don't know the name of your TEA Agent or if it was automatically generated, you can retrieve the value from the agent_configuration.xml file in the installation directory\TEAAgent\WorkingFolder\Conf directory.
Make sure that the auto_generated_tea_service_name
parameter is set to false
.
Enter or edit the values for the following properties. See descriptions below:
Ensure that all passwords are encrypted, as described above.
-J agent_group_name= -J archive_password= -J archive_confirm_password= -J portal_host_name= -J portal_port=8100 -J proxy_host_name= -J proxy_port= -J proxy_type=0
Installation parameter | Description |
---|---|
Agent Group Name | Agent Group name to which the Agent will be associated. |
Archive Password | 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. |
Archive Confirm Password | Enter the password again. |
Portal Host Name | Host name or IP address of the App Visibility Portal computer |
Portal Port | Port number for the App Visibility Portal The default port is 8100. |
Proxy Host Name | 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. |
Proxy Type | If you are connecting to the Portal using a proxy server, this sets the type of proxy server. Possible values are as follows:
|
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.txt"
The <filePath> is the full location of the options file.
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.To verify that the TEA Agent installation was successful
If the service is not running, check in the BMCTEAAgent_upgrade_log.txt file (located in the %temp% directory) for warnings or errors.Where to go from here