Certification instructions for installing IBM-MQ 8 and 9 clients in Karaf

We should agree on the instructions/certification for installing IBM MQ (former WebSphereMQ) 8 and 9 clients so DOC team could create instructions.

As described in Persistence Guide, here is the link for IBM MQ clients version 8 and 9. The persistence guide explains that just downloading the JAVA ALL client from the web page isn't enough to install client into Karaf, because the OSGi clients contains several jars that collide with Karaf's jars.

There are at least 3 options how to get it working:

1. Deploy several jars from IBMMQ Server into Karaf - Instructions
2. Unzip -IBM-MQ-Install-Java-All.jar, remove *Require-Bundle = com.ibm.mq.osgi.allclientprereqs;visibility:=reexport header from MANIFEST.MF located in com.ibm.mq.osgi.allclient_.jar* and deploy the modified allclient into karaf
3. Install an empty bundle with com.ibm.mq.osgi.allclientprereqs symbolic name and then deploy the unmodified com.ibm.mq.osgi.allclient_.jar* into Karaf

FUSE QE tried #1 and #2 steps successfully. However, #1 needs to download the correct version of IBM-MQ Server and extract the right libraries from it and then deploy it into Karaf. QE found only IBMMQ 8 server that contains only 8.0.0.4 clients and the newest IBM MQ client is of version 8.0.0.9.

What instruction will we recommend customers?