How to install the Patrol Agent in Windows/Linux

Patrol Agent install files are part of a Repository, you will need to download and import the repository following the below documentation:

• https://docs.bmc.com/docs/display/TSIM113/Importing+the+Infrastructure+Management+repository#ImportingtheInfrastructureManagementrepository-Todownloadtherepositoryfiles

How to configure the repository in TrueSight console
Installation Steps:

1. Download the base and extended repository files from the BMC Electronic Product Distribution (EPD) facility.
2. Log on to the TrueSight console. In the navigation pane, expand Administration, select Repository, and select the Installation Components tab.
3. Click Import.
4. In the Import a Repository or Solution dialog box, select Full repository and click Continue.
5. Browse and select the base repository file from the file system, and click Import.
6. Repeat step 5 using the extended repository file

Once the repository is installed you will need to create a deployable package for each type of server and deploy each package on the desired servers, find below the documentation required for this:

• https://docs.bmc.com/docs/display/TSIM113/Creating+deployable+packages
• https://docs.bmc.com/docs/display/TSIM113/Downloading+and+installing+saved+packages+manually

Creating Deployable Packages

1. Log on to the TrueSight console. In the navigation pane, expand Administration, select Repository, and select the Deployable Packages tab.

2. ClickCreate Deployable Package.
   The Create Deployable Package wizard starts.

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

4. Select the components that you want to include in the package (i.e. PATROL Agent For Unix or PATROL Agent For Windows)

5. From the Version list, select the version of the component that you want to include in the package.
   By default, the latest version available in the Presentation Server is selected. Select latest to automatically update the package with latest versions of components when they are imported to the Presentation Server.

6. For monitoring solutions that contain sub-components, select the sub-components to be included in the deployable package.
   

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 installation in the default directory.
      • Enter a different directory for installation.
      • Leave the field blank and proceed with the installation.
        You can leave the field blank if you do not know the location where the KM or PATROL Agent is installed. 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.

   3. Follow the instructions in the Important Information section of the wizard.
   4. 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.
   5. 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.

   6. Select the security level.
      The default security level is appropriate for most environments.
   7. Specify the PATROL Agent port number.
      The port number is used by the PATROL Agent to communicate with the console. If you are installing a new version of the PATROL Agent over an existing one, ensure that you specify the same port number used by the earlier Agent.
   8. Provide the Infrastructure Management integration configuration:
      1. INTEGRATIONSERVICES variable: this variable is used for automatic registration of the PATROL Agent with Infrastructure Management.

         Enter one or more existing Integration Service(s) to connect to. Separate each entry by a comma and use the format Protocol:IntegrationServiceHostname:PortNumber. For example tcp:IntegrationServiceHostname:3183, where 3183 is the port on which the Integration Service host listens for an incoming PATROL Agent auto-registration connection.

      2. Central Monitoring Administration Tag(s):

         Provide comma separated tags that the PATROL Agent will use to get configuration from Central Monitoring Administration. Each tag follows the format TagName:Description. If there is a space in the description, enclose it with quotes. For example, WinOS:"Windows OS Monitoring".

      3. By default, Central Monitoring Administration manages the PATROL Agent(s) configuration. If you select No, you can enable policy management from Central Monitoring Administration later. 

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

   10. (Optional) Provide the RTSERVERS variable details.
       BMC PATROL 7 products communicate with each other through one or more RTservers. For previously installed PATROL Agents (version 3.5 or later), you must set the RTSERVERS variable and restart the PATROL Agent. Provide comma separated RTSERVERS variables in the format protocol:hostname:port. For example, tcp:localhost:2059.
   11. 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: The default file format for the operating system is automatically selected. Select a different format if required.

10. Perform one of the following steps:

    • To save the package and download it immediately, click Save and Download. You can download an installation package on one or more hosts and install the components manually.

    A template of the package is saved to the installationDirectory\truesightpserver\data\pproxy\installer_templates folder and is listed in the Deployable Packages tab.

     

Creating the PATROL default account in Linux

NOTE: Do not use root user to install PATROL products because this might create security risks.

1. Log into the Linux box with a root account in order to create the patrol user
2. Create a user called: patrol
           useradd -m patrol
3. Create the password for the user patrol
           passwd patrol
4. Add patrol user to sudoers
           usermod -aG wheel patrol
5. Open a new session and log into the Linux box using the patrol account
6. Ensure that the account has permission to create directories in the directory where you will install PATROL products. 
           cd /opt/
           chmod 757 bmc
7. All should be set up and ready to install a deployable package

Downloading and installing saved packages manually

1. Use the Save and Download option while creating a deployable packages.
2. Copy the deployable package to the PATROL Agent host on which the package needs to be installed.
3. Extract the installation package as appropriate for your operating system.
   The package is extracted to the bmc_products directory on the current host.
4. From the bmc_products directory, run the installation utility for your operating system:
   • (UNIX or Linux) RunSilentInstall.sh
     • For Linux, remember to use the non root account, patrol default account
   • (Microsoft Windows) RunSilentInstall.exe
5. Review the RunSilentInstall.log file located at the %PATROL_HOME%/log directory