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:
- DVD — Insert the installation DVD. In the <installLocation>\Windows directory, open the TSIMAgent\Windows folder.
- BMC Software EPD website—For more information about downloading the installation program from the BMC Software EPD website, see Downloading the Infrastructure Management installation files.
- TrueSight console—For more information about downloading the installation program from the TrueSight console, see Downloading and installing additional instances of the Integration Service.
- 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
Navigate to the downloaded TSIMAgent.zip file and extract its contents.
Open the bmc_tsim_is_upgrade.options file in a text editor.
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.
Under User Input Properties, enter the Integration Service and remote cell installation configuration information.
-J name=value
name
is the name of the parametervalue
is the value for the parameterParameter
Description
OLD_CELL_INSTALL_LOCATION Location for the earlier installation of cell OLD_INSTALL_LOCATION Location 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 folders Upgrade 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
(Optional) If you have already migrated customized KB definitions to the new standard 11.0 KB, set the value of the
MIGRATED_KB
parameter totrue
and provide the path of the customized KB directory:-J MIGRATED_KB=<true/false> -J MIGRATED_KB_HOME=<KB migration path>
Parameter
Description
MIGRATED_KB Setting to enable KB migration. The default value is true
.MIGRATED_KB_HOME Path 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:
Customize the bmc_tsim_is_upgrade.options file as required, which is available in the extracted zipped folder.
- Open the command prompt with the Run as administrator option. Navigate to the install.cmd file, which is available in the extracted zipped folder.
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:
- Customize the bmc_tsim_is_upgrade.options file as required, which is available in the extracted zipped folder.
- Open the command prompt. Navigate to the install.sh file, which is available in the extracted zipped folder.
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
- After you upgrade the Integration Service and remote cell, verify that Integration Service and cell is running
- Restore original SSL certificates for Integration Service.
Comments