Migrating an IBM MQ MQI client to a later version on UNIX and Linux
To upgrade a client to a later version of the product on UNIX and Linux, we must first stop all IBM MQ activity on the workstation, then uninstall the earlier version and install the later version. After you have upgraded the client, we can then make any essential configuration and application changes.
Before starting
Before migrating an IBM MQ MQI client on UNIX and Linux, first create a migration plan. For guidance on what to include in the plan, see Plan to migrate IBM MQ to a later version on UNIX and Linux, as a guide.
IBM MQ MQI client migration is the process of converting IBM MQ MQI client configurations, and client and server channels from one version to another. Client migration is reversible. It is optional and manual on a client workstation and is required and automatic on the IBM MQ server.
We must upgrade an IBM MQ MQI client before migrating a client workstation to make use of new configuration options. We can make configuration changes to client and server connection channels on the server, but they have no effect on a client workstation until the client is upgraded.
Procedure
- Review the IBM MQ system requirements for the later version of the product.
- Review all the changes in IBM MQ that affect you.
- End all IBM MQ activity on the workstation. You are now ready to upgrade the client. Follow the instructions for the appropriate platform that your enterprise uses.
- To upgrade the client on AIX :
- Uninstall your existing IBM MQ client installation. For more information, see Uninstalling or modifying IBM MQ on AIX.
- Follow the client installation procedure to install the upgraded version of the IBM MQ client:
- For a client installation on a workstation, see Installing an IBM MQ client on AIX
- For a client installation on an IBM MQ server, see Installing IBM MQ clients and servers on the same system.
- To upgrade the client on Linux:
- Uninstall your existing IBM MQ client installation. For more information, see Uninstalling or modifying IBM MQ on Linux.
- Follow the client installation procedure to install the upgraded version of the IBM MQ client:
- For a client installation on a workstation, see Installing an IBM MQ client on Linux.
- For a client installation on an IBM MQ server, see Installing IBM MQ clients and servers on the same system.
What to do next
After upgrading the IBM MQ MQI client, we must check the client channel configuration, and verify that the IBM MQ MQI client applications work correctly with the later version of the product.
Parent topic: Migrating an IBM MQ MQI client on UNIX and Linux
Related concepts
Related tasks