Downloading and installing additional instances of the Integration Service

Where you are in the Installation process

The Integration Service collects device-specific data such as CPU usage, memory usage, and other data specific to the host operating system and enables Infrastructure Management Servers to remotely gather statistical data from all supported operating systems. The Integration Service can collect data from PATROL and external products, such as HP Operations Manager and IBM Tivoli Monitoring.

You can download an installation utility for the Integration Service from the TrueSight console and install the Integration Services on additional computers in the environment that you want to monitor. However, the downloadable file for the remote cell on the HP-UX operating system is available only on the BMC Electronic Product Distribution (EPD) website .

To download the installation files

1. Log in to the TrueSight console.
   
2. In the navigation pane, expand Configuration and select Managed Devices.
3. Select the Infrastructure Management server where you want to install the software.
4. Click the action menu and select Launch Downloads console.
   
   The Downloads console opens in a new browser tab.

5. From the Infrastructure Management Integration Service Software table, select the installation file for the applicable operating system. Save the file to the computer on which you want to install the Integration Service.
   You can now install the Integration Service and Remote Cell.

To install the Integration Service and Remote Cell

Do the following:

1. Log in to the host computer (as a root user or a non-root user if you are using Linux) on which you want to install the Integration Service and Remote Cell, and delete all the files from the temporary directory: 

   • (Windows) %temp%
   • (Linux) /tmp
2. Extract the downloaded zip files (the installer) to a temporary directory.

3. Save the TSIMAgent.zip file on your drive and extract its contents.

4. (Linux) Apply executable rights to all the installation files by running the following command: 

   chmod -R 755 installationDirectoryFolderName 

   installationDirectoryFolderName is the name of the folder that contains all the installation files.

   Example: chmod -R 755 Disk1

5. Navigate to the Disk1 directory of the extracted folder, and run the installer:

   • (Windows) install.cmd with the Run as administrator option

   • (Linux) ./install.sh as a root user or a non-root user

6. Review the Welcome page, and click Next.

7. Read the license agreement, agree to the terms, and click Next. 
   The preinstallation check utility verifies whether the computer meets the requirements for installing the Integration Service. If the preinstallation check fails, the errors or warnings are listed in the Notification page. Ensure that you correct the issues, and restart the installation process.

   A warning is displayed if the Microsoft .NET Framework is not installed on the computer. Install Microsoft .NET Framework version 3.0.

8. If you want to install an additional Integration Service, on the Existing Installed Instances Detected page, select Install a new instance of this application.

9. The default installation directory for the first instance is:

   • (Windows) \Program Files\BMC Software\TSIMAgent

   • (Linux) /opt/bmc/TSIMAgent

   Retain the default or select a different directory, and click Next.

   Note

   • (Windows) Do not install the product in a root directory (for example, C: or D: ), shared drive, or directly in the Documents and Settings folder.
     
   • (Linux) Do not install the product in the root directory.
   • (Linux) The directory in which the the product is installed and all its parent directories must have 755 permissions (read, write, and execute permissions to owner, groups, and others) and must be owned by root as well as others. Without these permissions and ownership, you will not be able to log in to the TrueSight Infrastructure Management Server.

10. Select the components that you want to install, and click Next.

11. Based on your selection, the applicable configuring pages are displayed. Type the appropriate details and click Next.

    1.  Configuring the Integration Service

       • Port number for the Integration Service. The range is between 1024 and 65535. Ensure that the specified port is free.

       • Port number of the staging adapter. The default port number is 3183. Ensure that the specified port is free.

         Port	Communication channel	Property in the pronet.conf file
         Integration Service	Integration Service ↔ Infrastructure Management server	pronet.apps.agent.port
         Staging Adapter	Integration Service ↔ PATROL Agent	pronet.apps.is.staging.port

    2.  Configuring the Remote Cell

       i. Provide the Remote Cell configuration details:

       • Name of the cell instance. The host name is the default cell instance name.
       • Port number for the cell. The range is between 1024 and 65535. The default port number for the cell is 1828. Ensure that the specified port is free.
       • Encryption key for the cell. The default value is mc, and special characters are not allowed.

       ii. To configure the cell in a high availability mode, select Configure High Availability mode, select one of the following options, and provide the required details:

       • Primary Server—In the Secondary Cell HostName box, enter the host name of the secondary cell. 
         You do not have to enter the details of the primary server. The Cell Instance Name, the Cell Port, and the Cell Encryption Key details that were specified in the previous step are used as the details for the primary server.

       • Secondary Server—The details of Cell Instance Name, the Cell Port, and the Cell Encryption Key must be the same as the primary server. Provide the following details for the secondary server: 

         • Instance name of the secondary cell
         • Port number for the secondary cell. The range is between 1024 and 65535.  Ensure that the specified port is free.

         • Encryption key for the secondary cell. The default value is mc, and special characters are not allowed.

           If the SecondaryCell Encryption Key value is mc, this signifies that the cell is using Secure Socket Layer (SSL) security protocol for its communication.

           To configure the cell to communicate using Transport Layer Security (TLS) protocol, set the SecondaryCell Encryption Key value to tls.

         • Host name of the primary cell.

           After you configure cells in the high availability mode, the secondary remote cell service is displayed as Started.

    3.  Configuring the Integration Service and the Remote Cell:

       1. Configure the Integration Service. See Step11 (a) above.

       2. Configure the Remote Cell. See Step 11 (b) above.

       
       

12. Review the installation details, and click Install.
    After the installation is complete, the Installation Summary page is displayed.

    Do the following after you complete installing as a non-root user on a Linux operating system:

    • Manually copy the S81pronto.<User_ID>.<Agent_Instances> file from the /pw/pronto/bin directory to the /etc/rc.d/rc<Runlevel_Directory>.d directory.

      User_ID - User ID of the logged-in user

      Agent_Instances - Number of Integration service instances on the computer

      Runlevel_Directory - Number of runlevel directory

    • Open the /etc/rc.d/rc.local file, comment the pre-existing S81pronto file entries, and add a fresh entry of S81pronto.<User_ID>.<Agent_Instances> in the /etc/rc.d/rc.local file as shown in the following example:
      

      #/etc/rc2.d/S81pronto.0.2
#/etc/rc2.d/S81pronto.0.2
#/etc/rc2.d/S81pronto.0.2
/etc/rc2.d/S81pronto.1004.1

    • Revoke the write permissions for the non-root users from the following directories:
      • /etc/patrol.d
      • /etc/init.d, /etc/rc.d/rc0.d, /etc/rc.d/rc1.d, /etc/rc.d/rc3.d, and /etc/rc.d/rc5.d

13. Select View Logs to open the installation logs. 

14. To verify that the Integration Service is running:

    • (Windows) Check if the Integration Service(portNumber) service status is Started.

    • (Linux) Navigate to the installationDirectory/pw/pronto/bin/ directory and run the pw agent status command. Verify that the pronet_agent process is listed. 

      If the pronet_agent process is not listed, run the pw agent start command. This command restarts all the Integration Service processes.

    
    

Next step in the Installation process

Now that you have successfully installed additional instances of the Integration Service, install the other TrueSight components as per your license entitlements. For instructions, see Installation process.