Installing or upgrading the remote Integration Service and remote cell

Feature packs and fix packs contain a full installation of the Infrastructure Management Integration Service.

If you have already installed version 10.5.00 or 10.5.00.001 of the Integration Service, you can upgrade it. If not, you can install a fresh version of the Integration Service.

To install a fresh version of the remote Integration Service or remote cell

1. Install the Fix Pack from either the Fix Pack installation files or from the TrueSight console:
   
   • From the Fix Pack installation files:
     1. Access the TSIMAgent\<OS> folder and extract the contents of the TSIMAgent file. From the extracted TSIMAgent folder, access the Disk1 folder.
        

     2. (Windows) Right-click the install.cmd file and select the Run as administrator option to launch the Integration Service installer. Do not use the setup.exe file.
        (UNIX) Run the ./install.sh command.
        

   • From the TrueSight console:
     1. In the navigation pane, expand Configuration and select Managed Devices.
     2. Select the Infrastructure Management Server where you want to download the software.
     3. Click the common action menu and select Download Integration Service/Administrator Console.
        
        The Downloads page opens in a new browser tab or window.

     4. From the Infrastructure Management Administrator Console Software table, select the appropriate Integration Service installation utility depending on the operating system, and save the file to the computer on which you want to install the software.

     5. Extract the contents of the TSIMAgent file and access the Disk1 folder.
     6. (Windows) Right-click the install.cmd file and select the Run as administrator option to launch the Integration Service installer. Do not use the setup.exe file.
        (UNIX) Run the ./install.sh command.
        

     Tip

     Do not run the installer from within a compressed file. Always extract the contents of the compressed file that contains the installer before running it.

    
2. On the Welcome page, click Next.
3. On the License Agreement page, select I agree to the terms of the license agreement, and click Next.
   The pre-installation check utility verifies whether the computer meets the requirements for installing the Integration Service. If the pre-installation check fails, the errors or warnings are listed in the Notification page. In that case, ensure that you correct the issues, and restart the installation process.
4. Select the installation directory and click Next.
5. Select the components to install - Integration Service, Remote cell, or both.
6. Enter details for the components you choose. You can also configure the Remote cell for High Availability.
7. Click Install.
   The installer configures the components and starts the installation process. This might take some time. After the installation, the Installation Summary dialog box displays a summary. To view the installation logs, click View Log.
8. Click Done to complete the installation process.

To upgrade an existing remote Integration Service or remote cell

1. Upgrade the Integration Service from either the Fix Pack installation files or from the TrueSight console:
   
   • From the Fix Pack installation files:
     1. Access the TSIMAgent\<OS> folder and extract the contents of the TSIMAgent file. From the extracted TSIMAgent folder, access the Disk1 folder.
        

     2. (Windows) Right-click the install.cmd file and select the Run as administrator option to launch the Integration Service installer. Do not use the setup.exe file.
        (UNIX) Run the ./install.sh command.
        

   • From the TrueSight console:
     1. In the navigation pane, expand Configuration and select Managed Devices.
     2. Select the Infrastructure Management Server where you want to download the software.
     3. Click the common action menu and select Download Integration Service/Administrator Console.
        
        The Downloads page opens in a new browser tab or window.

     4. From the Infrastructure Management Administrator Console Software table, select the appropriate Integration Service installation utility depending on the operating system, and save the file to the computer on which you want to install the software.

     5. Extract the contents of the TSIMAgent file and access the Disk1 folder.
     6. (Windows) Right-click the install.cmd file and select the Run as administrator option to launch the Integration Service installer. Do not use the setup.exe file.
        (UNIX) Run the ./install.sh command.
        

     Tip

     Do not run the installer from within a compressed file. Always extract the contents of the compressed file that contains the installer before running it.

2. On the Welcome page, click Next.
3. On the License Agreement page, select I agree to the terms of the license agreement, and click Next.
   The pre-installation check utility verifies whether the computer meets the requirements for installing the Integration Service. If the pre-installation check fails, the errors or warnings are listed in the Notification page. In that case, ensure that you correct the issues, and restart the installation process.
4. The installer lists existing Integration Service instances, if any.
   Choose to install a new instance or upgrade an existing instance. Highlight the instance you want to upgrade and click Next.
5. If you are upgrading an Integration Service instance, the Upgrade Confirmation screen is displayed. Select Yes to confirm and click Next.
6. On the KB Migration Path screen, indicate if you have already migrated customized BMC Event Manager KBs to the Infrastructure Management KB.
   The default option is No. Select Yes if you have already migrated the customized KB and select the migrated KB folder.
   For more information, see  Using the mmigrate utility.

7. Click Install.
   The installer configures the components and starts the upgrade process. This might take some time. After the installation, the Installation Summary dialog box displays a summary. To view the installation logs, click View Log.

8. Click Done to complete the upgrade process.
9. If the Impact Manager cell instances are not running, start them manually.

To configure the remote Integration Service or remote cell after installing the Fix Pack

Migrate Knowledge Bases for custom cells

