Installing the Integration Service and Remote Cell using the wizard


Where you are in the Installation process

Infrastructure Management allows you to install one or more Integration Services on a single computer. Multiple TrueSight Infrastructure Management Servers in different locations can connect to different Integration Services running on a single computer. However, each Integration Service on a computer can communicate with only one TrueSight Infrastructure Management Server at a time. 

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.


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.

To install multiple Integration Services on a single computer

By installing multiple Integration Services on a single computer, you can partition the monitoring into different domains and maximize hardware usage. Multiple TrueSight Infrastructure Management Servers in different locations can connect to different Integration Services running on the same computer. Each Integration Service can collect a different set of data authorized for its respective TrueSight Infrastructure Management Server. 

Note

  • Installing multiple Integration Services on a single computer adds additional load on the computer in terms of CPU, IO, Memory, and TCP buffer.
  • Do not install an earlier version of the Integration Service on a computer that has a later version installed.
  • When installing multiple integration services on a single computer, only the first integration service installed is installed with a cell. Subsequent integration service installations update the cell installed with the first integration service.

You can choose to install a new instance of the Integration Service or alternatively, you can upgrade an existing Integration Service by selecting from the list displayed. If you want to upgrade an existing Integration Service, see Upgrading.

The procedure to install multiple integration services is similar to installing the Integration Service for the first time.

  1. Perform the installation procedure as described above.
  2. (Windows) If WinPCAP application is installed, on the local agent Installation dialog box, click Yes to overwrite the IP Top10 detailed diagnostics.
  3. Click Finish.

Note

The computer requires time to update installation information. BMC recommends that you wait a minimum of five seconds between installations.

Next step in the Installation process

Step 5 Phase C Task 1 — Now that you have successfully installed the Integration Service and Remote Cell, you must download and deploy monitoring solutions.

 

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