Unsupported contentThis version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Upgrading a TEA Agent silently

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.

Before you begin

  • Verify that all requirements described in TEA-Agent-system-requirements are met.
  • Perform the relevant tasks listed in Preparing-for-installation.
  • (Recommended) Upgrade to Borland Silk Performer Synthetic for TrueSight Operations Management version 16.0, or install the execution module.

 

Encrypting the password for silent installations

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.

To encrypt a password for a silent installation in a GUI

  1. Log on to the host computer as a user with administrator privileges.
  2. In the folder with the TEA Agent installation files, go to the Disk1\utility folder, and run the TEAAgentMaintenanceTool.cmd file.
  3. On the Encrypt tab, enter your password in the Password and Confirm Password fields and click Encrypt.

  4. Copy and paste the value from the Encrypted Password field to the TEAAgent-silent-option.txt file for your silent installation.

    For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the archive_password property as follows:

    -J archive_password=DES\:d70cbe3669602717ce66af37cce7ecf0

  5. Save the TEAAgent-silent-option.txt file.

To encrypt a password for a silent installation from the command line

  1. Log on to the host computer as a user with administrator privileges.
  2. Open a command prompt and navigate to the Disk1\utility folder (with the TEA Agent installation files).
  3. Run the following command, entering your password for the value of the -password and -confirm_password options. If the password contains special characters, enclose the value in quotation marks (for example, "myp@$$word").
    TEAAgentMaintenanceTool.cmd -silent -encrypt -encrypt -password="<password>" -confirm_password="<password>"
  4. Copy and paste the output to the TEAAgent-silent-option.txt file for your silent installation and save the file.
  5. Run the command for each required password.

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 and tea_service_name match the existing values 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.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. 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. 

     

    Example

    Example of an automatically generated TEA Agent name:
    0be49679-f1da-4149-b9b7-ec8542a07f8b

  5. 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
  6. Save the TEAAgent-silent-option.txt file.

  7. 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.

    Example
    setup.exe -i silent -DOPTIONS_FILE="C:\temp\Disk1\utility\TEAAgent-silent-option.txt"

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.

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*