How to Enlist an Orchestration

This topic describes how to use the BizTalk Server Administration console to enlist an orchestration into a host. The orchestration must be enlisted before you can start it.

When enlisting an orchestration, bear in mind the following points:

• The orchestration must be bound before you can enlist it. For instructions on configuring bindings for orchestrations, see How to Configure Bindings for an Orchestration.

• Subscriptions are automatically created. The orchestration enlistment process creates the necessary subscriptions in the MessageBox database.

• You must install the application. You must install the application containing the orchestration on all of computers where the orchestration will run. For more information, see How to Install a BizTalk Application.

• A calling orchestration must be bound to the same host as the called orchestration. Any orchestration that is called by another orchestration must be bound to the same host as the calling orchestration.

• You should also enlist dependent orchestrations. If you enlist an orchestration but do not enlist any dependent orchestrations, the dependent orchestrations will not have any subscriptions. A dependent orchestration without subscriptions may drop or suspend messages because there is no subscription for the messages to match.

Note

The application developer can enlist an orchestration to test its functionality during the development process by using the procedure in this topic.

Prerequisites

To perform the procedure in this topic, you must be logged on with an account that is a member of the BizTalk Server Administrators group. For more detailed information on permissions, see Permissions Required for Deploying and Managing a BizTalk Application.

To enlist an orchestration

1. Click Start, click Programs, click Microsoft BizTalk Server 20xx, and then click BizTalk Server Administration.

2. In the console tree, expand BizTalk Server Administration, expand the BizTalk group, expand Applications, and then expand the application containing the orchestration that you want to enlist.

3. Click Orchestrations, right-click the orchestration to enlist, and then click Enlist.

   Note

   To enlist multiple orchestrations at once, hold down the shift key and select each orchestration to enlist, right-click an orchestration, and then click Enlist.

   The orchestration is enlisted and the appropriate subscriptions are created. The orchestration is in the stopped state. To start processing incoming messages, you must explicitly start the orchestration by right-clicking it and clicking Start. For more information, see How to Start an Orchestration.

See Also

Managing Orchestrations
How to Unenlist an Orchestration