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.

Best practice

BMC recommends that you install the Integration Service and the Infrastructure Management server on separate computers.

To download the installation files

  1. Log in to the TrueSight console.
  1. In the navigation pane, expand Configuration and select Managed Devices.
  2. Select the Infrastructure Management server where you want to install the software.
  3. Click the action menu and select Launch Downloads console.
    Downloads_console.png
    The Downloads console opens in a new browser tab.
  4. 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—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.
  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.


Notes

  • If you modify the control port of a service explicitly through the pronet.conf file, the port number is not updated in the Add/Remove Programs applet and in the Agent Service display name field.
  • Each Integration Service on a system runs on a separate Java Virtual Machine (JVM).
  • You can check the version number of the Integration Service in the AGENT_VERSION file
    • (Windows) installationDirectory\Agent\pronto\bin\AGENT_VERSION
    • (Linux) installationDirectory/pw/pronto/bin/AGENT_VERSION
  • If you are monitoring the Integration Service for a process crash using the Microsoft Debug Diagnostics Tool (DebugDiag tool), BMC recommends that in the Services window, you stop and start the service, instead of restarting the service.

Notes

On Microsoft Windows, if you enabled the Integration Service on a previously installed Integration Service on the same computer, then you do not need to enable the service again. You are not prompted with the Configuring Integration Service option for subsequent agent installations on the same computer.

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.