Important This documentation space contains information about PATROL Agents when deployed in a TrueSight Operations Management environment. If you are a BMC Helix Operations Management user, see PATROL Agent 21.02 for BMC Helix Operations Management.

Installing in a TrueSight Operations Management environment

The following section helps you to install PATROL Agent. 

About the setup.exe utility

Earlier, you could use the setup.exe utility to install the PATROL Agent. From 20.02, the setup.exe utility has been discontinued. You can continue to deploy the PATROL Agent by creating a deployable package, and downloading and deploying it as explained in the following section.

Step 1: To import the PATROL Agent

Do the following to import PATROL Agent 20.02 as a single solution from the TrueSight console:

The 20.02 base repository includes the PATROL Agent and PATROL Installation Utility version 20.02. If you download and import the base repository, you do not need to import them as single solutions.

  1. Download the PATROL Agent version 20.02 and the PATROL Installation Utility version 20.02 from the EPD. 

  2. Log in to the TrueSight console. 
  3. Go to Administration > Repository, and select the Installation Components tab.
  4. Click import_icon.pngImport.
  5. In the Import a Repository or Solution dialog box, select Single Solution.
  6. Click Browse to browse and select the downloaded files (PATROL Agent and PATROL Installation Utility) from your local computer's file system.
    The selected files are displayed in the File Selected: box.
  7. Click Import. The selected archive file is imported to the repository and extracted. You can close the window during the import process.

Step 2: To create a deployable package

  1. Log in to the TrueSight console. 
  2. Go to the Administration > Repository > Deployable Packages tab.
  3. ClickCreatePackage.PNGCreate Deployable Package.
    The Create Deployable Package wizard is displayed.
  4. On the Installation Package Solution Selection page, select the operating system for which you want to create a package, and then select a platform on which you want to install the package.
    The list of components in the repository that are supported on the specified operating system and platform is displayed.

  5. Select one of the following PATROL Agent components:

    • PATROL Agent for Windows
    • PATROL Agent for Unix

    If you want to install any monitoring solutions along with the PATROL Agent, select the required monitoring solutions.

  6. From the Version list, select the version of the component that you want to include in the package.
    You can select a specific version or you can select latest, which automatically updates the package with the latest versions of the components when new versions of those components are added to the Infrastructure Management repository.
    create_deploypkg.png

  7. Provide PATROL Agent related information:

    The following fields depend upon the components that are included in the deployable package. Not all fields may be displayed while creating a deployable package.  


    1. Specify the installation directory.
      Perform one of the following actions:
      • Proceed with the default installation directory.
      • Enter a different directory location for installation.
      • Leave the field blank and proceed with the installation.
        When you leave the field blank, the correct directory is automatically selected through the BMC_BASE variable.

    2. Specify the PATROL 3.x product directory, and click Next.

      Follow the instructions in the Important Information section of the wizard.

    3. For UNIX operating system, provide the System Root account details.
      Note: You can continue the package process without the Root details but you will need to complete the root configuration at a later time for the selected component to run correctly.

    4. Provide the PATROL default account credentials.
      You must create this account manually before continuing with the installation. If you plan to use a domain account, type the following otherwise type the local account details:

      1. (Windows) DOMAIN_NAME\account name
      2. (Linux) DOMAIN_NAME\\account name
        Double slash before the account name ensures that the account name is parsed correctly. While editing the package, if the double slash is deleted, type it again.

      To allow the PATROL Agent to use the Local System account as the default account, leave the username and password fields blank.

    5. Select one of the following security options:
      • Advanced security options
      • Basic security (default)
    6. Confirm if you want to override the current security configuration (keys, certificates, and trusted roots).
    7. If you have selected the Advanced security options, select one of the following security levels:
      • Level 1 Uses Diffie-Hellman protocol, integrity validation and audit logging. No authentication of console or agent.
      • Level 2 Uses SSL protocol. No authentication of console or agent.
      • Level 3 Uses SSL protocol. Provides agent-side authentication.
      • Level 4 Highest level of security. Uses SSL protocol. Provides console-side and agent-side authentication.
    8. Enter the PATROL Agent port number.
    9. Choose to restart the PATROL agent automatically or manually, and click Next.
    10. Specify the streaming endpoint details. This will be used for automatic registration of the PATROL Agent with TrueSight Operations Management. Enter the details in the following format: 
      http:<IP address or FQDN of the load balancer>:<port_no>
    11. Enter a comma-separated list of tags for associating PATROL Agents to monitoring policies.
      PATROL Agents use the specified tags to get configuration details from TrueSight Operations Management. 
    12. Choose if you want to manage the PATROL Agent configuration via monitoring policy, and click Next.

    13. (Optional) Provide the cell configuration details.
      Enter the Infrastructure Management encryption key and the cell details in the format Host/Port.

      You can choose to route events via an Integration Service.

      To route events via an Integration Service, the /EventSetup/Configuration/ForwardEventsToIS PATROL Agent pconfig variable must be set to Yes. 

      During the upgrade of earlier versions of the BMC PATROL Agent, ensure to provide the correct Cell name in the Infrastructure Management - Primary Cell and Infrastructure Management - Secondary Cell fields in the Infrastructure Management Performance Management Cell Configurations installation screen.

      Proceeding with the default value resets the Event Destination of the BMC PATROL Agent to localhost/1828.

      If /EventSetup/Configuration/ForwardEventsToIS is set to Yes and Infrastructure Management - Primary Cell is set to localhost/1828, then the PATROL Agent sends events to the local Cell of the Integration Service.

    14. Configure the firewall.
      You can choose to automatically add the components to the firewall exception list.

  8. Review the deployable package details.

    If you added a monitoring solution that contains sub-components, click the plus sign to view the included sub-components.

  9. In the Installation Package Details window, enter the following information:
    • Name: The name of the deployable package. Can contain only A-Z, a-z, 0-9, and underscore (_).
    • (Optional)Description: Enter a description of the package.
      The description is displayed in the list of deployable packages.
    • Format: Select a file compression format for the installation package.
  10. Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.
  11. While creating the package, if you select Save and Download, the package is created and downloaded to your computer. Copy the downloaded package to a host computer where you intend to install the PATROL Agent. Extract the package, and run the RunSilentInstall file to install the PATROL Agent.
  12. Select one of the following:
    • Save: Save the package for future installation on the current host or other hosts.
      Go to Administration > Repository > Deployable Packages tab. The saved packages are listed here.
    • Save and Download: Save and download the package and note the downloaded package location. You will need the downloaded package location details while deploying the package.

Step 3: Deploying the package

  1. Log in to the host computer on which you plan to install the PATROL Agent.
  2. Copy the package that you downloaded in Step 2 to a temporary directory location.
  3. Extract the package. It is extracted to the <PA_EXTRACTED_PACKAGE>\bmc_products directory.

  4. From the bmc_products directory, run the runSilentInstall.exe command. 

    Note

    You must have created and logged in with the PATROL default account before you run the silent installer runSilentInstall.exe.

  5. Review the log file to check the installation status. 

 

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