v5.8.0 Release Candidate 1

NOTE: The Visual Studio add-in, which is developed and released separately, does not yet support Visual Studio 2019.

UNINSTALL all previous releases before installing this one!

Changes in this release:

• Add support for BizTalk 2020
• Remove support for BizTalk 2010 and 2013 (R1)
• Require .NET Framework v4.5+
• Move BTDF ESB Resolver into a separate MSI (will likely be deprecated in a future release)
• Upgrade to XmlPreprocess v3.0 (eliminates .NET 2.x/3.x dependency)
• Upgrade to Environment Settings Manager v1.7 (eliminates .NET 2.x/3.x dependency)
• Upgrade to BizTalk BAM Definition XML Exporter v2.3 (eliminates .NET 2.x/3.x dependency)
• Minor updates to documentation

v5.7.0

Migrated from CodePlex. Originally released on Aug. 13, 2017.

This project exists due to hundreds of hours of volunteer effort (99% by one person at a time!). Please consider making a donation if you find this product useful. Thank you in advance!

DONATE

UNINSTALL all previous releases before installing this one!

***The Visual Studio addin is now on the Visual Studio Marketplace***

Frequently Asked Questions

Partial List of Changes for Release 5.7 (see the Change History for the complete list):

• NEW: Support for BizTalk 2016 - supports BizTalk 2010, 2013, 2013 R2 and 2016, including the ESB Toolkit
• NEW: Redesigned IIS integration - native IIS 7.x/8.x support, separate control of app pools and apps, exclusion filter on MSI packaging, IIS sample app; VDirList still supported for backwards compatibility; first seen in v6.0 Beta
• NEW: Redesigned Visual Studio Addin - removed from MSI and now available on the Visual Studio Marketplace and in the Visual Studio Extensions dialog box
• UNSUPPORTED: BizTalk 2006, 2006 R2 and 2009 are no longer supported.

v5.6.0

Migrated from CodePlex. Originally released on Mar. 12, 2016.

UNINSTALL all previous releases before installing this one!

Frequently Asked Questions

Partial List of Changes for Release 5.6 (see the Change History for the complete list):

• NEW: Support for BizTalk 2013 R2 - supports all BizTalk releases from 2009 to 2013 R2 including the BizTalk ESB Toolkit
• UPDATED: SettingsFileGenerator.xml has been optimized to reduce the file size and simplify diff/merges; default location is now the project folder instead of the EnvironmentSettings folder
• UPDATED: Enhanced control of BizTalk AppDomains allows configuration of one or more AppDomains with custom .NET config files and other settings
• UPDATED: Custom MSI install paths are now embedded in the MSI's instead of requiring separate batch files
• UPDATED: PDB's are no longer deployed to the GAC by default, which allows host instance restarts to happen later in the deployment process
• UPDATED: Several WCF-WebHttp adapter XPaths are now recognized by ElementTunnel for encoding in the bindings file
• DEPRECATED: BizTalk 2006 and 2006 R2 should work, but have not been tested with this release.

v5.5.0

Migrated from CodePlex. Originally released on Feb. 26, 2014.

UNINSTALL all previous releases before installing this one!

Frequently Asked Questions

Partial List of Changes for Release 5.5 (see the Change History for the complete list):

• NEW: Support for BizTalk Server 2013 - supports all BizTalk releases from 2006 to 2013 including the BizTalk ESB Toolkit
• NEW: Auto-termination of service instances customizable by environment (e.g. enable for dev but disable for production)
• NEW: Auto-validation of bindings file XML syntax on deploy and server MSI build
• NEW: "Touchless" support for referencing the Deployment Framework directly from source control without installing the MSI on a build server
• UPDATED: Enhanced WiX MSI generation - uses WiX Heat.exe instead of JavaScript file generator, default WiX template can be fully customized or replaced, and more
• UPDATED: Start menu shortcuts for server deploy - now 100% MSBuild (no more .bat files), default server deploy wizard behavior can be fully customized or replaced, new shortcuts including Quick Deploy, Preprocess and Import Bindings, Update SSO from Settings Spreadsheet and Terminate Service Instances
• UPDATED: ElementTunnel preserves binding XML whitespace and can be re-run on the same file without harm; also supports mixed files with some encoded and some unencoded XML
• UPDATED: Support for IIS 8 on Windows Server 2012/Windows 8
• UPDATED: New versions of XmlPreprocess 2.0.18, WiX 3.8 and NUnit 2.6.3
• UPDATED: ApplyXmlEscape is now True by default in new projects and recommended for all projects

