Installing, Upgrading, and Uninstalling the Adapter for MSMQ

Overview

This chapter explains how to install, upgrade, and uninstall IBM webMethods Adapter for MSMQ 6.0. The instructions use the IBM webMethods Installer and the IBM webMethods Uninstaller wizards. For complete information about the wizards or other installation methods, or to install other webMethods products, see Installing IBM webMethods Products On Premises for your release.

Requirements

For a list of the operating systems, MSMQ products, and webMethods products supported by Adapter for MSMQ 6.0, see the IBM webMethods Adapters System Requirements.

Adapter for MSMQ 6.0 has no hardware requirements beyond those of its host Integration Server.

Installing Adapter for MSMQ 6.0

About this task

Note: If you are installing Adapter for MSMQ in a clustered environment, you must install the adapter 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 Adapter for MSMQ in a Clustered Environment.

To install Adapter for MSMQ 6.0 :

Procedure

  1. Download Installer.
  2. If you are installing the adapter on an existing Integration Server, shut down Integration Server.
  3. Start the Installer wizard.
    1. Choose the webMethods release that includes the Integration Server on which to install the adapter. For example, if you want to install the adapter on Integration Server 7.1, choose the 7.1 release.
    2. 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. Installer will install the adapter in the Integration Server_directory\packages directory.
    3. In the product selection list, select Adapters > webMethods MSMQ Adapter 6.0 . You can also choose to install documentation.
  4. After installation is complete, start the host Integration Server.

Upgrading to Adapter for MSMQ 6.0

You cannot upgrade to Adapter for MSMQ 6.0 from earlier versions of the adapter.

Uninstalling Adapter for MSMQ 6.0

About this task

To uninstall Adapter for MSMQ

Procedure

  1. Shut down the Integration Server that hosts Adapter for MSMQ.
  2. IBM webMethods Uninstaller will not delete any user-defined Adapter for MSMQ 6.0 components such as connections and adapter services. Because these components will not work without the adapter, delete them manually from either at the file system level or using IBM webMethods Designer. For instructions, see the IBM webMethods Service Development Help for your release.
  3. Start Uninstaller, selecting the webMethods installation directory that contains the host Integration Server. In the product selection list, select Adapters > webMethods MSMQ Adapter 6.0 . You can also choose to uninstall documentation.
  4. Restart the host Integration Server.
  5. Uninstaller removes all Adapter for MSMQ 6.0 related files that were installed into the Integration Server_directory\packages\WmMSMQAdapter directory. However, Uninstaller does not delete files created after you installed the adapter (for example, user-created or configuration files), nor does it delete the adapter directory structure. You can go to the Integration Server_directory\packages directory and delete the WmMSMQAdapter directory.