You receive an "Orchestration enlistment failed" error message when you enlist an orchestration on a BizTalk Server 2004 server (839451)



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

SYMPTOMS

When you use Microsoft BizTalk Server 2004 to enlist an orchestration on a server that only has the Microsoft BizTalk Server 2004 Administration Tools installed, you may receive the following error message:

Orchestration enlistment failed due to an error in loading the corresponding .NET assembly. .NET assembly "AssemblyName, Version=1.0.0.0, Culture=neutral, PublicKeyToken=Token" could not be loaded.

Make sure this .NET assembly and any other .NET assemblies it references have been installed into the global assembly cache (GAC) on this machine (by running Gacutil.exe).
Note In this error message, AssemblyName is a placeholder for the actual assembly name that is referenced.

CAUSE

This issue may occur if all the following conditions are true:
  • You only install the BizTalk Server 2004 Administrative Tools on the server.
  • You use the BizTalk Deployment Wizard to deploy a Microsoft .NET assembly, and then you choose not to install the assembly in the Global Assembly Cache (GAC) in the Deployment Wizard.
  • You try to enlist a BizTalk orchestration.
To enlist an orchestration in BizTalk Server 2004, the associated .NET assembly must be in the GAC. This behavior is by design in BizTalk Server 2004.

RESOLUTION

To resolve this issue, when you configure the BizTalk Deployment Wizard, select the option that installs the assembly to the GAC while the Setup program is running.

MORE INFORMATION

For more information about how to install an .NET assembly to the GAC, visit the following Microsoft Developer Network (MSDN) Web site:For more information about BizTalk Server 2004, visit the following Microsoft Web site:

MORE INFORMATION

To reproduce this issue, follow these steps:
  1. Install only BizTalk Server 2004 Administrative Tools on System A.
  2. Install both BizTalk Server 2004 and the runtime components on System B.
  3. Configure both systems to join the same BizTalk group.
  4. Install a BizTalk 2004 assembly in the Global Assembly Cache GAC of System B.
  5. Deploy the assembly by using the BizTalk Deployment Wizard to System A.
  6. When you configure the BizTalk Deployment Wizard settings, select not to install the assembly in the GAC of System A.
  7. By using BizTalk, try to enlist one of the orchestrations from this assembly.
This condition will cause you to receive the error message that is mentioned in the "Symptoms" section.

Modification Type:MajorLast Reviewed:5/13/2004
Keywords:kbBTSOrchestration kbprb KB839451 kbAudDeveloper kbAudEndUser