The Fix Pack installer upgrades and migrates the cell created by the installer. For custom cells that are created manually, the installer upgrades the cell binaries but does not migrate the KBs.

To migrate the KBs for custom cells, perform the following steps:

1. Follow the instructions at Using the mmigrate utility.
2. Compile and restart the custom cells. For more information, see Compiling a Knowledge Base - mccomp.

Reinstall the pproxsrv service

If you installed the pproxsrv service on the remote Integration Server for configuring the HP-OM and Tivoli adapters, the Integration Service installer removes the pproxsrv service when you upgrade the Integration Service. The pns.reg file entries are also removed.

After upgrading the Integration Service, perform the following steps:

1. From the pw command prompt window, run the following command:
   pproxsrv -install -p <port number> -m
2. Load the pns.reg file.

Copy the S81pronto file

If you installed or upgraded the Integration Service on Linux as a non-root user, perform the following step:

Have an administrator of the Integration Service host machine copy the S81pronto.xxxx file from installedDirectory/pw/pronto/bin to the /etc/rc.d/rc5.d directory.

The S81pronto.xxxx file is needed to automatically start the Integration Service after a restart of the host machine.

Reconfigure the remote Integration Service to run as a Network Service user

This step is required only if you configured the remote Integration Service to run as a Network Service user before upgrading to 10.5 Fix Pack 2.

After upgrading to 10.5 Fix Pack 2, the remote Integration Service reverts to run as a Local System user. Reconfigure it to run as a Network Service user. For more information, see Configuring TrueSight Operations Management components to run as a Network Service user.

(Optional) To configure the Integration Service and PATROL Agent to enable TLS communication

Fix Pack 1 (10.5.00.001) for the Integration Service supports the TLS protocol with SHA-256 certificate support on the PATROL Agent to Integration Service communication channel. This requires the BMC PATROL Agent 10.0 or later.

After upgrading the Integration Service, perform the following steps to enable the Integration Service and PATROL Agent communication to be TLS-compliant.

UNIX

1. Stop the Integration Service by running the following command: 

   pw is stop

2. Navigate to the <Integration Service installation directory>/TSIMAgent/pw/patrol/common/security/config_v3.0 directory.

3. Run the following command:

   #Syntax ./set_unset_tls_IS.sh <$BMC_ROOT> <SET_TLS;UNSET_TLS> <security_level>  
   #Example $set_unset_tls_IS.sh "/opt/TSIMAgent/pw" SET_TLS 3 

4. Modify the bppmpis.plc file from the /etc/patrol.d/_opt_bmc_TSIMAgent_pw/security_policy_v3.0 directory with the following changes:

   1. At the end of the server section, add the following entries :

      service = SSL
      provider = bmcsslNull
      module_name = libbmcnss.so

   2. In the server section, update the identity and password values with the custom certificate values. Example provided below:

      Original:
      password = 17fa9e37f011ec79ef0b32d00cbc98c4f4ca367272714f6b, sample.bin
      identity = server
      
      Updated:
      password = 67f3e6095553374389b1556afa7e0e4437f6ba5e80295d50acd965c0c603286f, sample.bin
      identity = server - Frisky

5. Modify the access file from the $BMC_ROOT/pw/patrol/common/security/keys directory and add the highlighted lines:

   For security levels 0-2	[SSL_SERVER] ; ALLOW_ACL = *@bmc.com,*@BMC.COM NSS_DB_HOME = sql:”server certificate path”
   For security levels 3-4	[SSL_SERVER] ; ALLOW_ACL = *@bmc.com,*@BMC.COM NSS_DB_HOME = sql:”server certificate path” [SSL_CLIENT] ; NSS_DB_HOME = sql:”client certificate path”

Windows

1. Stop the Integration Service:

   1. Navigate to Start > Settings > Control Panel.

   2. Double-click the Services icon to launch the Services dialog box.
   3. Locate the BMC TrueSight Infrastructure Management Integration Service in the list of services, highlight, and click Stop. 

   4. Click Yes to close the warning message that is displayed. 
      The status for the Integration Service changes from Started to (blank).

2. Navigate to the <Integration Service installation directory>\TSIMAgent\patrol\common\security\config_v3.0 directory.

3. Run the following command:

   #Syntax set_unset_tls_IS.cmd <$BMC_ROOT> <SET_TLS;UNSET_TLS> <security_level> -serverDbPath <serverDbPath> -identity <identity> 
   #Example $set_unset_tls_IS.cmd "C:\Program Files\BMC Software\TSIMAgent" SET_TLS 3 -serverDbPath "C:\Certificates\server_db" -identity bmcpatrol

Where to go from here

Install the Fix Pack on the Infrastructure Management server. For more information, see Applying feature packs or fix packs on the Infrastructure Management server.

Related topics

Configuring TrueSight Infrastructure Management to enable TLS 1.2

Applying feature packs or fix packs on Infrastructure Management in high availability cluster mode

Applying feature packs or fix packs silently on Infrastructure Management