Microsoft BizTalk Server 2004
Deploying Assemblies

Microsoft® BizTalk® Server provides several tools and methods to deploy assemblies and any additional files that accompany your application to the different environments, such as development, test, staging and production. Use each of the tools and methods for its specific purpose.

This topic describes the assembly deployment tools and methods that you can use to deploy the assemblies you created using BizTalk Server, and the situation for which each method is best suited. For more information about the various deployment tools, see Assembly Installation in the GAC.

The following flowchart diagram shows all the steps involved in deploying assemblies from your development environment (encompassing planning and development - performed by a developer) to your target environment (encompassing testing, staging, and production - performed by an IT administrator). You can deploy assemblies using any one of three options:

  • Deploying Assemblies (standard)
  • Deploying Assemblies using BTSInstaller
  • Deploying Assemblies using BTSInstaller and Application Center 2000

    Deploying BizTalk Assemblies

Follow the tasks and links in consecutive order in this table for your standard assembly deployment. The links correspond to procedural topics and provide task-specific information. Use the flowchart map in conjunction with this table to help you identify your location in the process from the development environment to the target environment.

Task (Deploying Assemblies (Standard))Topic
Build BizTalk assembliesAbout BizTalk Project System
Deploy BizTalk assembliesDeploying an Assembly Using Visual Studio .NET

-and-

Using the Build Menu

Bind orchestrationsBinding an Orchestration Using BizTalk Explorer
Export bindingsExporting Assembly Bindings Using the BizTalk Deployment Wizard
If no more computers to deploy to -

Enable receive locations

Enabling Receive Locations in the BizTalk Administration Console
Enlist/Start send portsEnlisting a Send Port or Send Port Group
Enlist/Start orchestrationsEnlisting an Orchestration with the BizTalk Administration ConsoleStarting an Orchestration with the BizTalk Administration Console
If more computers to deploy to -

Visit remote computer

No associated topic.
Copy BizTalk assemblies and other supporting files to remote serverNo associated topic.
Use gacutil to install non-BizTalk assemblies to GACInstalling assemblies in the GAC Using Visual Studio .NET
Verify non-BizTalk assemblies are in local GACViewing Assemblies with the BizTalk Assembly Viewer
If last computer -

Deploy BizTalk assemblies in GAC and Configuration database and import bindings

Deploying Assemblies Using the BizTalk Deployment Wizard
Verify orchestrations are deployed to Configuration databaseBrowsing Orchestrations Using BizTalk Explorer
Enable receive locationsEnabling Receive Locations in the BizTalk Administration Console
Enlist/Start send portsEnlisting a Send Port or Send Port Group
Enlist/Start orchestrationsEnlisting an Orchestration with the BizTalk Administration ConsoleStarting an Orchestration with the BizTalk Administration Console
If not last computer -

Use gacutil to install BizTalk assemblies to GAC

Installing assemblies in the GAC Using Visual Studio .NET
Verify BizTalk assemblies are in local GACViewing Assemblies with the BizTalk Assembly Viewer
Verify non-BizTalk assemblies are in local GACViewing Assemblies with the BizTalk Assembly Viewer
If no more computers to deploy to -

Enable receive locations

Enabling Receive Locations in the BizTalk Administration Console
Enlist/Start send portsEnlisting a Send Port or Send Port Group
Enlist/Start orchestrationsEnlisting an Orchestration with the BizTalk Administration ConsoleStarting an Orchestration with the BizTalk Administration Console
If more computers to deploy to -

Continue steps in loop from 'Visit remote computer' until no more deployments are necessary

See above topics.

Follow the tasks and links in this table for your assembly deployment using BTSInstaller. The links correspond to procedural topics and provide task-specific information. Use the flowchart map in conjunction with this table to help you identify your location in the process from the development environment to the target environment.

Task (Deploying Assemblies using BTSInstaller)Topic
Build BizTalk assembliesAbout BizTalk Project System
Deploy BizTalk assembliesDeploying an Assembly Using Visual Studio .NET

-and-

Using the Build Menu

Bind orchestrationsBinding an Orchestration Using BizTalk Explorer
Export bindingsExporting Assembly Bindings Using the BizTalk Deployment Wizard
Add BizTalk project to BizTalk solution (in Visual Studio® .NET 2003)Development Environment Tasks
Add BizTalk assemblies and binding files to BTSInstallerDevelopment Environment Tasks
Build BizTalk projectDevelopment Environment Tasks
If no more computers to deploy to -

