Page tree
Skip to end of metadata
Go to start of metadata

You can modify the BMC Synthetic Transaction Execution Adapter (TEA) Agent configuration settings that were defined during installation, such as changing passwords or the associated Agent Group. You cannot change the installation directory or the TEA Agent name.


If you change the results archive password, the new password only applies to results archives generated after the change.

The following sections in this topic describe how to modify your TEA Agent properties:

To modify the TEA Agent with the installation wizard

  1. Log on to the TEA Agent computer as a user with administrator privileges and run the setup.exe file.
  2. On the welcome page of the product installer, click Next.
  3. Change the values according to your needs. For a description of the parameters, see Performing the TEA Agent installation.

  4. Review the details in the Installation Preview page and click Install.
    Update begins. A progress bar indicates the percentage of the update that has completed.
  5. On the Installation Summary page, click View Log to examine the installation log, then click Done to exit the installation utility.

To modify the TEA Agent silently

Follow the instructions for Performing the TEA Agent installation silently.

(Version 2.6.10) Ensure that you use the installLocation and tea_service_name parameter values for the agent that you want to modify. If you enter new values for the parameters, the installation process runs to install another TEA Agent.


(Version 2.6.00) Do not change the installLocation and tea_service_name parameters. Changing the parameters causes the installation process to run, instead of the update process. The system cannot recognize multiple TEA Agents on the same computer and the Agents will not perform as expected.

To specify a public IP address for the TEA Agent

You might want to specify the public IP address that is displayed for the TEA Agent computer, such as for the following reasons:

  • The IP address is private. Private IP addresses cannot be seen in some elements of the BMC Application Management Console, such as dashlets.
  • The IP address displays a different location than the one you want to be displayed.
  • The TEA Agent is installed on a computer with more than one network card.

Use the following procedure to specify the IP address:

  1. Log on to the TEA Agent computer as a user with administrator privileges.
  2. In a text editor, open the agent_configuration.xml file, located in the installationDirectory\WorkingFolder\Conf directory.
    The default installation directory is C:\Program Files (x86)\BMC Software\BMCTEAAgent. 
  3. Locate the <AgentUserDefinedIp> element.

    By default, the value of the element is null.

  4. Enter the IP address that you want to display.
    For example, <AgentUserDefinedIp><AgentUserDefinedIp>
  5. Save the file and restart the TEA Agent service.

Related topic

Uninstalling the TEA Agent