Migrating a queue manager to the latest release

The procedures for migrating a queue manager to the latest release are detailed in the following topics.

Before you begin

This information applies to migrating a queue manager on platforms other than z/OS®.

If you have installed early support program code on the server, you must delete all the queue managers created with the installation. Uninstall the code before proceeding with installing the production level code.

About this task

Migration is a complex task. It goes beyond upgrading the IBM® MQ code. The term upgrading applies to the process of installing a new code level. Migrating refers to the process of upgrading code and the to the task of migrating queue manager data, such as messages, queues, channels, and other resources. Migrating queue manager data is automatic.

Procedure

Queue manager migration follows this overall plan:

  1. Review the IBM MQ system requirements for the latest version; see System Requirements for IBM MQ.
  2. Back up your system. In particular back up the queue manager.

    You cannot run a queue manager on a previous version of IBM MQ, once you start the queue manager on the new version.

  3. Carry out the platform-specific migration or upgrade procedure.
    1. Upgrade IBM MQ.
    2. Customize the configuration.
      [z/OS]
      • Configuration changes are typically required only on z/OS.
    3. Verify the installation.
      • Create a queue manager to verify the installation. Verify applications and management tasks work with the new level of IBM MQ before migrating existing queue managers.
  4. Perform any additional migration tasks that are required.
    • If you are using publish/subscribe, you must migrate the publish/subscribe broker.
    • If the queue manager is a member of a queue manager cluster, or queue-sharing group, migrate the other members of the cluster or group.
    Important: You must migrate the publish/subscribe broker state before you migrate your IBM MQ system to IBM MQ 8.0, as broker publish/subscribe migration is not supported in IBM MQ 8.0.