Enable receive locations

Enabling Receive Locations in the BizTalk Administration Console
Enlist/Start send portsEnlisting a Send Port or Send Port Group
Enlist/Start orchestrationsEnlisting an Orchestration with the BizTalk Administration ConsoleStarting an Orchestration with the BizTalk Administration Console
If more computers to deploy to -

Visit remote computer

No associated topic.
Copy MSI file to remote computerTarget Environment Tasks
If last computer -

Execute MSI file with Deploy = True

Target Environment Tasks
Verify orchestrations are deployed to Configuration databaseBrowsing Orchestrations Using BizTalk Explorer
Enable receive locationsEnabling Receive Locations in the BizTalk Administration Console
Enlist/Start send portsEnlisting a Send Port or Send Port Group
Enlist/Start orchestrationsEnlisting an Orchestration with the BizTalk Administration ConsoleStarting an Orchestration with the BizTalk Administration Console
If not last computer -

Execute MSI file

Target Environment Tasks
Verify BizTalk assemblies are in local GACViewing Assemblies and Types on the Local Server
Verify non-BizTalk assemblies are in local GACViewing Assemblies and Types on the Local Server
If no more computers to deploy to -

Enable receive locations

Enabling Receive Locations in the BizTalk Administration Console
Enlist/Start send portsEnlisting a Send Port or Send Port Group
Enlist/Start orchestrationsEnlisting an Orchestration with the BizTalk Administration ConsoleStarting an Orchestration with the BizTalk Administration Console
If more computers to deploy to -

Continue steps in loop from 'Visit remote computer' until no more deployments are necessary

See the above topics.

Follow the tasks and links in this table for your assembly deployment using BTSInstaller and Application Center 2000. The links correspond to procedural topics and provide task-specific information Use the flowchart map in conjunction with this table to help you identify your location in the process from the development environment to the target environment.

Task (Deploying Assemblies using BTSInstaller and Application Center 2000)Topic
Build BizTalk assembliesAbout BizTalk Project System
Install non-BizTalk assemblies in GACDevelopment Environment Tasks
Deploy BizTalk assembliesDeploying an Assembly Using Visual Studio .NET

-and-

Using the Build Menu

Bind orchestrationsBinding an Orchestration Using BizTalk Explorer
Export bindingsExporting Assembly Bindings Using the BizTalk Deployment Wizard
Add BizTalk project to BizTalk solution (in Visual Studio .NET 2003)Development Environment Tasks
Add BizTalk assemblies and binding files to BTSInstallerDevelopment Environment Tasks
Build BizTalk projectDevelopment Environment Tasks
Visit remote computerNo associated topic.
Copy MSI file to remote computerTarget Environment Tasks
Execute MSI file with Deploy = TrueTarget Environment Tasks
Verify BizTalk assemblies are in local GACViewing Assemblies with the BizTalk Assembly Viewer
Verify non-BizTalk assemblies are in local GACViewing Assemblies with the BizTalk Assembly Viewer
Verify orchestrations are deployed to Configuration databaseBrowsing Orchestrations Using BizTalk Explorer
Create Application Center 2000 application to synchronize GACs"Using Application Center 2000" topic in the Visual Studio .NET 2003 Combined Collection
Verify BizTalk assemblies are in GACs of each computerViewing Assemblies and Types on the Local Server
Verify non-BizTalk assemblies are in local GACs of each computerViewing Assemblies and Types on the Local Server
Enable receive locationsEnabling Receive Locations in the BizTalk Administration Console
Enlist/Start send portsEnlisting a Send Port or Send Port Group
Enlist/Start orchestrationsEnlisting an Orchestration with the BizTalk Administration ConsoleStarting an Orchestration with the BizTalk Administration Console

Before you deploy your solution, be aware of possible situations and constraints that could prevent you from successfully deploying assemblies. For more information, see About Assembly Deployment.

This section contains:

To download updated BizTalk Server 2004 Help from www.microsoft.com, go to http://go.microsoft.com/fwlink/?linkid=20616.

Copyright © 2004 Microsoft Corporation.
All rights reserved.
Page view tracker