Install a specific maintenance level of the IBM MQ resource adapter

If we require a specific version of the IBM MQ resource adapter to be installed and the version you require is unavailable in a WebSphere Application Server fix pack, or an interim fix, we can install the resource adapter using the administrative console.

For more information about the minimum version of the IBM MQ resource adapter required for this version of WAS, see Which version of IBM MQ is shipped with WAS?.

Use this task only if we have a requirement to use a specific maintenance level of the IBM MQ resource adapter that is unavailable in a WAS fix pack, or an interim fix.

We do not need to use this task to restore the configuration of all servers in the cell to use the latest version of the IBM MQ resource adapter contained in the WAS installation. In this case, see Ensuring that servers use the latest available IBM MQ resource adapter maintenance level for further information.

In a network deployment environment, we must perform the following steps individually for each node where you require to install the specific maintenance level.

Tasks

1. Start the administrative console.

2. In the navigation pane, click...

           Resources > JMS->JMS providers The JMS providers collection panel opens.

3. Change the scope to the node to update.

4. Select the IBM MQ messaging provider entry in the list. The settings panel for this provider opens.

5. Click Update resource adapter....

   Update resource adapter... is only available for the IBM MQ messaging provider at node scope.

6. Specify the installation path for the resource adapter archive (RAR) file, then click Next:

   • If our RAR file is located on the same workstation as your browser, select Local file system, and browse to find the file.

   • If our RAR file is located on the server workstation where the application server is installed, select Remote file system, and specify the fully qualified path to the file.

7. Review the configuration information provided for the RAR file then, when we have finished your review, click Next. The following information is displayed for the RAR file:
   • Name
   • Current RAR version
   • New RAR version
   • Scope

   • Any existing copies of the resource adapter. The resource adapters shown with an asterisk (*) are copies of the resource adapter and must also be updated at the same time.

8. Optional: Edit any properties that were added by the new version of the resource adapter. We can also edit these properties after we have completed the update.

   1. From the displayed list, select the resource for which we want to edit the new properties. Only resources with new properties are included in the list.

   2. Edit the resource properties. Use the table provided to set the values for new properties of the selected resource.

      • Select Set for all to apply the property value to all resources of the same type.

      • Click Reset to Default to reset all the properties to the default values defined in the RAR file. This resetting of property values only affects the selected resource.

   3. Click Next.

9. Review the summary panel and then, when we are satisfied with the configuration settings, click Finish. When we click Finish, all the configuration changes are saved automatically. To revert to an older version of the resource adapter we must perform the update process again, and specify the older version of the RAR file to revert to.

10. Restart the servers that contain the updated RAR file.

JMS providers collection

JMS provider settings