Upgrading the Integration Service and remote cell silently

This topic presents upgrade procedure for the Integration Service and remote cell from an earlier version to version 11.0. You can upgrade these components using the silent upgrade procedure, as described in this topic, or you can upgrade using the upgrade wizard.

When you run the silent upgrade, only the components that are already installed on the computer are upgraded. 

Before you begin

  • Access one of the following locations and download the installation files to a temporary directory on the computer on which the Integration Service and remote cell will be upgraded:

  • Ensure that you have completed all tasks described in the Prerequisites for Integration Service and Remote cell upgrade.
  • Ensure that you take a backup of the earlier installation directory of the Integration Service and remote cell. If they are installed on virtual machines, take snapshots of the virtual machines.

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 for the earlier installation of cell
    OLD_INSTALL_LOCATIONLocation for the earlier installation of the Integration Service
    IS_CELL_UPGRADE

    Setting to enable the cell upgrade.

    IS_I_S_UPGRADE

    Setting to enable the IS upgrade.

    Consider the following scenarios with example parameters:

    Scenario

    Parameters to run

    When both Integration Service and cell are installed in a 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 Integration Service or only cell if they are installed in the same folder. You must upgrade both at the same time. The installer displays the error message to upgrade both Integration Service and cell.

    When both Integration Service and cell are installed in different foldersUpgrade any one component at a time
    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

    Notes:

    • If the cell is already installed in the same folder with the Integration Service, you cannot upgrade the Integration Service only. You must upgrade both components together.
    • If the cell is not installed but the cell directory exists in the computer, rename the cell directory and proceed with the Integration Service upgrade. Post upgrade, you can rename the cell directory to the original name.
    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. (Optional) If you have already migrated customized KB definitions to the new standard 11.0 KB, set the value of the MIGRATED_KB parameter to true and provide the path of the customized KB directory: 

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

    Parameter

    Description

    MIGRATED_KBSetting to enable KB migration. The default value is true.
    MIGRATED_KB_HOMEPath of the customized KB directory

To upgrade the Integration Service and remote cell on Microsoft Windows silently 

Perform the following steps to upgrade the Integration Service and the TrueSight Infrastructure Management Remote cell:

  1. Customize the bmc_tsim_is_upgrade.options file as required, which is available in the extracted zipped folder.

  2. Open the command prompt with the Run as administrator option. Navigate to the install.cmd file, which is available in the extracted zipped folder.
  3. Run the following command to upgrade the Integration Service on the local computer 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 refer the tsim_agent_install.log file.

To upgrade the Integration Service and remote cell on Linux silently 

Notes

  • From TrueSight TrueSight Infrastructure Management 10.5, upgrade of the Integration Service is not supported on the Solaris or AIX operating systems.
  • On the Solaris operating system:
    • If you have only remote cell installed, you can upgrade it.
    • If you have both Integration Service and remote cell installed, you cannot upgrade any of these components.
  • On the AIX 7.1 operating system, you cannot upgrade Integration Service or remote cell.

Perform the following steps to upgrade the Integration Service and remote cell on Linux:

  1. Customize the bmc_tsim_is_upgrade.options file as required, which is available in the extracted zipped folder.
  2. Open the command prompt. Navigate to the install.sh file, which is available in the extracted zipped folder.
  3. Run the following command to upgrade the Integration Service and remote cell on the local computer 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 refer the tsim_agent_install_log.txt file for the installation progress details.

Note

If you are upgrading using 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 it needs to be manually copied 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

Where to go from here

  1. After you upgrade the Integration Service and remote cell, verify that Integration Service and cell is running
  2. Restore original SSL certificates for Integration Service.
Was this page helpful? Yes No Submitting... Thank you

Comments