Installation of BTDF Deployment Tool

  • Click on below link
  • Click on GetStarted – it will download a file – “DeploymentFrameworkForBizTalkV5_7.msi”.
  • Right Click on the file and Click ‘Run as administrator’ and click ‘Yes’.
  • 1.jpg
  • If you are getting error as below – please close all visual studio windows and run again msi file.
  • 3.jpg
  • If it opens as below click ‘Next’
  • 2.jpg
  • Next select ‘I accept the terms in the License Agreement’ and click ‘Next’
  • 4.jpg
  • Default you can select for ‘Typical’
  • 5.jpg
  • Click on ‘Install’.
  • It takes one or two minutes – lets finish installation.
  • 7.jpg
  • Click finish – once installation completed.
  • 6.jpg
  • Now go to Visual Studio and open any project.
  • You can do below actions by simply clicking on the buttons. These makes deployment easy.
    • Deploy BizTalk Solution (use full for deployment in local system while developing.)
    • Un-deploy BizTalk Solution (use full for deployment in local system while developing.)
    • Partially deploy – deploys only modified components ((use full for deployment in local system while developing.)
    • Restart host instances (use full for deployment in local system while developing.)
    • Updates SSO with current settings (use full for deployment in local system while developing.)
    • Terminates all running and suspended instances (use full for deployment in local system while developing.)
    • Adds the binary output of the currently selected project to the GAC (use full for deployment in local system while developing.)
    • Creates an MSI file for server deployment. (This will be useful to deploy solution (MSI file) in another servers) or even you can use for local deployment like Export and Import.
    • 9.jpg
  • If above deployment buttons not appearing then go to ‘View’ -> Toolbars -> Deployment Framework for BizTalk.

To add a project, go to your solution file and Right Click Add ‘NewProject’.

  • 11.jpgThen Select ‘BizTalk Projects’ on left side window and Right Side window select ‘Deployment Framework for BizTalk…’.
  • Give Name and location as for your requirement and click ok.
  • 12.jpg
  • And it will open another window – there select the options (true or false) what is required in your project and click on ‘Create Project’.
  • 13.jpg
  • Then it will show a window like ‘A default deployment project is created’.
  • 14.jpg
  • It will open automatically ‘btdfproj’ file. Close that file if you don’t want to change any thing in that. It won’t appear all the files in solution but it will create files in the location you selected. So Right click on the solution or where ever you want to include in the Solution. Add ‘Existing Items’.
  • 15.jpg
  • Open folder of the project .
  • 16.jpg
  • Select all files in that and click ok.
  • 17.jpg
  • Now you can see all these below files for deployment. You can use these files and edit\add\delete as per your requirement and click on icons for deployment. It will deploy within minutes. And you can see deployment project in your BizTalk Admin Console.
  • 18.jpg
  • In these files
    • btdfproj – here you will mostly add the dll files location of schemas, maps, pipelines, pipeline components, orchestration and components, etc… Of all your projects under same solution.
    • xml – you will add mostly ‘Receive Port Bindings ‘and ‘send Port bindings’.

Types Of BizTalk Deployment

Using this blog, I just want to throw some light on different ways of BizTalk deployments.

Manual Deployment: This is pretty known style of BizTalk deployment by exporting MSI, Binding files from local environment and import the same in target environment. Here is some of the steps need to be followed.

  • Export MSI from Local Environment
  • Export BindingFile from Local environment
  • Open BidningFile and edit required details like Sendport/Receiveport locations…
  • After edit, just save the Binding file
  • Stop the application in Target Environment
  • Stop Host Instances in Target Environment
  • Import MSI in Target Environment
  • Import Binding file in Target Environment
  • Start Host instances
  • Start BizTalk Application.

Deployment using PowerShell Scripting: This style avoids some of the manual steps mentioned above. Here we write PowerShell commands for all deployment steps and execute the scripts in Target machine.

BTDF Deployment:

BizTalk Deployment Framework is a third-party tool used to automate the BizTalk deployment process. Main advantage of using this tool is to generate the bindings automatically for various environments. We create msi file in local environment by following BTDF steps and deploy the msi in target machine by selecting appropriate binding file in the deployment wizard.

Continuous Integration & Continuous Deployment (Dev Ops):

Continuous Integration approach is most advanced and effective deployment process in BizTalk. We need to use couple of tools (BTDF, TFS, Teamcity, MyGet and Octopus) to setup this process. Here is the sequence of steps we need to follow to setup this process.

  • When ever you do some code changes, you need to check in the code to TFS
  • TeamCity is a tool, which keep monitor for any TFS Checkins.
  • If any TFS checkins found, it will take the latest code from TFS, build it and deploy to Teamcity local environment.
  • If deployment is successful, it will create a Build and place into MyGet Server (This is used to maintain proper versions for Builds).
  • Octopus is a third-party tool using which we deploy the BizTalk artifacts to target environments.
  • In Octopus we need to do couple of configuration to connect MyGet Server, Target Environments.
  • We need to write deployment steps using powershell scripting in Octopus.
  • We create a BizTalk release in Octopus by selecting latest Build from MyGet server.
  • While deploying we need to select the target machine in drop down list and deploy it.
  • Using Powershell scripting steps, BizTalk code will be deployed to Target machine.