Home

 

Migrating from an earlier version of WebSphere MQ for AIX

If you want to migrate from an earlier version of a WebSphere MQ for AIX client to an IBM WebSphere MQ for AIX, V6.0 client, first end all WebSphere MQ activity on the target machine, and remove any shared resources that are used by WebSphere MQ. Do this either by shutting down the system and restarting it, or by issuing the icprm command to remove the shared resources.

The migration procedure described in this section applies only to migration from an earlier version of a WebSphere MQ for AIX client to IBM WebSphere MQ for AIX, V6.0 clients. If you are migrating from an earlier version of WebSphere MQ or MQSeries for AIX, you are advised to uninstall your current version before installing the IBM WebSphere MQ for AIX, V6.0 client.

Migration from an earlier version of WebSphere MQ for AIX involves updating any currently installed filesets, and installing any new filesets that might be required.

To update currently installed filesets:

1. Go into SMIT for root authority. From the shell, enter:

   smit

2. Select the device appropriate for your installation using the following sequence of windows:

       Software Installation and Maintenance
         Install and Update Software
           Update Installed Software to Latest Level (Update All)

   Alternatively, we can use the fastpath command to select the appropriate device:

   smitty update_latest

3. Select the List button to display the Single Select List window.

4. Select /dev/cd0 (CD Drive).

5. Select OK to display the parameters for Update All.

6. Update all previously installed software for WebSphere MQ by selecting the _update_all option in the Software to update field.

7. Press Enter.

8. Select OK in the confirmation window to start updating the software.

Once all previously installed filesets have been updated to the latest level, we can install any additional filesets. See the installation instructions for more information.

 

Changes to the installation path

Changes in AIX LPP V4 packaging mean that the IBM WebSphere MQ for AIX, V6.0 client installs into directory /usr/mqm. Versions previous to WebSphere MQ for AIX, V5.3 of the product installed into directory /usr/lpp/mqm.

Installation of the IBM WebSphere MQ for AIX, V6.0 client fails if a file system mounted as /usr/lpp/mqm is detected. If you are migrating from an earlier version and a file system exists for this directory, you will need to do one of the following things before installing the IBM WebSphere MQ for AIX, V6.0 client. Either:

• Uninstall your existing WebSphere MQ or MQSeries client, and either delete the file system or move it to the new install path of /usr/mqm

or

• Move the old file system of /usr/lpp/mqm to the new install path of /usr/mqm and create a symbolic link from the old path to the new by issuing the following command:

  ln -s /usr/mqm /usr/lpp/mqm

If you uninstall your existing client and either delete or move your existing file system, we can then install the IBM WebSphere MQ for AIX, V6.0 client as described in the installation instructions.

However, if you move the old file system to the new installation path, you should then perform the migration installation described in Migrating from an earlier version of WebSphere MQ for AIX.

Note:

If you have already symbolically linked a file system to /usr/lpp/mqm, installation of the IBM WebSphere MQ for AIX, V6.0 client will destroy the contents of the file system and the symbolic link, leaving an empty file system. If this happens, you are advised to uninstall your existing WebSphere MQ client and either delete the file system or relink it to the new install path of /usr/mqm, before installing the IBM WebSphere MQ for AIX, V6.0 client.

The installation process for the IBM WebSphere MQ for AIX, V6.0 client creates a symbolic link from the old install path (/usr/lpp/mqm) to the new install path (/usr/mqm). Therefore any existing scripts or makefiles that reference the old path are still valid.

 

Home