|
| 1 | +--- |
| 2 | +title: Recover from region-wide failure |
| 3 | +description: Learn how Azure App Service helps you maintain business continuity and disaster recovery (BCDR) capabilities. Recover your app from a region-wide failure in Azure. |
| 4 | + |
| 5 | +ms.topic: how-to |
| 6 | +ms.date: 06/09/2020 |
| 7 | +ms.custom: "UpdateFrequency3, subject-moving-resources" |
| 8 | + |
| 9 | +#Customer intent: As an Azure service administrator, I want to recover my App Service app from a region-wide failure in Azure. |
| 10 | +--- |
| 11 | + |
| 12 | +# Move an App Service app to another region |
| 13 | + |
| 14 | +This article describes how to bring App Service resources back online in a different Azure region during a disaster that impacts an entire Azure region. When a disaster brings an entire Azure region offline, all App Service apps hosted in that region are placed in disaster recovery mode. Features are available to help you restore the app to a different region or recover files from the impacted app. |
| 15 | + |
| 16 | +App Service resources are region-specific and can't be moved across regions. You must restore the app to a new app in a different region, and then create mirroring configurations or resources for the new app. |
| 17 | + |
| 18 | +## Prerequisites |
| 19 | + |
| 20 | +- None. [Restoring an automatic backup](manage-backup.md#restore-a-backup) usually requires **Standard** or **Premium** tier, but in disaster recovery mode, it's automatically enabled for your impacted app, regardless which tier the impacted app is in. |
| 21 | + |
| 22 | +## Prepare |
| 23 | + |
| 24 | +Identify all the App Service resources that the impacted app currently uses. For example: |
| 25 | + |
| 26 | +- App Service apps |
| 27 | +- [App Service plans](overview-hosting-plans.md) |
| 28 | +- [Deployment slots](deploy-staging-slots.md) |
| 29 | +- [Custom domains purchased in Azure](manage-custom-dns-buy-domain.md) |
| 30 | +- [TLS/SSL certificates](configure-ssl-certificate.md) |
| 31 | +- [Azure Virtual Network integration](./overview-vnet-integration.md) |
| 32 | +- [Hybrid connections](app-service-hybrid-connections.md). |
| 33 | +- [Managed identities](overview-managed-identity.md) |
| 34 | +- [Backup settings](manage-backup.md) |
| 35 | + |
| 36 | +Certain resources, such as imported certificates or hybrid connections, contain integration with other Azure services. For information on how to move those resources across regions, see the documentation for the respective services. |
| 37 | + |
| 38 | +## Restore app to a different region |
| 39 | + |
| 40 | +1. Create a new App Service app in a *different* Azure region than the impacted app. This is the target app in the disaster recovery scenario. |
| 41 | + |
| 42 | +1. In the [Azure portal](https://portal.azure.com), navigate to the impacted app's management page. In a failed Azure region, the impacted app shows a warning text. Click the warning text. |
| 43 | + |
| 44 | +  |
| 45 | + |
| 46 | +1. In the **Restore Backup** page, configure the restore operation according to the following table. When finished, click **OK**. |
| 47 | + |
| 48 | + | Setting | Value | Description | |
| 49 | + |-|-|-| |
| 50 | + | **Snapshot (Preview)** | Select a snapshot. | The two most recent snapshots are available. | |
| 51 | + | **Restore destination** | **Existing app** | Click the note below that says **Click here to change the restore destination app** and select the target app. In a disaster scenario, you can only restore the snapshot to an app in a different Azure region. | |
| 52 | + | **Restore site configuration** | **Yes** | | |
| 53 | + |
| 54 | +  |
| 55 | + |
| 56 | +3. Configure [everything else](#prepare) in the target app to mirror the impacted app and verify your configuration. |
| 57 | + |
| 58 | +4. When you're ready for the custom domain to point to the target app, [remap the domain name](manage-custom-dns-migrate-domain.md#4-remap-the-active-dns-name). |
| 59 | + |
| 60 | +## Recover app content only |
| 61 | + |
| 62 | +If you only want to recover the files from the impacted app without restoring it, use the following steps: |
| 63 | + |
| 64 | +1. In the [Azure portal](https://portal.azure.com), navigate to the impacted app's management page and click **Get publish profile**. |
| 65 | + |
| 66 | +  |
| 67 | + |
| 68 | +1. Open the downloaded file and find the publishing profile that contains `ReadOnly - FTP` in its name. This is the disaster recovery profile. For example: |
| 69 | + |
| 70 | + ```xml |
| 71 | + <publishProfile profileName="%app-name% - ReadOnly - FTP" publishMethod="FTP" publishUrl="ftp://%ftp-site%/site/wwwroot" ftpPassiveMode="True" userName="%app-name%\$%app-name%" userPWD="" destinationAppUrl="http://%app-name%.azurewebsites.net" SQLServerDBConnectionString="" mySQLDBConnectionString="" hostingProviderForumLink="" controlPanelLink="http://windows.azure.com" webSystem="WebSites"> |
| 72 | + <databases /> |
| 73 | + </publishProfile> |
| 74 | + ``` |
| 75 | + |
| 76 | + Copy three attribute values: |
| 77 | + |
| 78 | + - `publishUrl`: the FTP hostname |
| 79 | + - `userName` and `userPWD`: the FTP credentials |
| 80 | + |
| 81 | +1. Use the FTP client of your choice, connect to the impacted app's FTP host using the hostname and credentials. |
| 82 | + |
| 83 | +1. Once connected, download the entire */site/wwwroot* folder. The following screenshot shows how you download in [FileZilla](https://filezilla-project.org/). |
| 84 | + |
| 85 | +  |
| 86 | + |
| 87 | +## Next steps |
| 88 | +[Backup and restore](manage-backup.md) |
0 commit comments