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

To install the BMC Synthetic Transaction Execution Adapter (TEA) Agent for monitoring of synthetic transactions, you can use a silent (unattended) installation, as described in this topic, or an installation wizard.

The following topics describe how to set up and run a silent installation:

(Version 2.6.10) You can run the installation utility more than once to install more than one TEA Agent on a single computer. Each agent must have a unique name and a separate installation directory.

Warning

(Version 2.6.00) Do not install the TEA Agent in more than one folder on the same computer. The system cannot recognize multiple TEA Agents on the same computer and the agents will not perform as expected.You can update the TEA Agent configuration or you can uninstall the Agent.

Before you begin

Encrypting the password for silent installations

The Maintenance Tool enables you to encrypted 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 apm_console_password property as follows:

    -J apm_console_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

(Version 2.6.10) If you want to install more than one TEA Agent on the same computer, you must run the installation more than once. Each run must have a unique tea_service_name and a separate installLocation directory.

To define properties and run the silent installation

  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. Accept the installation directory path, or edit the installLocation parameter. The default path is C:\Program Files (x86)\BMC Software\BMCTEAAgent.
  4. If you are installing a single TEA Agent, enter a name for the tea_service_name.
    If you use an installation deployment tool to deploy the synthetic TEA Agents over several computers, each TEA Agent name must be unique in the synthetic transaction monitoring system. Ignore the tea_service_name parameter and set the auto_generated_tea_service_name parameter to true to automatically generate a unique name for each agent.

    Example

    Example of an automatically generated TEA Agent name:
    0be49679-f1da-4149-b9b7-ec8542a07f8b
  5. Enter or edit the values for the following properties. For a description of the properties, see Performing the TEA Agent installation.

    Ensure that all passwords are encrypted, as described above.

    -J agent_group_name=
    -J archive_password=
    -J archive_confirm_password=
    -J apm_console_host_name=
    -J apm_console_port=443
    -J apm_console_user_name=
    -J apm_console_password=
  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 installation 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"

Where to go from here

Verify the TEA Agent installation

After you install the BMC Transaction Execution Adapter Agent, the service automatically starts and the Agent is automatically registered by the BMC Application Management Console. The Agent is ready to receive configuration information.

Related topics

Performing the TEA Agent installation silently

Modifying the TEA Agent configuration

Known and corrected issues

Uninstalling the TEA Agent