WebSphere MQ Adapter 6.5 | webMethods WebSphere MQ Adapter Documentation | webMethods WebSphere MQ Adapter Installation and User’s Guide Documentation | Installing, Upgrading, and Uninstalling WebSphere MQ Adapter | Installing WebSphere MQ Adapter 6.5
 
Installing WebSphere MQ Adapter 6.5
The instructions in this section explain how to use the Software AG Installer wizard to install the WebSphere MQ Adapter. To install the adapter on AS/400, you must use Installer's console mode. For more information, see the Installing webMethods Products On Premises for your release.
Note:
If you are installing the adapter in a clustered environment, you must install it on each Integration Server in the cluster, and each installation must be identical. For more information about working with the adapter in a clustered environment, see WebSphere MQ Adapter in a Clustered Environment.
*To install WebSphere MQ Adapter 6.5
1. Download Software AG Installer from the Empower Product Support website.
2. If you are installing the adapter on an existing Integration Server, shut down the Integration Server.
3. Start the Installer wizard.
4. Choose the webMethods release that includes the Integration Server on which to install the adapter.
5. Specify the installation directory as follows:
*If you are installing on an existing Integration Server, specify the webMethods installation directory that contains the host Integration Server.
*If you are installing both the host Integration Server and the adapter, specify the installation directory to use.
6. In the product selection list, select Adapters >webMethods WebSphere MQ Adapter6.5.
If you are using Integration Server 9.6 and above, you can choose to install the package in the default instance. In this case, Software AG Installer installs the adapter in both locations, Integration Server_directory \packages and the default instance packages directory located in Integration Server_directory \instances\default\packages.
7. To download the documentation for the adapter, go to Software AG Documentation website.
8. If you installed on a Windows system, add the mqjbndnn.dll file to the path system environment variable using one of the methods below:
*Add the WebSphereMQ_directory\java\lib directory to your path system environment variable, where WebSphereMQ_directory is the directory in which you installed the WebSphere MQ Server.
*If the WebSphere MQ Adapter is installed on a remote machine, go to the WebSphereMQ_directory\java\lib directory and copy the mqjbndnn.dll file into a local directory that is in your path system environment variable, where nn is the version number of the .dll file.
9. Copy or provide the location to the WebSphere MQ client .jar files to the host Integration Server. The adapter requires these files to connect to the IBM WebSphere MQ server.
Important:
If you do not copy the MQ client .jar files to Integration Server, the WebSphere MQ Adapter fails to register itself with the webMethods Adapter Runtime (WmART) and the WebSphere MQ Adapter link will not appear under the Adapters panel in the Integration Server Administrator page.
*Copy the com.ibm.mq.jar file in the WebSphereMQ_directory\java\lib directory to the Integration Server_directory \instances\instance_name\packages\WmMQAdapter\code\jars directory.
*Copy the jar file for your corresponding WebSphere MQ version:
*For WebSphere MQ 5.x: Copy WebSphereMQ_directory\java\lib\com.ibm.mq.pcf.jar to Integration Server_directory \instances\instance_name\packages\WmMQAdapter\code\jars. This jar file is available when you install the PCF Support Pack (WebSphere MQ Java classes for PCF), available from the IBM Support site.
*For WebSphere MQ 6.0: Copy WebSphereMQ_directory\eclipse\plugins\com.ibm.mq.pcf_6.0.0\pcf.jar to Integration Server_directory \instances\instance_name\packages\WmMQAdapter\code\jars
This jar file is available when you have MQ Explorer installed.
*For WebSphere MQ 7.x: Copy the com.ibm.mq.commonservices.jar, com.ibm.mq.headers.jar, com.ibm.mq.pcf.jar, and com.ibm.mq.jmqi.jar from WebSphereMQ_directory\java\lib to Integration Server_directory \instances\instance_name\packages\WmMQAdapter\code\jars.
*For WebSphere MQ 8.x: Copy the com.ibm.mq.commonservices.jar, com.ibm.mq.headers.jar, com.ibm.mq.pcf.jar, com.ibm.mq.jar, and com.ibm.mq.jmqi.jar from WebSphereMQ_directory\java\lib to Integration Server_directory \instances\instance_name\packages\WmMQAdapter\code\jars.
*For WebSphere MQ 9.x: Copy the com.ibm.mq.commonservices.jar, com.ibm.mq.headers.jar, com.ibm.mq.pcf.jar, com.ibm.mq.jar, and com.ibm.mq.jmqi.jar from WebSphereMQ_directory\java\lib to Integration Server_directory \instances\instance_name\packages\WmMQAdapter\code\jars.
*Create a symbolic link in Integration Server pointing to the location of the jar files present in your WebSphere MQ client.
*Specify the directory paths of the jar files present in your WebSphere MQ Client, in the host Integration Server classpath.
These jar files are available when you have MQ Client installed.
10. Start the host Integration Server.
11. If you are going to use the adapter with Integration Server 8.0, apply fix MQS_6.5_8.0_Fix1 or later.
Installing this fix provides support for pagination when viewing lists of the adapter's connections, listeners, and notifications and also enables you to sort and filter the lists. For more information about controlling pagination, sorting, and filtering when viewing the adapter information, see Controlling Pagination.