Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer Messaging resources > Manage messaging with the WebSphere MQ messaging provider > Install WebSphere MQ to interoperate with WAS > Maintain the WebSphere MQ resource adapter

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

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

Updates to the WebSphere MQ version 7 resource adapter that is installed with the application server are included in WAS Fix Packs. You should only update the WebSphere MQ version 7 resource adapter using the "Update resource adapter facility if you require a specific version of the resource adapter, instead of the most recent version.

To install a specific version of the resource adapter, see Install a specific maintenance level of the WebSphere MQ resource adapter.

You can use the following Jython and Jacl commands to determine the level of the WebSphere MQ resource adapter currently being used by WAS:

• Jython:

  You need to press Return twice after entering this command in order to run it.

  wmqInfoMBeansUnsplit = AdminControl.queryNames("WebSphere:type=WMQInfo,*")
  wmqInfoMBeansSplit = AdminUtilities.convertToList(wmqInfoMBeansUnsplit)
  for wmqInfoMBean in wmqInfoMBeansSplit: print wmqInfoMBean; print AdminControl.invoke(wmqInfoMBean, 'getInfo', '')
  

• Jacl:

  set wmqInfoMBeans [$AdminControl queryNames WebSphere:type=WMQInfo,*]
  foreach wmqInfoMBean $wmqInfoMBeans {
  puts $wmqInfoMBean;
  puts [$AdminControl invoke $wmqInfoMBean getInfo [] []]
  }
  

Use this task if any of the following circumstances apply to the configuration, and to configure all servers in your environment to use the latest version of the WebSphere MQ resource adapter:

• The JVM logs of any application server in the 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 resource adapter that is now superseded by the latest version of the resource adapter contained in the current WAS maintenance level.

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

Procedure

1. Start the application server. If the profile is part of a network deployment configuration, start the dmgr and all node agents. If the profile contains an admin agent, start the admin agent.
2. 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") or
         (desc == "WAS 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 

3. Use wsadmin.sh to run the Jython script that we have just created.

   Open a command prompt and navigate to the $PROFILE_ROOT/bin directory, then run:

   wsadmin -lang jython -f convertWMQRA.py
   

   If you run the script against a profile that is part of a network deployment configuration, the script updates all profiles that need updating in that configuration.

4. If you are running in a network deployment configuration, ensure that the node agents are fully re-synchronized.

   See Synchronize nodes using wsadmin.sh or Manage nodes.

5. Stop all servers in the profile. If the profile is part of a network deployment configuration, also stop any cluster members in the configuration, stop all node agents in the configuration, and stop the dmgr. If the profile contains an admin agent, stop the administrative agent.
6. Run the osgiCfgInit command from the PROFILE_ROOT/bin directory. If the profile is part of a network deployment configuration, run the osgiCfgInit command from the PROFILE_ROOT/bin directory of every profile that is part of the configuration.

   The osgiCfgInit command resets the class cache used by the OSGi runtime environment.

7. Restart all servers in the profile. If the profile is part of a network deployment configuration, also restart any cluster members in the configuration, restart all node agents in the configuration, and restart the dmgr. If the profile contains an admin agent, restart the administrative agent.

What to do next

If you continue to experience problems after performing the steps described in this topic, and we 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 the environment, it is possible that you are experiencing the issue described in APAR PM10308.
Synchronize nodes using wsadmin.sh
Manage nodes

Related

JMS provider settings

+

Search Tips   |   Advanced Search