Installing a specific maintenance level of the WebSphere MQ resource adapter

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

Before you begin

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

About this task

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

You do not need to use this task if you want to restore the configuration of all servers in your cell to use the latest version of the WebSphere MQ resource adapter contained in the WebSphere Application Server installation. In this case, see Ensuring that servers use the latest available WebSphere MQ resource adapter maintenance level for further information.

Procedure

  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 that you want to update.
  4. Select the WebSphere MQ messaging provider entry in the list.
    The settings panel for this provider opens.
  5. Click Update resource adapter....
    Note: Update resource adapter... is only available for the WebSphere MQ messaging provider at node scope.
  6. Specify the installation path for the resource adapter archive (RAR) file, then click Next:
    • If your RAR file is located on the same workstation as your browser, select Local file system, and browse to find the file.
    • If your 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 that is provided for the RAR file then, when you 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.
    You can also edit these properties after you have completed the update.
    1. From the displayed list, select the resource for which you want to edit the new properties.
      Only resources with new properties are included in the list.
    2. Edit the resource properties.
      Use the table that is 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 that are 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 you are satisfied with the configuration settings, click Finish.
    When you click Finish, all the configuration changes are saved automatically. To revert to an older version of the resource adapter you must perform the update process again, and specify the older version of the RAR file that you want to revert to.
  10. Restart the servers that contain the updated RAR file.