Applying service packs on the Integration Service and Remote Cell in the standalone mode silently

Where you are in the Applying service packs process

The page .Applying service packs on the Integration Service and Remote Cell in the standalone mode using the wizard v11.3.04 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro

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

If you have already installed an earlier version of the Integration Service, you can upgrade it. If not, you can install a fresh version of the Integration Service.

As a best practice, BMC recommends that both the Infrastructure Management server and the Integration Service are of the same version.

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

To perform a fresh installation of the Integration Service or remote cell silently, see Installing the Integration Service silently.

To upgrade an existing remote Integration Service or remote cell

To upgrade the Integration Service silently, perform the following steps:

To customize the options file

  1. Navigate to the downloaded TSIMAgent.zip file and extract its contents. 

  2. Open the bmc_tsim_is_upgrade.options file in a text editor.

  3. Under Product Install Location, specify a valid directory for the Integration Service or remote cell:

    -P installLocation=<INSTALL DIR>

    <INSTALL DIR> is the installation location.

    Examples

    (Windows)-P installLocation=C:\Program Files\BMC Software\TSIMAgent
    (Linux)-P installLocation=/opt/bmc/TSIMAgent
  4. Under User Input Properties, enter the Integration Service and remote cell installation configuration information.

    -J name=value

    name is the name of the parameter
    value is the value for the parameter

    Examples

    -J OLD_CELL_INSTALL_LOCATION=C:\Program Files\BMC Software\TSIMAgent

    -J OLD_INSTALL_LOCATION=C:\Program Files\BMC Software\TSIMAgent

    -J IS_CELL_UPGRADE=true

    -J IS_I_S_UPGRADE=true

    Parameter

    Description

    OLD_CELL_INSTALL_LOCATIONLocation of the earlier installation of cell.
    OLD_INSTALL_LOCATIONLocation of the earlier installation of the Integration Service.
    IS_CELL_UPGRADE

    Parameter to enable the cell upgrade.

    IS_I_S_UPGRADE

    Parameter to enable the Integration Service upgrade.

    PATROL_STAGING_ADAPTER_PORTUse this parameter only if you have specified a custom staging adapter port.
    AGENT_PORTUse this parameter only if you have specified a custom PATROL Agent port.

    Consider the following scenarios with example parameters:

    Scenario

    Parameters to run

    When both Integration Service and cell are installed in the same folder

    -J OLD_CELL_INSTALL_LOCATION=C:\Program Files\BMC Software\TSIMAgent

    -J OLD_INSTALL_LOCATION=C:\Program Files\BMC Software\TSIMAgent

    -J IS_CELL_UPGRADE=true

    -J IS_I_S_UPGRADE=true

    Note: You cannot upgrade only the Integration Service or cell if they are both installed in the same folder. You must upgrade both at the same time. The installer displays an error message to upgrade both Integration Service and cell.

    When the Integration Service and cell are installed in different folders

    Upgrade any one component at a time.

    Important

    If you are upgrading the remote Integration Service and remote cell as a non-root user on Linux, first upgrade only the remote cell and then upgrade the remote Integration Service.

    After upgrading the remote Integration Service, check if the /server folder exists under the remote Integration Service base installation folder. Delete the folder if it exists.

    Upgrade Integration Service only#-J OLD_CELL_INSTALL_LOCATION=C:\Program Files\BMC Software\TSIMAgent

    -J OLD_INSTALL_LOCATION=C:\Program Files\BMC Software\TSIMAgent

    -J IS_CELL_UPGRADE=false

    -J IS_I_S_UPGRADE=true

    Upgrade cell only

    -J OLD_CELL_INSTALL_LOCATION=C:\Program Files\BMC Software\TSIMAgent

     #-J OLD_INSTALL_LOCATION=C:\Program Files\BMC Software\TSIMAgent

    -J IS_CELL_UPGRADE=true

    -J IS_I_S_UPGRADE=false

  5. Post-installation, if you manually set the cell to high-availability mode, set the value of the following parameter to true

    -J HA_MODE_SELECTED=<false/true> 
  6. You must migrate cell KB before upgrade

    -J MIGRATED_KB=true
    -J MIGRATED_KB_HOME=<KB migration path>

    Parameter

    Description

    MIGRATED_KB

    Setting to enable KB migration. The default value is true.

    From 11.3.05 service pack, the value will be always remain true as the KB migration is a mandatory task.
    MIGRATED_KB_HOMEPath of the migrated KB that ends with the cellname folder.

To install the service pack on the Integration Service and remote cell silently on Microsoft Windows 

  1. Open a command prompt with the Run as administrator option. Navigate to the TSIMAgent\Disk1 folder that contains the install.cmd file.
  2. Run the following command to install the service pack on the Integration Service and remote cell by using the bmc_tsim_is_upgrade.options file:
    install.cmd -i silent -DOPTIONS_FILE="<fullyQualifiedPath>\bmc_tsim_is_upgrade.options"
    where fullyQualifiedPath indicates the complete path where you have saved the bmc_tsim_is_upgrade.options file. The path must be enclosed within double quotes.

    Example

    install.cmd -i silent -DOPTIONS_FILE="C:\Temp\bmc_tsim_is_upgrade.options"

    Installation-related information is not displayed on the console when silent installation begins. However, installation occurs in the background. The installation progress is logged in a temporary folder during installation. Navigate to the Temp folder, and view the tsim_agent_install_log.txt file.

To install the service pack on the Integration Service and remote cell silently on Linux

Note

If you are installing the service pack as a non-root user, ensure that the S81pronto.<User_ID>.<Agent_Instances> file exists in the /etc/rc.d/rc<Runlevel_Directory>.d folder. If the file does not exist in this folder, the installer stops and you need to manually copy the file from the /pw/pronto/bin folder as a root user.

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

  1. Open a command prompt. Navigate to the TSIMAgent\Disk1 folder that contains the install.sh file.
  2. Run the following command to install the service pack on the Integration Service and remote cell by using the bmc_tsim_is_upgrade.options file:

    ./install.sh -i silent -DOPTIONS_FILE="<fullyQualifiedPath>/bmc_tsim_is_upgrade.options"

    where fullyQualifiedPath indicates the complete path where you have saved the bmc_tsim_is_upgrade.options file. The path must be enclosed within double quotes.

    Example

    ./install.sh -i silent -DOPTIONS_FILE="/tmp/bmc_tsim_is_upgrade.options"

    Installation-related information is not displayed when silent installation begins. However, installation occurs in the background. Open /tmp or /var/tmp and view the tsim_agent_install_log.txt file for the installation progress details.

To configure the remote Integration Service or remote cell after installing the service pack

Migrate Knowledge Bases for custom cells

The service 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 Open link


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

The Integration Service supports the TLS protocol with SHA-256 certificate support on the PATROL Agent to Integration Service communication channel. This requires the 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 "PatrolServer - BMC"

Where to go from here

Step 3 Phase B — Now that you have successfully installed the service pack on the Integration Service and Remote Cell, you must install it on the Infrastructure Management server.

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Nikhil Shetty

    The page: .Applying service packs on the Integration Service and Remote Cell in the standalone mode using the wizard v11.3.04 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.

    Apr 01, 2022 12:45