BizTalk Services: Backup and Restore
Microsoft Azure BizTalk Services (MABS) is being retired and replaced with Azure Logic Apps. If you currently use MABS, review this article for guidance about migrating your integration solutions to Logic Apps: Move from BizTalk Services to Logic Apps
If you're new to Logic Apps, try starting here:
Azure BizTalk Services includes Backup and Restore capabilities.
BizTalk Services is deprecated in the Azure portal. To manage your MABS instances, see REST API for Managing BizTalk Services on Azure.
Hybrid Connections are NOT backed up, regardless of the Edition. You must recreate your hybrid connections.
Before you Begin
Backup and Restore may not be available for all editions. See BizTalk Services: Editions Chart.
Backup content can be restored to the same BizTalk Service or to a new BizTalk Service. To restore the BizTalk Service using the same name, the existing BizTalk Service must be deleted and the name must be available. After you delete a BizTalk Service, it can take longer time than wanted for the same name to be available. If you cannot wait for the same name to be available, then restore to a new BizTalk Service.
BizTalk Services can be restored to the same edition or a higher edition. Restoring BizTalk Services to a lower edition, from when the backup was taken, is not supported.
For example, a backup using the Basic Edition can be restored to the Premium Edition. A backup using the Premium Edition cannot be restored to the Standard Edition.
The EDI Control numbers are backed up to maintain continuity of the control numbers. If messages are processed after the last backup, restoring this backup content can cause duplicate control numbers.
If a batch has active messages, process the batch before running a backup. When creating a backup (as needed or scheduled), messages in batches are never stored.
If a backup is taken with active messages in a batch, these messages are not backed up and are therefore lost.
Optional: In the BizTalk Services Portal, stop any management operations.
Create a backup
A backup can be taken at any time and is completely controlled by you. To create a backup, use the REST API for Managing BizTalk Services on Azure.
To restore a backup, use the REST API for Managing BizTalk Services on Azure.
After restoring a backup
The BizTalk Service is always restored in a Suspended state. In this state, you can make any configuration changes before the new environment is functional, including:
- If you created BizTalk Service applications using the Azure BizTalk Services SDK, you may need to update the Access Control (ACS) credentials in those applications to work with the restored environment.
- You restore a BizTalk Service to replicate an existing BizTalk Service environment. In this situation, if there are agreements configured in the original BizTalk Services portal that use a source FTP folder, you may need to update the agreements in the newly restored environment to use a different source FTP folder. Otherwise, there may be two different agreements trying to pull the same message.
- If you restored to have multiple BizTalk Service environments, make sure you target the correct environment in the Visual Studio applications, PowerShell cmdlets, REST APIs, or Trading Partner Management OM APIs.
- It's a good practice to configure automated backups on the newly restored BizTalk Service environment.
What gets backed up
When a backup is created, the following items are backed up:
|Items backed up|
|Azure BizTalk Services Portal|
|Configuration and Runtime||
|Azure BizTalk Service|
|BizTalk Service Settings||
|Tracking Database||When the BizTalk Service is created, the Tracking Database details are entered, including the Azure SQL Database Server and the Tracking Database name. The Tracking Database is not automatically backed up.
If the Tracking Database is deleted and the database needs recovered, a previous backup must exist. If a backup does not exist, the Tracking Database and its data are not recoverable. In this situation, create a new Tracking Database with the same database name. Geo-Replication is recommended.
- Backup BizTalk Service
- Restore BizTalk Service from Backup
- BizTalk Services: Developer, Basic, Standard and Premium Editions Chart
- BizTalk Services: Provisioning
- BizTalk Services: Provisioning Status Chart
- BizTalk Services: Dashboard, Monitor and Scale tabs
- BizTalk Services: Throttling
- BizTalk Services: Issuer Name and Issuer Key
- How do I Start Using the Azure BizTalk Services SDK
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.