Upgrading the Integration Service and Remote Cell silently

Where you are in the Upgrade process

To upgrade the Integration Service and remote cell silently

Do the following:

1. 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.
2. Navigate to the TSIMAgent.zip file available in the installationDirectory\pw\pronto\web\html\download\win32_agent directory and extract its contents.
3. Open and edit the bmc_tsim_is_upgrade.options file in a text editor. 

   1. 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

   2. Enter the Integration Service and remote cell installation configuration information under User Input Properties.

      -J name=value

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

      -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

      The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
      This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.Consider the following scenarios with example parameters:

4. (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>

5. Run the following command to upgrade the Integration Service on the local computer by using the bmc_tsim_is_upgrade.options file:
   
   (Windows) install.cmd -i silent -DOPTIONS_FILE="<fullyQualifiedPath>\bmc_tsim_is_upgrade.options"
   (Linux) ./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.

   (Windows) install.cmd -i silent -DOPTIONS_FILE="C:\Temp\bmc_tsim_is_upgrade.options" (Linux){{code language="none"}}
    ./install.sh -i silent -DOPTIONS_FILE="/tmp/bmc_tsim_is_upgrade.options"
   {{/code}}****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.

   Do the following if you have upgraded as a non-root user on a Linux operating system:

   • 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

   • If the following warning message is displayed in the tsim_agent_install.log file, run the chmod command to update the file permissions.

     LOG EVENT

     {Description=[<AGENT_INSTALL> Unable to execute command successfully. Command: [/tmp/BPPMAGENTSCRIPTS/./restoreISFilePermissions.sh, /tmp/BPPMAGENTSCRIPTS/filesList.properties]

     Run the following commands to update the file permissions.

     chmod 664 $BPPM_AGENT_HOME/pw/monitors/monitors/NodePingMon/libNodePingMon.sl
     chmod 664 $BPPM_AGENT_HOME/pw/server/etc/mcell.propagate
     chmod 664 $BPPM_AGENT_HOME/pw/server/etc/mcxa.conf
     #Cell is installed on same server
     chmod 774 "/etc/mcell/setup_env.sh"
     chmod 774 "/etc/mcell/setup_env.csh"
6. To verify that the Integration Service is running:
   
   • (Windows) ensure that the Integration Service Ver x.xbuild yyyy(portNumber) service status is started. If the Infrastructure Management Integration Service Ver x.xbuild yyyy(portNumber) service is not running, start it. 
   • (Linux) navigate to the installationDirectory/pw/pronto/bin/ directory, and run the pw agent status command. Verify that the tsim_agent process is listed. If the tsim_agent process is not listed, run the pw agent start command. This command restarts all the Integration Service processes. 
   • If any exceptions occur, check the following log files that are stored on the  TrueSight Infrastructure Management  Server at installationDirectory\pw\pronto\logs:
     • TrueSight.log
     • TSIMAgent.log

   • If you are not able to identify the problem, contact BMC customer support for assistance.

     Note

     Ensure that you restore the mcell.dir file that you had taken a back up before upgrading the Integration service.

   • On both Microsoft Windows and Solaris platforms, to verify that the cell is running, run the mcstat -n cellName command to check the cell's status. If the cell is not running, use the appropriate start procedure. (On Solaris, source the setup_env.sh file in the /installationDirectory/pw/server/bin directory to run the mcstat command.)

   • If you have any problems with the cell, see Cells troubleshooting

Restoring original security certificates for Integration Service

During the Integration Service upgrade, the installer automatically takes a backup of the keystore, and keystore password files in the <installationDirectory\Agent\backup_security_<oldversion> location. After the upgrade is completed, these backed up files are automatically restored to the following directory location.

• (Microsoft Windows) <installationDirectory>\pw\pronto\conf
• (Solaris or Linux) <installationDirectory>/pw/pronto/conf

Troubleshooting upgrade issues

If you face issues during upgrade, see Troubleshooting an Integration Service deployment.

Next step in the Upgrade process

Now that you have successfully upgraded Integration Service and cell, upgrade the other TrueSight Operations Management components as per your requirements. For instructions, see Upgrading.