How To How to Cluster Microsoft BizTalk Adapter for MQSeries on Windows 2000 Advanced Server (315601)

SUMMARY

You can configure Microsoft BizTalk Adapter for MQSeries in an active/passive cluster environment with Microsoft BizTalk Server.

back to the top

Install BizTalk Adapter for MQSeries on the Cluster Nodes

You have to install BizTalk Adapter for MQSeries on each BizTalk server node that is in the cluster. To install the adapter on the first node in the cluster:

1. Make the computer (on which you are going to install BizTalk Server) the owner of the BizTalk Messaging Group resources. If there is more than one resource group, use the resource group that contains MSDTC.
2. Start Cluster Administrator, and then move the BizTalk Messaging Group to the first node.
3. Use the installation CD-ROM to install BizTalk Adapter for MQSeries on the first node. Repeat steps 1 through 3 to install BizTalk Adapter for MQSeries on each node.

back to the top

Add a Cluster Resource for BizTalk Adapter for MQSeries Service (MTBSvc)

1. Within the existing cluster group, create a BizTalk Adapter for MQSeries resource and make it a generic service.
2. Make each node a possible owner. Set up the BizTalk servers in an active/passive cluster.
3. Set the resource to run in its own Resource Monitor.
4. You need to set one dependency for the BizTalk Messaging Service.
5. Leave the default advanced parameters; however, set the Restart selection to Do not restart.
6. On the Parameters tab, type MTBSvc as the service name, and then type the path to the .exe program file in the Start Parameters box. For example, C:\PROGRA~1\MID263~1\MTBSvc.exe. By default, the adapter files on the hard disk are in the C:\Program Files\Microsoft BizTalk Adapter for MQSeries\ folder. Click to select the Use Network Name for computer name check box.
7. Replicate the following registry key:System\CurrentControlSet\Services\MTBSvc
8. Set up both computers identically.
9. Set both of the BizTalk Adapter for MQSeries services within the actual Windows 2000 services to start manually and set the services to use the BizTalk administrative account to run (this is the main account that runs all BizTalk-oriented services).
10. When one node has control over the BizTalk Adapter for MQSeries resource, the Control Panel service is running. If you fail over to the second node, the service on the first node stops while the service on the second node starts automatically.

back to the top

Troubleshooting

When you try to bring the clustered BizTalk Adapter for MQSeries service online, you may receive the following error message:

Event Type: Error 
Event Source: MTBSvc 
Event Category: None 
Event ID: 10 
Computer: BIZTALKSERVER 
Description: Failed to get service parameters. The error code is stored in Data. The service will be stopped. 

This error occurs if a valid MQSeries Queue Manager is not configured for the BizTalk Adapter for MQSeries service. To create a valid MQSeries Queue Manager for the BizTalk Adapter for MQSeries service, follow these steps to configure BizTalk Server to send to the MQSeries server:

1. Create a local queue in MQSeries to receive documents from BizTalk Server. In this example, the local queue is named FROMBTSTOMQSERIES.
2. Create a BizTalk port in the Messaging Manager. When you create this port, do the following:
   1. In the Messaging Port Wizard, select Organization.
   2. In the Transport type list, select AIC.
   3. In the Select a component dialog box, select the AICMQ AIC component from the list of available components.
3. Use the Channel Wizard to create a channel for the port. When you reach the end of the Channel Wizard, click Advanced to access the Override Messaging Port Defaults dialog box.
4. In the Override Messaging Port Defaults dialog box, click Properties.
5. In the AICMQ MQPipeline Properties dialog box, type the following information:
   • Servername - The NetBIOS name of the MQ Series computer (for example, testbox01).
   • Queue Manager - The name of the queue manager that you are using to hold the queue (for example, QM_testbox01).
   • MQ Series Queue Name - The name of the local queue that you created (in this example, the name of the queue is FROMBTSTOMQSERIES).
6. Start the DirectIntegration SDK sample to send a message to the channel that you just created. Verify that the message has arrived in the destination MQSeries local queue by double-clicking the queue in the MQSeries Queue Manager.

back to the top

REFERENCES

For additional information about how to set up and configure BizTalk Server in an active/passive cluster environment, click the article number below to view the article in the Microsoft Knowledge Base: For additional information about how to Cluster an MQHelper COM+ Application on an MQSeries Cluster, click the following article number to view the article in the Microsoft Knowledge Base: For additional informationabout how to set up and test the BizTalk Adapter for MQSeries, click the following article number to view the article in the Microsoft Knowledge Base: back to the top