How to install the BizTalk Adapter for MSMQ in BizTalk Server 2004 when MSMQT is installed or when the MSMQC Adapter sample is installed (895867)


The information in this article applies to:

  • Microsoft BizTalk Server 2004 Developer Edition
  • Microsoft BizTalk Server 2004 Enterprise Edition
  • Microsoft BizTalk Server 2004 Partner Edition
  • Microsoft BizTalk Server 2004 Standard Edition
Important This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry

INTRODUCTION

This article describes how to install the Microsoft BizTalk Adapter for MSMQ in a scenario where one of the following conditions is true:Note This article contains information that is different from the information that appears in the BizTalk Adapter for MSMQ Installation Guide. The BizTalk Adapter for MSMQ Installation Guide incorrectly states that you must remove the BizTalk Message Queuing Adapter to install the BizTalk Adapter for MSMQ.

MORE INFORMATION

You can use the BizTalk Adapter for MSMQ and the BizTalk Message Queuing Adapter on the same computer. However, because both these adapters use the same port, you must add an IP address to your computer that the BizTalk Adapter for MSMQ can use.

Important If you have the BizTalk Message Queuing Adapter installed, you must configure this additional IP address before you install the BizTalk Adapter for MSMQ.

Incorrect procedure for installing the BizTalk Adapter for MSMQ

The following incorrect procedure for installing the BizTalk Adapter for MSMQ is contained in the BizTalk Adapter for MSMQ Installation Guide. This incorrect procedure appears under the "To remove MSMQT and restart the BizTalk host instance" heading:
  1. Click Start, point to Programs, point to Microsoft BizTalk Server 2004, and then click BizTalk Server Administration.
  2. In the BizTalk Server Administration console, double-click the Microsoft BizTalk 2004 (Local) node.
  3. Click Adapters in the left pane.
  4. Right-click MSMQT in the right pane and then click Delete.
  5. Click OK.
  6. In the left pane, expand Hosts and select BizTalkServerApplication in the left pane.
  7. In the right pane, right-click the host instance (usually the computer name), and then click Stop.
  8. In the right pane, right-click the host instance, and then click Start.
The following sections contain the correct procedure for installing the BizTalk Adapter for MSMQ.

Correct procedure for installing the BizTalk Adapter for MSMQ when the BizTalk Message Queuing Adapter is already installed

Warning If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

To configure a computer to run the BizTalk Adapter for MSMQ when the BizTalk Message Queuing Adapter is already installed, follow these steps:
  1. Configure an additional static IP address on the network adapter that is installed in the computer.

    Note Instead of assigning an additional IP address to an existing network adapter, you can install an additional network adapter in the computer.
  2. Create a host record in the Domain Name System (DNS) for this new IP address. Make sure that you assign a name that clearly identifies this DNS entry. For example, name the entry MSMQServer.

    Note A host record is also known as an "A record." For more information about how to manage resource records in the DNS, visit the following Microsoft Web site:

    http://technet2.microsoft.com/windowsserver/en/library/CB7A2363-0ED6-4C7C-87BA-7CC9592A80281033.mspx

  3. Install Message Queuing on the computer.

    Note Message Queuing is also known as MSMQ.
  4. Use Registry Editor to create the following new registry string value:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parameters

    Value name: BindInterfaceIP
    Value type: REG_SZ
    Value data: IP address

    Note Replace IP address with the new IP address that you configured in step 1.

  5. Quit Registry Editor.
  6. Reconfigure BizTalk Server to use the new DNS host name that you created in step 2 as the computer name. Then, reconfigure BizTalk Server to use the IP address that you configured in step 1 as the IP address. To do this, follow these steps:
    1. Click Start, click Run, type the following command, and then click OK:

      "%programfiles%\Microsoft biztalk server 2004\configframework.exe" /u

    2. Click Start, click Run, type the following command, and then click OK:

      "%programfiles%\Microsoft biztalk server 2004\configframework.exe"

    3. Follow the steps in the Microsoft BizTalk Server 2004 Configuration Wizard to configure your BizTalk Server installation. On the BizTalk Messaging page of the Microsoft BizTalk Server 2004 Configuration Wizard, click Bind to this IP address only. Then, type the IP address that you configured in step 1.
    4. In the Computer name box, type the new host name that you configured in step 2.

      Note Do not click to select the Register computer in Domain Name System check box.
    5. Click Next, and then follow the remaining steps to configure your BizTalk Server installation.
    For more information, click the following article number to view the article in the Microsoft Knowledge Base:

    836487 BizTalk Message Queuing configuration options cannot be changed after initial setup

  7. Install the BizTalk Adapter for MSMQ.
  8. If you want to use both the BizTalk Adapter for MSMQ and the BizTalk Message Queuing Adapter on the same computer, you must add the BizTalk Message Queuing Adapter back to the adapter list in the BizTalk Administration console.

Correct procedure for installing the BizTalk Adapter for MSMQ when the BizTalk MSMQC Adapter sample is already installed

The BizTalk MSMQC Adapter sample is a sample Message Queuing transport that is available in the BizTalk Server 2004 Software Development Kit (SDK) folder for BizTalk Server 2004. If you already installed the MSMQC Adapter sample, follow these steps before you install the BizTalk Adapter for MSMQ:
  1. Start SQL Server Enterprise Manager.
  2. Expand Microsoft SQL Servers, expand SQL Server Group, and then expand the computer that is running an instance of SQL Server. Expand Databases, expand BizTalkMgmtDb, and then click Tables.
  3. Open the adm_Adapter table in the BizTalkMgmtDb database that BizTalk Server is using.
  4. Locate the row where MSMQ appears as the value in the Name column.
  5. In this row, remove the value in the InboundAssemblyPath column. This value is typically the following value:

    C:\Program Files\Microsoft BizTalk Server 2004\SDK\Samples\Adapters\MSMQCAdapter\Run-Time\MSMQC\bin\Debug\Microsoft.Samples.BizTalk.Adapters.MSMQC.Runtime.dll

  6. In this row, remove the value in the OutboundAssemblyPath column.

    Note You do not have to remove this value unless you want the Send ports to work correctly.
  7. Close the table, and then restart the BizTalk Server host instance.

REFERENCES

For more information about how to configure the BizTalk Message Queuing Adapter, visit the following Microsoft Web site:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/deploying/htm/ebiz_depl_config_dbrf.asp

For more information about the BizTalk Adapter for MSMQ, visit the following Microsoft Web site:

http://www.microsoft.com/biztalk/evaluation/adapter/adapters/msmq/2004/default.asp

Modification Type:MajorLast Reviewed:6/21/2006
Keywords:kbDeployment kbhowto kbsetup kbBTSAdapters kbinfo KB895867 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.