Windows: Migrating a queue manager from a previous version to the latest version
Follow these instructions to migrate a queue manager from your current version to the latest version.
Before you begin
- Create a migration plan; see Planning migration to the latest version
- For more information about the versions of Windows that IBM® MQ 8.0 supports, see System Requirements for IBM MQ V8.0.
- Review the IBM MQ system requirements for the latest version; see System Requirements for IBM MQ.
- Back up your system before you install the latest
release of IBM MQ over
a previous release. Once you have started a queue manager you cannot
revert to the previous release.
If you must restore the system, you cannot recover any work, such as changes to messages and objects, performed by the latest version of IBM MQ. For more information about backing up your system, see Backing up and restoring IBM MQ queue manager data.
- Review any other installed SupportPacs for their applicability to the latest release.
- If you are running on a server with multiple IBM MQ installations, you must identify the installation. Make sure that the commands you enter run against the correct installation; see setmqenv.
About this task
Complete this task to migrate a queue manager to the latest version of IBM MQ from an earlier version.
All the objects that you previously created are maintained. The components that were previously installed are preselected in the feature options when you install the new level. If you leave these components selected, you can keep them or reinstall them. If you clear any of these components, the installation process uninstalls them. By default, a typical migration installs only the same features that were installed in the previous version installation.
For example, if MQ Explorer was not installed in an earlier installation, it is not stored in a later installation. If you want MQ Explorer, select a custom installation, and select the MQ Explorer feature on the Features panel. If you do not want MQ Explorer, uninstall the MQ Explorer feature by selecting a custom installation. Then clear the MQ Explorer feature on the Features panel. For more information about how to uninstall features, see Modifying the installation using IBM MQ Installation Launchpad.
You can also migrate a queue manager to a later release, on a system where a previous version has been uninstalled. The queue manager data must have been retained, or restored from a backup.
Procedure
What to do next
You might be restoring a previous version on a server with multiple IBM MQ installations. If one of the installations is primary, after restoring the previous version that installation, by default, becomes the primary installation.
You must review how applications connect to an installation. After restoring the previous version, some applications might connect to the wrong installation.