+

Search Tips | Advanced Search

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 , you must first stop all IBM MQ activity on the workstation, then uninstall the earlier version and install the later version. After we have upgraded the client, we can then make any essential configuration and application changes.


Before you begin

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 or 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.

You 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

  1. Review the IBM MQ system requirements for the later version of the product.

    See System Requirements for IBM MQ.

  2. Review all the changes in IBM MQ that affect you.

    See Changes that affect migration.

  3. 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.
  4. To upgrade the client on AIX :
    1. Uninstall your existing IBM MQ client installation. For more information, see Uninstalling or modifying IBM MQ on AIX.
    2. Follow the client installation procedure to install the upgraded version of the IBM MQ client:

  5. To upgrade the client on HP-UX:
    1. Uninstall your existing IBM MQ client installation. For more information, see Uninstalling or modifying IBM MQ on HP-UX.
    2. Follow the client installation procedure to install the upgraded version of the IBM MQ client:

  6. To upgrade the client on Linux:
    1. Uninstall your existing IBM MQ client installation. For more information, see Uninstalling or modifying IBM MQ on Linux.
    2. Follow the client installation procedure to install the upgraded version of the IBM MQ client:

  7. To upgrade the client on Solaris:
    1. Uninstall your existing IBM MQ client installation. For more information, see Uninstalling IBM MQ on Solaris.
    2. Follow the client installation procedure to install the upgraded version of the IBM MQ client:


What to do next

After upgrading the IBM MQ MQI client, you must check the client channel configuration, and verify that your IBM MQ MQI client applications work correctly with the later version of the product.