NOTE: This is the last release that will support BizTalk 2006 and 2006 R2.

v5.0.0

Migrated from CodePlex. Originally released on July 26, 2012.

**THIS RELEASE IS NO LONGER SUPPORTED**

v5.0 Release Notes and Frequently Asked Questions

Abridged List of Changes for Release 5.0 (see the Change History for the complete list):

• NEW: Support for BizTalk Server 2009 and 2010 - now supports BizTalk Server 2006, 2006 R2, 2009 and 2010 and BizTalk ESB Toolkit 2.0 and 2.1
• NEW: Complete conversion from NAnt to MSBuild with file structure modeled after standard .csproj/.vbproj project files
• NEW: Consolidated Deployment Framework files under a <projectname>.Deployment folder and integrated server MSI build, leaving the solution root clean
• NEW: Visual Studio 2005/2008/2010 Add-in including integrated menu and toolbar, solution awareness, IntelliSense and Add New Project wizard
• NEW: Windows Installer MSI to install and configure the Deployment Framework
• NEW: Core Framework enhancements
  • Completely revamped support for BRE
  • New samples and over 110 pages of documentation
  • Automatic creation/cleanup of FILE adapter physical paths, including NTFS permission assignment
  • Automated export and deployment of BAM XML from a BAM XLS file to avoid needing Excel on the server
  • Support for Windows Vista and Windows Server 2008 and 2008 R2 (including UAC elevation)
• CHANGE: Discontinued support for BizTalk 2004 (BizTalk 2004 users, please use Version 4.0)

v4.0.0

Migrated from CodePlex. Originally released on Sep 18, 2008.

**THIS RELEASE IS NO LONGER SUPPORTED**

Release 4.0 includes a wide range of new features and improvements:

• Added support for side-by-side deployment (multiple versions of the same BizTalk app installed at once, disabled by default): added a "project" version property, added the version to the installer title and default install folder path, added version number to the BizTalk application name and SSO affiliate app name, auto-prepend app name and version to port names
• Added support for deployment of BAM activity definitions and assigning user accounts to views
• Added support for auto-updating <xlangs> section in BTSNTSvc.exe.config to define a distinct AppDomain for the application and to configure debugging settings
• Added color to NAnt output to highlight warnings and errors (outside of Visual Studio only)
• Updated WiX (for MSI generation) to 3.0.x, in the process drastically simplifying GenericBizTalkMSI.wxs and improving the MSI user interface
• Modified the installer to completely clean up on uninstall, removing all dynamically generated files
• Modified SetEnvUI.exe (the deploy wizard) to open the file browse dialog in the current directory vs. C:\ and replaced a P/Invoke call with a managed call
• Added support for radio buttons in SetEnvUI.exe
• Modified the installer to install "for all users" vs. only for the current user
• Simplified and improved the clarity of the checkbox captions in the server deploy/undeploy wizard
• Added an attribute to the UpdateSSOConfigItem NAnt task for the BizTalk Application name
• Improved error handling in BizTalk NAnt tasks to provide more meaningful error messages
• Added a number of new NAnt tasks to support features described here
• Added a "please wait" message and timestamp during deployment just before starting the BizTalk application
• Added a check for running service instances before attempting to undeploy
• Made documentation updates, reformatted documentation and replaced the HTML version with a PDF version
• Updated to NAnt 0.85 release from RC1
• Included the Visual Studio Tools menu install scripts in the Sample ZIP file
• Cleaned up the project, removing unused files, etc.
• Updated included NUnit subset to V2.4.7
• Fix to ensure that the settings spreadsheet is exported when using the updateOrchestrations target
• Added /c switch to XmlPreprocess.exe command-line to strip preprocessing comments from the final bindings file