Checklist: Update the Artifacts in a BizTalk Application

Follow the steps in this checklist if you want to change or update one or more artifacts in an application that has already been deployed, and then redeploy the application.

Step Reference
Review the important considerations for updating artifacts in an application. Important Considerations for Updating Applications
Ensure that you have appropriate permissions to perform the deployment. Permissions Required for Deploying and Managing a BizTalk Application
Make any necessary changes to your assemblies in Visual Studio. If you are updating an assembly that is running in a production environment, you should always increment the assembly version number. For background information, see Updating BizTalk Applications. Then deploy the assemblies from Visual Studio into a BizTalk application in the development environment. How to Deploy a BizTalk Assembly from Visual Studio
Test any new or changed artifacts, ensuring that any artifacts that may depend on the new or changed artifact are also tested. While testing, be sure to consider dependencies that may exist between this application and other applications. Testing Tasks for BizTalk Application Deployment
Add, remove, or reconfigure artifacts in the application as necessary. How to Create or Add an Artifact, How to Remove an Artifact from an Application, Managing Artifacts
Export the application containing the new or changed artifacts into an .msi file. You may either export all of the artifacts in the application or only the artifacts you want to add or update. Be aware that file artifacts can be overwritten. If you export a file artifact, make sure that it is the version that you want to use in the application. Exporting BizTalk Applications, Bindings, and Policies
If the update will interfere with the application as it runs, stop the application that you want to update. If you are updating an assembly with a new version, you do not need to restart the application. Note: Although it is not required to stop an application in order to update an artifact or install the application, we recommend that you always stop an application when you update an artifact. How to Start and Stop a BizTalk Application
Import the changed or updated artifacts from the .msi file into the application that you want to update. Be sure to specify the option to overwrite existing artifacts. How to Import a BizTalk Application
Install the updated application or artifacts from the .msi file onto all of the computers that run the application as well as any computers running applications that depend on this application. If you are updating a BizTalk assembly, verify that the new version of the assembly is installed in the global assembly cache (GAC) on each computer that is to run the assembly. If not, install the assembly in each GAC. How to Install a BizTalk Application, How to Install an Assembly in the GAC
Start the application. How to Start and Stop a BizTalk Application
After importing an assembly that contains an orchestration, if the application to which you are importing it already contains an assembly that has the same name, public key token, and version, stop and start the host instances of the host to which the orchestration is bound. This ensures that the new version of the assembly is used by BizTalk Server. How to Stop a Host Instance, How to Start a Host Instance

See Also

BizTalk Application Deployment and Management Checklists
Updating BizTalk Applications