Title Page

webMethods MSMQ Adapter Installation Guide

Version 6.0

April 2010
Copyright & Document ID
This document applies to webMethods MSMQ Adapter Version 6.0 and to all subsequent releases. Specifications contained herein are subject to change and these changes will be reported in subsequent release notes or new editions. Copyright 20012010 Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, United States of America, and/or their licensors. The name Software AG, webMethods, and all Software AG product names are either trademarks or registered trademarks of Software AG and/or Software AG USA, Inc. and/or their licensors. Other company and product names mentioned herein may be trademarks of their respective owners. Use of this software is subject to adherence to Software AGs licensing conditions and terms. These terms are part of the product documentation, located at http://documentation.softwareag.com/legal/ and/or in the root installation directory of the licensed product(s). This software may include portions of third-party products. For third-party copyright notices and license terms, please refer to "License Texts, Copyright Notices and Disclaimers of Third Party Products." This document is part of the product documentation, located at http://documentation.softwareag.com/legal/ and/or in the root installation directory of the licensed product(s).
Document ID: ADAPTER-MSMQ-IG-60-20100430

Contents

Overview. Requirements. Installing MSMQ Adapter 6.0. Upgrading to MSMQ Adapter 6.0. Uninstalling MSMQ Adapter 6.0. 4

Overview

This guide, in conjunction with the Software AG Installation Guide, explains how to install, upgrade, and uninstall webMethods MSMQ Adapter 6.0. If you are installing the adapter with webMethods Integration Server (prerequisite) or other webMethods products, this webMethods MSMQ Adapter Installation Guide refers to the Software AG Installation Guide, but you should use the correct installation guide as follows: If you are installing the adapter with webMethods 8 products, refer to the Software AG Installation Guide for instructions. If you are installing the adapter with previous versions of webMethods products, refer to the webMethods Installation Guide for instructions.

Requirements

For a list of the operating systems, MSMQ products, and webMethods products supported by MSMQ Adapter 6.0, see the webMethods Adapters System Requirements. MSMQ Adapter 6.0 has no hardware requirements beyond those of its host Integration Server.
Installing MSMQ Adapter 6.0
The instructions in this section are meant to be used with the more complete instructions in the Software AG Installation Guide. The instructions explain how to use the Software AG Installer wizard. Note: If you are installing the MSMQ Adapter 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 the webMethods MSMQ Adapter Users Guide.
webMethods MSMQ Adapter Installation Guide Version 6.0
To install MSMQ Adapter 6.Download the Installer from the Empower Product Support Web site. If you are installing the adapter on an existing Integration Server, shut down the Integration Server. Start the Installer wizard. a 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. 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. The Installer will install the adapter in the Integration Server_directory\packages directory. In the product selection list, select Adapters > webMethods MSMQ Adapter 6.0. You can also choose to install documentation.
After installation is complete, start the host Integration Server.
Upgrading to MSMQ Adapter 6.0
You cannot upgrade to MSMQ Adapter 6.0 from earlier versions of the adapter.

Uninstalling MSMQ Adapter 6.0
The instructions in this section are meant to be used with the uninstallation instructions in the Software AG Installation Guide. To uninstall the MSMQ Adapter Shut down the Integration Server that hosts the MSMQ Adapter. The Software AG Uninstaller will not delete any user-defined MSMQ Adapter 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 Developer or Designer. For instructions, see the webMethods Designer Online Help or the appropriate Developer user's guide for your release as indicated in the webMethods MSMQ Adapter Users Guide. Start the 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. Restart the host Integration Server.
The Uninstaller removes all MSMQ Adapter 6.0 related files that were installed into the Integration Server_directory\packages\WmMSMQAdapter directory. However, the 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.