Obtaining the IBM MQ Resource Adapter for the WebSphere Application Server Liberty Profile

Resolving The Problem

The MQ Resource Adapter v7.5 supports JCA v1.5 and provides JMS 1.1 support. To provide full integration with WebSphere Application Server Liberty Profile the MQ 7.5 Resource Adapter has been updated to APAR IC92914. This resource adapter retains full compatibility with other JavaEE 1.5 and later application servers.

See "WebSphere MQ resource adapter v7.1 and later statement of support"

+ JavaEE 1.7
The IBM MQ Resource Adapter v8.0 and v9.0 supports JCA v1.7 and provides JMS 2.0 support.
This needs to be deployed within a JavaEE 1.7 and later application server.

See "IBM MQ resource adapter v8.0 statement of support" and "IBM MQ resource adapter v9.0 statement of support"

+ JavaEE 1.8
The IBM MQ Resource Adapter 9.2, 9.3 and 9.4 work supports JCA v1.8.
This needs to be deployed within a JavaEE 1.7 and later application server.

++ Download

++ Installation

See tutorial:

https://www.ibm.com/support/pages/node/6202719
Download, install and test IBM-MQ-Install-Java-All (com.ibm.mq.allclient.jar) and IBM-MQ-Java-InstallRA (wmq.jmsra.rar)  

++ Liberty Configuration

+ See example:
https://www.ibm.com/support/pages/node/7028184
Deploying IBM MQ IVT wmq.jmsra.ivt.ear in WebSphere Liberty Profile (WLP) in Linux RHEL

+ Jakarta Messaging 3.0 (aka JMS 3.0)
The "wmqMessagingClient-3.0" feature is required.

+ Older details (JMS 1.1):

Details of the Liberty configuration should be checked in the WebSphere Application Server Product Documentation. In summary, an additional feature is added (wmqJmsClient-1.1 or wmqJmsClient-2.0), and reference to the wmq.jmsra.rar file is added. For example, a configuration to support servlets and MDBs, with JNDI, might look like this:

<featureManager>
          <feature>wmqJmsClient-1.1</feature>

<feature>servlet-3.0</feature>
<feature>jmsMdb-3.1</feature>
<feature>jndi-1.0</feature>

</featureManager>

   <variable name="wmqJmsClient.rar.location"        
              value="H:\Liberty\WMQ\wmq\wmq.jmsra.rar"/>

For Liberty versions up to v8.5.5.1, if an EJB is deployed using solely the configuration within the ejb-jar.xml, the version of WebSphere Application Server that the Liberty Profile is using must have APAR PM89890 applied. This method of configuration is used for the Resource Adapter's installation verification program (IVT), so this APAR is required in order for the IVT to run.

++ Platform Support

In addition to the platform support defined by the MQ System Requirements, the WebSphere Application Server Liberty profile includes platform support for Mac OS X. Therefore use of the resource adapter within the Liberty profile on Mac OS X is tolerated. Outside of the Liberty Profile, the platform support for the IBM MQ Resource Adapter is unchanged.