Installing or upgrading the remote Integration Service and remote cell

This Fix Pack contains a full installation of the Infrastructure Management Integration Service.

If you have already installed version 10.0.00 of the Integration Service, you can upgrade it to version 10.0.500.001. If not, you can install a fresh 10.0.500.001 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 Central Monitoring Administration:
   
   • 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 Central Monitoring Administration:
     1. From the Repository drawer, click Integration Services.
     2. Select and download the installation file that corresponds to the operating system on which you want to install the Integration Service.
     3. Extract the contents of the TSIMAgent file and access the Disk1 folder.
     4. (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 Central Monitoring Administration:
   
   • 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 Central Monitoring Administration:
     1. From the Repository drawer, click Integration Services.
     2. Select and download the installation file that corresponds to the operating system on which you want to upgrade the Integration Service.
     3. Extract the contents of the TSIMAgent file and access the Disk1 folder.
     4. (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.

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

Fix Pack 1 (10.0.500.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 and add the following entries at the end of the server section:

   service = SSL
   provider = bmcsslNull
   module_name = libbmcnss.so

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

4. Run regedit to manually update the following registry entry:
   

   HKEY_LOCAL_MACHINE\SOFTWARE\BMC Software\IntegrationService\SecurityPolicy_v3.0\C__Program_Files_BMC_Software_BPPMAgent_Agent_bppmpis\common

   Update the securitydir value from
   securitydir"="C:\\Program Files\\BMC Software\\BPPMAgent\\Agent\\patrol\\common\\security
   to
   securitydir"="C:\\Program Files\\BMC Software\\BPPMAgent\\Agent\\patrol\\common\\security\\keys

Where to go from here

Install the Fix Pack on the Infrastructure Management server. For more information, see Installing the Fix Pack on the Infrastructure Management server.

Related topics

Installing the Fix Pack in high availability cluster mode

Installing the Fix Pack silently