Slides from my BizTalk Migrator Deep Dive session at Global Integration Bootcamp 2021 session on Feb 27th 2021. This session gave more details about Microsoft's migration tool, how to get it, how to use it, and how it works plus demos of using it for various scenarios.

1. Dan Probert
BizTalk Migrator
Deep Dive
Chief Technical Officer – Affinus
Limited
@probertdaniel

2. Dan is the Chief Technical Officer for
Affinus Limited.
Dan has been working in the
integration space for over 20 years:
with BizTalk since 2002, and with
Azure since 2008.
Dan has been working specifically on
the problem space of BizTalk->Azure
migration since 2015.
@probertdaniel
in/probertdaniel
Dan Probert

3. Agenda
• High level overview of tool
• How to get and run the tool
• How it works
• Demo: migrating an application
• What Azure artifacts it generates
• Demo: Deploying to Azure
• Demo: Orchestration Migration
• Advanced concepts

4. BizTalk Migrator: High Level
Overview
• Open source command line tool developed by Microsoft
• Source code is on GitHub (https://github.com/Azure/aimtool)
• Microsoft want your feedback on what features to add support for –
fill in survey here: https://aka.ms/biztalkmigrationsurvey

5. The Migration Process

6. How to get the tool
• Is available via Chocolatey
• https://chocolatey.org/install
• Then from a command prompt run:
• choco install biztalkmigrator --pre

7. How to run the tool
• From a Command Prompt/PowerShell/Terminal execute:
• aim.exe --help
• aim assess -a "microsoft.biztalk.msidiscoverer.msifiles=<path to
MSI>" --primary-region "UK South" --unique-deployment-id <id>
• aim migrate -a "microsoft.biztalk.msidiscoverer.msifiles=<path to
MSI>" --primary-region "UK South" --unique-deployment-id <id>
• Additional options:
• -v (for verbose Logging)
• --no-abort (to continue running if there is an error)

8. How it works
Convert
Report
Parse
Discover
MSI
Binding
File
DLLs
Extrac
t
Source
Model
Report
Scripts/
Templat
es
Analyse
Target
Model

9. Demo: Migrating an application

10. What Azure artifacts it
generates
Message Bus
Config
Store
Routin
g Store
Artifac
t Store
APIM
Config
Mgr
Routin
g
Mgr
Messagi
ng
Mgr
Key
Vault
Storag
e
RSR
Function
s
System
Application
Service
Bus
JSON
Decod
e
JSON
Encode
Flat
File
Decod
e
Topic
Publish
er
Conten
t
Promot
e
Conten
t
Demot
e
Xml
Process
or
Xml
Translat
e
Xml
Validate
Your Application
Receiv
e Port
Send
Port
Topic
Subscrib
er
Process
Manager
API
Connectio
ns

11. Demo: Deploying to Azure

12. Orchestration Migration
Send Port Receive Port
Correlation
Set
Variable Parameter
Role Link
Port Type
Call
Orchestratio
n
Correlation
Type
Multipart
Message
Type
Group
Role Link
Type
Call Rules Compensate
Construct
Message
Decide
Expression
Delay
Listen Loop
Message
Assignment
Parallel
Actions
Receive Scope Send
Start
Orchestratio
n
Suspend Terminate
Throw
Exception
Transform
Communications
Types
Shapes

13. Orchestration Migration
Send Port Receive Port
Correlation
Set
Variable Parameter
Role Link
Port Type
Call
Orchestratio
n
Correlation
Type
Multipart
Message
Type
Group
Role Link
Type
Call Rules Compensate
Construct
Message
Decide
Expression
Delay
Listen Loop
Message
Assignment
Parallel
Actions
Receive Scope Send
Start
Orchestratio
n
Suspend Terminate
Throw
Exception
Transform
Communications
Types
Shapes

14. Demo: Orchestration Migration

15. Advanced concepts
• Changing route
• Adding FlatFile Decoder
• Changing configuration
• Automatically refreshing APIM cache on Config change

16. What’s next for the tool?
• What I’d like to see:
• New Dedicated Runtime (Function App) Support
• Improved Performance
• More Adapters (MQ/SAP/SQL/WCF)
• More orchestration support
• Business Rules Engine
• BAM

17. Microsoft BizTalk Migrator
Survey
• Please vote on what feature you’d like to see support for by filling in
the survey:
https://aka.ms/biztalkmigrationsurvey

18. Thank you!