Migrating and upgrading WebSphere MQ

To migrate a queue manager to run on a new level of code, you must first upgrade WebSphere® MQ to install the new code level. When you have verified the upgrade is successful, migrate the queue manager and all the applications and resources associated with it. Before starting this process, create a migration plan, based on the information in this migration guide. If you are applying maintenance, no migration is necessary, but you must test applications with the new level of WebSphere MQ code.

The IBM® WebSphere MQ Migration Guide provides information to help you plan the process of migrating from an older version to a new version of the product.

For an introduction to the guide and its contents, see the IBM Developer blog article WebSphere / IBM MQ Migration Guide.
To view the guide in your web browser, click the following link: IBM WebSphere MQ Migration Guide - HTML version.
To download the guide as a PDF file, click the following link: WebSphere / IBM MQ Migration Guide - PDF file.

If you want to see what changes have occurred between two versions of IBM WebSphere MQ, see Changes that affect migration. The changes that are listed affect the behavior of existing applications or the automation of management tasks. The lists do not include changes to IBM WebSphere MQ Explorer, or new features that do not change the way existing applications behave. Study the lists of changes to plan what migration tasks you must perform.

If you are not familiar with IBM WebSphere MQ migration, read the topics in Introduction to IBM WebSphere MQ migration.

If you are familiar with IBM WebSphere MQ migration, start with a planning topic listed in Migration planning topics by version and platform. If you already have a migration plan, see Migrating IBM WebSphere MQ to a later version on UNIX, Linux, and Windows for step by step guides about how to migrate queue managers, IBM WebSphere MQ clients, and applications.

If you are running IBM WebSphere MQ Version 7.0.1 on Linux®, UNIX, or Windows , and you are unfamiliar with multiple installations of IBM WebSphere MQ on the same server, examine these three migration scenarios:

Also, consider how multiple installations on the same server can assist you deploying fix packs; see UNIX, Linux, and Windows: Staging maintenance fixes. If you are installing a fix pack that includes optional new function, see Migrating queue managers to new-function fix packs.

IBM WebSphere MQ maintenance tasks describes how to apply and remove maintenance by version and platform, for platforms other than z/OS.

Migration commands, utilities, and reference information describe commands and functions that assist you with migration.