BizTalk Tips & Things

Agustin Mantaras BizTalk Blog

Installing Windows Azure BizTalk Services SDK


This is just a simple step by step guide to help you understand how to install the Windows Azure BizTalk Services SDK and what are the key components.

Downloading the SDK Files

You can download the SDK from this location:


If you plan to use EDI integrations, then you need to select the file


The File

This is an interesting file that contains two important tools if you are already using BizTalk Server on premise

  1. BTM Migration Tool: The BTM to TRFM convertor is a command line tool which takes inputs as BTM File (BizTalk on premise map format), input and output schemas and produces the new mapper (.trfm) file as an output (BizTalk Services map format)
  2. TPM Migration Tool: The trading partner data migration tool migrates partner and agreement settings from BizTalk Server 201x to Windows Azure BizTalk Services.


Installing the Windows Azure SDK

  1. Before installing, make sure that Visual Studio is not open, because  the installation will fail like this:


  2. Run the WindowsAzureBizTalkServicesSetup.exe


  3. Accept the terms and click Next
  4. Select Tools (Basically PowerShell cmdlets) and RunTime (if you plan to use LOB adapters, then you need to install this)


  5. Review the summary section and click on Install


  6. After several minutos like 5 to 10, you will see the BizTalk Adapter Service Setup Wizard:


  7. Click Next, accept the terms
  8. Choose the appropiated Identity management for the BizTalk adapter application pool.The BizTalk Adapter Service application pool in IIS is created and executes as this identity



  10. In Azure BizTalk Services Deployment Details, provide the BizTalk Services deployment URL, and select Next.
    This URL is used to ascertain the artifact store associated with your BizTalk Services subscription. The configuration settings for BizTalk Adapter Service components you create, such as LOB Relays and LOB Targets, are stored in the artifact store.



  12. Select the certificate bindings for the BizTalk Adapter Service website and select Next.
    • Use SSL to secure the management service: Select this option to encrypt the HTTP requests with SSL.
    • Select an existing SSL certificate: Select this option to select an existing certificate from the Certificates personal store. The certificate should be from a trusted certificate authority.
    • Port: Enter the port number for the BizTalk Adapter Service website. By default, port 8080 is specified. Confirm the port is open in your firewall.


    • Note that in my case i have disabled SSL to simplify development.
  13. Click Next and then Install.
  14. After a couple of minutes, you will be ready to create you first Windows Azure BizTalk Service integration


Ready to go! Good Luck in this new world! Sonrisa


Main Source: