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

    This section provides information about applying feature packs or fix packs to the Synthetic Transaction Execution Adapter (TEA) Agent from version 10.7.

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

    This topic contains the following sections:

    Before you begin

    Note

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

    To apply a feature pack or fix pack to 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. On the Directory Selection page, select the installation directory of the current TEA Agent installation.

      Note

       Make sure to enter the correct path to the existing installation directory.

    6. Review the Portal Details on the App Visibility Connection page. Modify the details if necessary, or click Next if no change is necessary.
      If a load balancing server manages access to the portal, enter the port number of the load balancer.

    7. Review the details in the Installation Preview page, confirming that the Installation Type is Configuration Change, and click Install.
      One of the following responses occurs:

      • Upgrade begins, using the parameters provided from the existing 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.

      Note

      At this stage in the upgrade you may see the following message:

      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 the upgrade is finished. See Changing security certificates in App Visibility components for more details.

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

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


    To define properties and silently apply a feature pack or fix pack to the synthetic TEA Agent

    Note

    Applying feature packs or fix packs uses the same wizard as the installation. When you apply feature packs or fix packs, you must ensure that the installLocation matches the existing value of your TEA Agent installation.

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

    If you want to apply the feature pack or fix pack to 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.

    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.

      Example

      setup.exe -i silent -DOPTIONS_FILE="C:\temp\TEA-Agent-Windows-10.7.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.

    Note

    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 Changing security certificates in App Visibility components for more details.

    To verify the TEA Agent after applying the feature pack or fix pack

    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 apply a feature pack or fix pack to the synthetic TEA Agent, complete the following:

    • 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 page 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).
    • Review and update, if necessary, the configuration information .