[jun2010]

Ensuring that servers use the latest available WebSphere MQ JCA resource adapter maintenance level

To ensure that the WebSphere® MQ JCA resource adapter is automatically updated to the latest available maintenance level when you apply WebSphere Application Server fix packs, you can configure all servers in your environment to use the latest version of the resource adapter contained in the WebSphere Application Server fix pack that you have applied to the installation of each node.

Before you begin

To be able to complete this task successfully, you must first apply WebSphere Application Server Fix Pack 1 or higher to all installations in your environment.

If you have a requirement to use WebSphere Application Server Version 7.0.0.0 without any fix packs applied, do not continue with this task. Instead, use the task described in Considerations for using WebSphere MQ with WebSphere Application Server 7.0.0.0 without any fix packs applied.

About this task

Use this task if any of the following circumstances apply to your configuration, and you want to configure all servers in your environment to use the latest version of the WebSphere MQ JCA resource adapter:
  • The JVM logs of any application server in your environment show the following WebSphere MQ JCA resource adapter version information after WebSphere Application Server Version 7.0 Fix Pack 1 or later has been applied:
    WMSG1703I:RAR implementation version 7.0.0.0-k700-L080820
  • The JVM logs of any application server in your environment contain the following entry:
    WMSG1625E: It was not possible to detect
    the WebSphere MQ messaging provider code at the specified path <null>
  • One or more nodes has previously been manually updated to use a specific maintenance level of the WebSphere MQ JCA resource adapter that is now superseded by the latest version of the resource adapter contained in the current WebSphere Application Server maintenance level.

When you have performed the following steps for all cells and single server installations in your environment, your servers will automatically receive maintenance to the WebSphere MQ JCA resource adapter when a new WebSphere Application Server fix pack is applied.

Procedure

  1. Ensure that you have applied up to date maintenance to all installations in your environment, so that Fix Pack 1 or higher is now installed.
  2. Start the application server.
  3. Copy the following Jython script into a file called convertWMQRA.py, then save it into the profile_root/bin directory.
    ras = AdminUtilities.convertToList(AdminConfig.list('J2CResourceAdapter'))
    
    for ra in ras :
       desc = AdminConfig.showAttribute(ra, "description")
       if (desc == "WAS 7.0 Built In WebSphere MQ Resource Adapter") or (desc == "WAS 7.0.0.1 Built In WebSphere MQ Resource Adapter"):
          print "Updating archivePath and classpath of " + ra
          AdminConfig.modify(ra, [['archivePath', "${WAS_INSTALL_ROOT}/installedConnectors/wmq.jmsra.rar"]])
          AdminConfig.unsetAttributes(ra, ['classpath'])
          AdminConfig.modify(ra, [['classpath', "${WAS_INSTALL_ROOT}/installedConnectors/wmq.jmsra.rar"]])
          AdminConfig.save()
       #end if
    #end for
  4. Use the wsadmin tool to run the Jython script that you have just created.
    Open a command prompt and navigate to the profile_root/bin directory, then enter the following command:
    wsadmin -lang jython -f convertWMQRA.py
  5. Stop all servers in the profile.
  6. Run the osgiCfgInit command from the profile_root/bin directory.
    Note: The osgiCfgInit command resets the class cache used by the OSGi runtime environment.
  7. Restart all servers in the profile.

What to do next

If you continue to experience problems after performing the steps described in this topic, and you have previously used the Update resource adapter... button on the JMS Provider Settings panel in the administrative console to update the WebSphere MQ resource adapter on any nodes in your environment, it is possible that you are experiencing the issue described in APAR PM10308.



In this information ...


Related reference

IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 20, 2010 11:50:58 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-base-iseries&topic=tmj_wmqra_restoredefault
File name: tmj_wmqra_restoredefault.html


[jun2010]
jun2010