Migrating IBM MQ on UNIX and Linux

Migrating IBM MQ on UNIX and Linux

Migration tasks associated with UNIX and Linux platforms are grouped in this section.

About this task

This topic lists the various steps you need to take to migrate to, or migrate from, the latest version of the IBM MQ product.

See also, Migrating from one Continuous Delivery release to another, if you are migrating a Continuous Delivery release of the product.

If you want to migrate replicated data queue managers, follow the instructions in Migrating replicated data queue managers.

Plan to migrate IBM MQ to a later version on UNIX or Linux
Before migrating IBM MQ to a later version on UNIX or Linux, review the system requirements information, and the information about any changes that might affect migration, then create a migration plan.
Migrating a queue manager on UNIX and Linux
The procedures for migrating a queue manager to a later version of the product, and for restoring a queue manager to an earlier version of the product are detailed in this section.
Migrating an IBM MQ MQI client on UNIX and Linux
Before migrating an IBM MQ MQI client, create a migration plan. Stop all IBM MQ activity on the client workstation. Upgrade the IBM MQ MQI client installation. Make any essential configuration and application changes.
Migrating IBM MQ library loading to a later version on UNIX and Linux
On UNIX and Linux, no change in the way IBM MQ libraries are loaded is normally required if you upgrade from an earlier version of the product to a later version by replacing an earlier version of the product with the later version, based on the single stage scenario. However, if you choose to take advantage of multi-installation in the later version of the product, based on the side-by-side or multi-stage migration scenarios, you might have to configure the runtime environment differently, for the operating system to load the later version of the IBM MQ library.
Migrating from a single instance to a multi-instance queue manager on UNIX and Linux
To migrate a single instance queue manager, to a multi-instance queue manager, on UNIX and Linux, you must move the queue manager data to a shared directory, and reconfigure the queue manager on two other servers.
Reverting to a single-instance queue manager on UNIX and Linux
Revert a multi-instance queue manager to a single instance queue manager, on UNIX and Linux, by stopping the standby instance. Then restart the active instance and do not set the flag that permits standby instances.
Cleaning up after using the rpm freshen or upgrade options on Linux
The use of rpm upgrade or freshen options is not supported. If we use the options, follow this cleanup procedure, and then install following the correct steps.
Rebuilding a C++ application on Linux
C++ IBM MQ MQI client and server applications on Linux must be recompiled using GNU Compiler Collection (GCC) 4.1.2, or later. Compilers older than GCC 4.1.2 are no longer supported. The C++ GCC 4.1.2 run time libraries, or later, must be installed in /usr/lib or /usr/lib64
Parent topic: Migrating IBM MQ

Related concepts

Migration concepts and methods

Related tasks

Migrating IBM MQ on IBM i
Migrating IBM MQ on Windows
Migrating IBM MQ on z/OS

Related reference

Changes that affect migration