Microsoft KB Archive/326635

= How To Cluster an MQHelper COM+ Application on an MQSeries Cluster =

Article ID: 326635

Article Last Modified on 6/29/2004

-

APPLIES TO


 * Microsoft BizTalk Adapter for MQSeries 1.0 Enterprise Edition

-



This article was previously published under Q326635



SUMMARY
If the BizTalk Adapter for MQSeries must perform an interchange with a clustered MQSeries Server, you must add the MQSeries Adapter MQHelper component as a resource to the cluster group that contains the clustered MQSeries Server resources. You must add MQHelper so that the BizTalk Adapter for MQSeries can communicate with the virtual MQSeries server.



MORE INFORMATION
To cluster the MQHelper COM+ application, follow these steps:  Make the computer on which you are going to install BizTalk Adapter for MQSeries the owner of the MQSeries group resources. If more than one resource group exists, use the resource group that contains Microsoft Distributed Transaction Coordinator (MS DTC). Install the BizTalk Adapter for MQSeries on both nodes of the MQSeries cluster. On the first node in the cluster, do the following:  Log on to the node. Click Start, point to Programs, point to Administrative Tools, and then click Component Services to start the Component Services administrative interface. Expand the Component Services snap-in, and then locate COM+ Applications. Right-click the BizTalk Adapter for MQSeries COM+ application, and then click Properties.</li> In the Properties dialog box, click the Advanced tab, click to clear the check boxes for the following options, and then click OK: <ul> Disable deletion</li> Disable Changes</li></ul> </li></ol> </li> Repeat step 3 on the second node in the cluster.</li> On the first node in the cluster, do the following: <ol style="list-style-type: lower-alpha;"> Log on to the node.</li> Click Start, point to Programs, point to Administrative Tools, and then click Component Services to start the Component Services administrative interface.</li> Expand the Component Services snap-in, and then locate COM+ Applications.</li> Right-click the BizTalk Adapter for MQSeries COM+ application, and then click Properties.</li> In the Properties dialog box, click the Advanced tab.</li> Under Server Process Shutdown, click to select the check box for Leave running when idle, and then click OK.</li></ol>

You must select this option to prevent the clustered BizTalk Adapter for MQSeries COM+ application from failing when this COM+ application is idle.

You only have to do this step on the first node in the cluster because this setting will be migrated to the second node in the cluster later.</li> Verify that the Identity for the BizTalk Adapter for MQSeries COM+ application on the first node is set to the same credentials that the Cluster service is configured to log on as.

You only have to do this step on the first node in the cluster because this setting will be migrated to the second node in the cluster later.</li> On the first node in the cluster, export the BizTalk Adapter for MQSeries COM+ application to a Microsoft Windows Installer (.msi) file as a server application. To do this, follow these steps: <ol style="list-style-type: lower-alpha;"> Right-click the BizTalk Adapter for MQSeries COM+ application, click Export, and then click Next.</li> Locate the folder where you want to save the .msi file. Type a name for the file (such as MQAdapter ). Click Save.</li> <li>Under Export as, click Server application, and then click Next.</li> <li>If the export process is completed successfully, a dialog box appears that contains the following message:

Thank you for using the COM Application Export Wizard

Click Finish.</li></ol> </li> <li>Remove the BizTalk Adapter for MQSeries COM+ application that is installed on the second node in the cluster.</li> <li>Import the BizTalk Adapter for MQSeries COM+ application from the first node in the cluster to the second node in the cluster. To do this, follow these steps: <ol style="list-style-type: lower-alpha;"> <li>In the Component Services MMC interface, locate COM+ Applications.</li> <li>Right-click COM+ Applications, click New, and then click Application.</li> <li>On the first page of the COM Application Install Wizard, click Next, and then click Install pre-built application(s).</li> <li>Locate the .msi file that you exported from the first node, click the file, and then click Open. Click Next.</li> <li>Type the User name and the Password for the account that the Cluster service is configured to Log On as. Click Next.</li> <li>Click Specific Directory. Locate the directory on this node where the BizTalk Adapter for MQSeries is installed (typically, this is Program Files\Microsoft BizTalk Adapter for MQSeries), and then click Next.</li> <li>A dialog box appears that contains the following message:

The following files already exist. Overwrite these files?

Click OK.</li> <li>If the import process is completed successfully, a dialog box appears that contains the following message:

Thank you for using the COM Application Install Wizard

Click Finish.</li></ol> </li> <li>Add MQHelper as a resource to the MQSeries group: <ol style="list-style-type: lower-alpha;"> <li>In the Cluster Administrator application, click the MQSeries group.</li> <li>On the File menu, point to New, and then click Resource. The New Resource window appears.</li> <li>In the Name box, type MQHelper. In the Resource type list, select Generic Application. Click Next. The Possible Owners window appears.</li> <li>Include every computer on the cluster as a possible resource owner.</li> <li>In the list, select the IBM MQSeries Service, Network Name, and Shared Disk resource dependencies.</li> <li>Click Next. The Generic Application Parameters window appears.</li> <li>In the Command line box, type dllhost.exe /ProcessId:{ }, where  is the application ID of the BizTalk Adapter for MQSeries COM+ application. You can copy it from the COM+ MMC and replace it in the command. You must use the braces ({}) in the command.</li> <li>In the Current directory box, type the root directory of the shared disk resource drive in the group.</li> <li>Select Allow application to interact with desktop and Use Network Name for computer name. Click Next.</li> <li>In the Registry Replication window, click Finish.</li> <li>After the resource has been added to the MQSeries group, right-click MQHelper, and then click Properties. On the Advanced tab, click to clear the Affect the Group check box, and then click to select the Do not restart check box.</li> <li>Bring the MQHelper resource online.

Note You may receive an error message similar to the following when you try to bring the MQHelper resource online:

The DLL could not be loaded. Check to make sure all required application runtime files and other dependent DLLs are available in the component DLL's directory or the system path.

To resolve this problem, register MTBWorker.dll. MTBWorker.dll is located in the \Program Files\Microsoft BizTalk Adapter for MQSeries\MTBWorker.dll folder.

Note This resolution requires that you have Regsvr32.exe installed on your computer. For additional information about how to obtain Regsvr32.exe, click the article number below to view the article in the Microsoft Knowledge Base:

267279 ACC2000: Regsvr32.exe Available in Download Center

To register MTBWorker.dll, click Run on the Start menu, and then type Regsvr32 [/u] [/s], where: <ul> <li>/u unregisters the file, based on the  argument.</li> <li>/s registers the file in silent mode. Silent mode suppresses all messages.</li> <li> is the complete path and file name that you want to unregister or register.</li></ul> </li></ol> </li></ol>

<div class="references_section">