Preface

This document describes the functionality provided by the BizTalk plugin.

Refer to Deployit Reference Manual for background information on Deployit and deployment concepts.

Overview

The BizTalk plugin is a Deployit plugin that adds the capability to perform BizTalk configuration and deployment tasks.

Features

• Creates and destroys BizTalk applications in the BizTalk database.
  • Starts and stops BizTalk applications as necessary.
• Adds and remove BizTalk and plain assemblies to/from the BizTalk database.
• Imports BizTalk bindings files into the BizTalk database.
• Imports BizTalk Business Rule Engine (BRE) vocabularies into the BizTalk database.
• Imports, deploys and undeploys BRE rules into the BizTalk database.
• Installs BizTalk and plain assemblies in the Global Assembly Cache (GAC) on every BizTalk server (host).

Requirements

• Deployit requirements:

  • Deployit version 3.8.4 or higher.

• Infrastructural requirements for the target machine:

  • Administrative access (with elevated privileges) is required to run the PowerShell provider for BizTalk.
    • N.B.: When the machine that runs the PowerShell provider for BizTalk is accessed over WinRM and is then used to connect to a third machine, an error such as Login failed for user 'NT AUTHORITY\ANONYMOUS LOGON' may appear. Either install the PowerShell provider for BizTalk on all machines that run the BizTalk database, or install it on the machine the runs Deployit and use an overthere.LocalHost to access it.
  • PowerShell 2.0 must be installed.
  • The 32-bit version of the PowerShell executable must be configured to run with .NET 4.0 (see below).
  • The BizTalkFactory PowerShell Provider for BizTalk Server 2010 must be installed.

Configure the 32-bit version of PowerShell to run with .NET 4.0

On the machine that runs the PowerShell provider for BizTalk, create the file C:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell.exe.config with the following content:

 <?xml version="1.0"?> 
 <configuration> 
     <startup useLegacyV2RuntimeActivationPolicy="true"> 
         <supportedRuntime version="v4.0.30319"/> 
         <supportedRuntime version="v2.0.50727"/> 
    </startup> 
</configuration>

Usage in deployment packages

The plugin works with the standard deployment package DAR format. Please see the Packaging Manual for more details about the DAR format and the ways to compose one. The following is a sample MANIFEST.MF file that includes a few of the deployables provided by the BizTalk plugin:

Manifest-Version: 1.0
Deployit-Package-Format-Version: 1.3
CI-Application: BizTalkApp1
CI-Version: 1.0

Name: BizTalkApp1
CI-Type: biztalk.ApplicationSpec

Name: BizTalkApp1.Schemas.dll
CI-Type: biztalk.BizTalkAssemblyFile
CI-applicationName: BizTalkApp1
CI-destinationPath: {{ASSEMBLY_DESTINATION_DIR}}\BizTalkApp1.Sche
 mas.dll

Name: BizTalkApp1.dll
CI-Type: biztalk.BizTalkAssemblyFile
CI-applicationName: BizTalkApp1
CI-destinationPath: {{ASSEMBLY_DESTINATION_DIR}}\BizTalkApp1.dll

Name: BizTalkApp1.BindingInfo.xml
CI-Type: biztalk.BindingsFile
CI-applicationName: BizTalkApp1

Name: BizTalkApp1.1.0.Vocabulary.xml
CI-Type: biztalk.VocabularyFile
CI-applicationName: All policies

Name: BizTalkApp1.Rule.1.0.xml
CI-Type: biztalk.RulesFile
CI-applicationName: All policies

Using the deployables and deployeds

The following table describes which deployable/container combinations are possible.

Deployable vs. Container table

The following table describes the effect a deployed has on its container

Deployed Actions Table

Extending the BizTalk plugin

The BizTalk plugin has been written upon the foundations provided by the PowerShell plugin, which is a standard part of the Deployit server distribution. Please refer to the documentation of the PowerShell plugin for details on how to extend PowerShell-based plugins.