Page tree

Skip to end of metadata
Go to start of metadata

This section lists the tasks that you must perform before you begin to upgrade to Integration Service and remote cell 10.7:

Ensure that you have prepared your setup for upgrade. See Prerequisites for upgrade.

  • Ensure to close all the files and folders opened in the current session as well as close other user sessions on the server before starting an 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.
  • Ensure that you take a backup of the ProductRegistry.xml file. While performing the upgrade as a non-root user, ensure that the non-root user has read, write, and execute permissions for the ProductRegistry.xml file.
  • Ensure that you take a backup of the Integration Service keystore files, and keystore password files located in the installationDirectory\pw\pronto\conf directory.

Remote cell knowledge base migration

If a cell that resides on the computer has a customized knowledge base and configuration, you must run the mmigrate utility to succefully migrate these. For information about the cell migration, see Cell configuration migration (cells).

When you upgrade an Integration Service, you also upgrade the following components:

  • Self-monitoring Service
  • Event Manager
  • BMC Event Adapters
  • cell

Note

The cells created by executing the mcrtcell command will not start unless upgraded manually using the mmigrate utility. For more information, see Using the mmigrate utility.

After you upgrade an existing Integration Service, it starts the BMC Event Adapter. For supported Perl versions for the BMC Event Adapters, see the System requirements and product compatibility for Infrastructure Management.

Manually stopping Perl and msend processes

Stopping the Perl based-adapters service does not stop the Perl process. Because the Perl service is still running, one of its msend processes continues to run. Killing the Perl process does not kill the msend process. This prevents the upgrade utility and the uninstallation utility from cleaning up and causes multiple Perl processes to be running if the service is restarted. 

To prevent this issue from occurring, perform the following steps before upgrading or uninstalling BMC Event Adapters:

  • Manually stop the BMC Event Adapters service.
  • Ensure that all Perl and msend processes are stopped. If necessary, stop the msend and Perl processes by using the Windows Task Manager.

Upgrading cell when the standalone or High Availability mode is manually changed 

If you have manually changed the standalone or High Availability (HA) mode for the cell after installation, note the following points before proceeding with the upgrade:

  • If the cell was initially installed in the standalone or secondary mode and then manually converted to the primary cell in the HA mode, open the Command Prompt and perform one of the following steps:
    • For Windows, navigate to the  <installLocation>\Windows\TSIMAgent\Disk1 directory, and run the following command:
      setup.exe -J HA_MODE_SELECTED=true -J CELL_MODE=primary
    • For Linux, navigate to the  <installLocation>\Linux\TSIMAgent\Disk1 directory, and run the following command:
      setup.bin -J HA_MODE_SELECTED=true -J CELL_MODE=primary
  • If the cell was initially installed in the standalone or primary mode and then manually converted to the secondary cell in the HA mode, open the Command Prompt and perform one of the following steps:
    • For Windows, navigate to the <installLocation>\Windows\TSIMAgent\Disk1 directory, and run the following command:
      setup.exe -J HA_MODE_SELECTED=true -J CELL_MODE=secondary

    • For Linux, navigate to the <installLocation>\Linux\TSIMAgent\Disk1 directory, and run the following command:
      setup.bin -J HA_MODE_SELECTED=true -J CELL_MODE=secondary

  • If a cell  was initially installed in the HA mode and then manually converted to the standalone mode, open the Command Prompt and perform one of the following steps:
    • For Windows, navigate to the <installLocation>\Windows\TSIMAgent\Disk1 directory, and run the following command:
      setup.exe -J HA_MODE_SELECTED=false -J CELL_MODE=standalone

    • For Linux, navigate to the <installLocation>\Linux\TSIMAgent\Disk1 directory, and run the following command:
      setup.bin -J HA_MODE_SELECTED=false -J CELL_MODE=standalone