Option 1: Single-stage migration

Option 1 of this scenario shows how to migrate from an earlier to a later version of IBM MQ when using the single-stage migration method. With a single-stage migration, the installation of a later version of IBM MQ replaces an earlier version in the same installation location.


Before starting

The starting point for this scenario is the initial IBM MQ Version 9.1 IT configuration described in Overview: Initial IT configuration.

Before starting this task, follow the instructions in Create a sample initial IT configuration to set up the sample configuration.


With a single-stage migration, we can choose either to uninstall the earlier version of IBM MQ before installing the newer version, or to install the newer version without first uninstalling the older version (that is, to migrate in place). In both cases, the later release is installed in the same directory as the earlier release. Option 1 of this scenario shows a single-stage migration where the older version is uninstalled before installing the newer version. The queue manager data is not removed as part of the uninstallation process, which means that the sample queue managers used in this scenario are retained and are detected when you install the newer version of IBM MQ.

  1. Preparing to migrate
    Before migrating to a later version of IBM MQ, we must first stop the queue manager and back up the queue manager data.
  2. Uninstalling the earlier version
    Uninstall the earlier version using the control panel. For a single-stage migration on Windows, uninstalling the earlier version of the product before installing the later version is optional.
  3. Installing IBM MQ Version 9.2 using the launchpad
    Use the installation launchpad and wizards to install IBM MQ Version 9.2 on the same Windows computer as the one on which the earlier version was installed.
  4. Verify the IBM MQ Version 9.2 installation
    After you install IBM MQ Version 9.2, use IBM MQ Explorer to verify that the queue managers and queues have successfully migrated from the earlier release then verify that we can use the sample application.

Parent topic: Implement the solution using the graphical user interface


Related information