Skip to content

Commit b482ebd

Browse files
author
Ankita Dutta
committed
tutorial edits for QS
1 parent 9ee527c commit b482ebd

File tree

1 file changed

+61
-49
lines changed

1 file changed

+61
-49
lines changed

articles/resource-mover/tutorial-move-region-virtual-machines.md

Lines changed: 61 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ manager: evansma
55
author: rayne-wiselman
66
ms.service: resource-move
77
ms.topic: tutorial
8-
ms.date: 02/04/2021
8+
ms.date: 11/28/2022
99
ms.author: raynew
10-
ms.custom: mvc
10+
ms.custom: mvc, engagement-fy23
1111
#Customer intent: As an Azure admin, I want to move Azure VMs to a different Azure region.
1212

1313
---
1414
# Tutorial: Move Azure VMs across regions
1515

16-
In this article, learn how to move Azure VMs, and related network/storage resources, to a different Azure region, using [Azure Resource Mover](overview.md).
16+
Azure Resource Mover helps you move Azure resources between Azure regions. This tutorial shows you how to move Azure VMs and related network/storage resources to a different Azure region using [Azure Resource Mover](overview.md).
1717

1818
In this tutorial, you learn how to:
1919

@@ -29,23 +29,29 @@ In this tutorial, you learn how to:
2929
> [!NOTE]
3030
> Tutorials show the quickest path for trying out a scenario and using default options.
3131
32-
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/free-trial/) before you begin. Then sign in to the [Azure portal](https://portal.azure.com).
33-
3432
## Prerequisites
3533

34+
Before you begin, verify the following prerequisites:
35+
3636
| Requirement | Description |
3737
|------------ | ------------|
38-
| **Resource Mover support** | [Review](common-questions.md) supported regions and other common questions. |
39-
| **Subscription permissions** | Check you have *Owner* access on the subscription containing the resources that you want to move<br/><br/> **Why do I need Owner access?** The first time you add a resource for a specific source and destination pair in an Azure subscription, Resource Mover creates a [system-assigned managed identity](../active-directory/managed-identities-azure-resources/overview.md#managed-identity-types) (formerly known as Managed Service Identify (MSI)) that's trusted by the subscription. To create the identity, and to assign it the required role (Contributor or User Access administrator in the source subscription), the account you use to add resources needs *Owner* permissions on the subscription. [Learn more](../role-based-access-control/rbac-and-directory-admin-roles.md#azure-roles) about Azure roles.|
40-
| **VM support** | Check that the VMs you want to move are supported.<br/><br/> - [Verify](support-matrix-move-region-azure-vm.md#windows-vm-support) supported Windows VMs.<br/><br/> - [Verify](support-matrix-move-region-azure-vm.md#linux-vm-support) supported Linux VMs and kernel versions.<br/><br/> - Check supported [compute](support-matrix-move-region-azure-vm.md#supported-vm-compute-settings), [storage](support-matrix-move-region-azure-vm.md#supported-vm-storage-settings), and [networking](support-matrix-move-region-azure-vm.md#supported-vm-networking-settings) settings.|
38+
| **Resource Mover support** | [Review](common-questions.md) the supported regions and other common questions. |
39+
| **Subscription permissions** | Check that you have *Owner* access on the subscription containing the resources that you want to move<br/><br/> **Why do I need Owner access?** The first time you add a resource for a specific source and destination pair in an Azure subscription, Resource Mover creates a [system-assigned managed identity](../active-directory/managed-identities-azure-resources/overview.md#managed-identity-types) (formerly known as Managed Service Identify (MSI)) that's trusted by the subscription. To create the identity, and to assign it the required role (Contributor or User Access administrator in the source subscription), the account you use to add resources needs *Owner* permissions on the subscription. [Learn more](../role-based-access-control/rbac-and-directory-admin-roles.md#azure-roles) about Azure roles.|
40+
| **VM support** | Check that the VMs you want to move are supported.<br/> - [Verify](support-matrix-move-region-azure-vm.md#windows-vm-support) supported Windows VMs.<br/> - [Verify](support-matrix-move-region-azure-vm.md#linux-vm-support) supported Linux VMs and kernel versions.<br/> - Check supported [compute](support-matrix-move-region-azure-vm.md#supported-vm-compute-settings), [storage](support-matrix-move-region-azure-vm.md#supported-vm-storage-settings), and [networking](support-matrix-move-region-azure-vm.md#supported-vm-networking-settings) settings.|
4141
| **Destination subscription** | The subscription in the destination region needs enough quota to create the resources you're moving in the target region. If it doesn't have a quota, [request additional limits](../azure-resource-manager/management/azure-subscription-service-limits.md).
4242
**Destination region charges** | Verify pricing and charges associated with the target region to which you're moving VMs. Use the [pricing calculator](https://azure.microsoft.com/pricing/calculator/) to help you.|
43-
43+
44+
45+
## Sign in to Azure
46+
47+
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/free-trial/) before you begin. Then sign in to the [Azure portal](https://portal.azure.com).
4448

4549
## Prepare VMs
4650

47-
1. After checking that VMs meet requirements, make sure that VMs you want to move are turned on. All VMs disks that you want to be available in the destination region must be attached and initialized in the VM.
48-
1. Make sure VMs have the latest trusted root certificates, and an updated certificate revocation list (CRL). To do this:
51+
To prepare the VMs for the move, follow the given steps:
52+
53+
1. After checking that VMs meet the requirements, ensure that the VMs you want to move are turned on. All VMs disks that you want to be available in the destination region must be attached and initialized in the VM.
54+
1. Make sure VMs have the latest trusted root certificates and an updated certificate revocation list (CRL). To do this:
4955
- On Windows VMs, install the latest Windows updates.
5056
- On Linux VMs, follow distributor guidance so that machines have the latest certificates and CRL.
5157
1. Allow outbound connectivity from VMs:
@@ -54,37 +60,39 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
5460

5561
## Select resources
5662

57-
Select the resources you want to move.
63+
Before you select the resources you want to move:
5864

5965
- All supported resource types in resource groups within the selected source region are displayed.
6066
- Resources that have already been added for moving across regions aren't shown.
6167
- You move resources to a target region in the same subscription as the source region. If you want to change the subscription, you can do that after the resources are moved.
6268

69+
To select the resources you want to move, follow these steps:
70+
6371
1. In the Azure portal, search for *resource mover*. Then, under **Services**, select **Azure Resource Mover**.
6472

6573
![Search results for resource mover in the Azure portal](./media/tutorial-move-region-virtual-machines/search.png)
6674

67-
2. In **Overview**, click **Get started**.
75+
2. In **Overview**, select **Get Started**.
6876

6977
![Button to add resources to move to another region](./media/tutorial-move-region-virtual-machines/get-started.png)
7078

7179
3. In **Move resources** > **Source + destination**, select the source subscription and region.
72-
4. In **Destination**, select the region to which you want to move the VMs. Then click **Next**.
80+
4. In **Destination**, select the region to which you want to move the VMs. Then select **Next**.
7381

7482
![Page to select source and destination region](./media/tutorial-move-region-virtual-machines/source-target.png)
7583

76-
6. In **Resources to move**, click **Select resources**.
77-
7. In **Select resources**, select the VM. You can only add [resources supported for move](#prepare-vms). Then click **Done**.
84+
6. In **Resources to move**, select **Select resources**.
85+
7. In **Select resources**, select the VM. You can only add the [resources supported for the move](#prepare-vms). Then select **Done**.
7886

7987
![Page to select VMs to move](./media/tutorial-move-region-virtual-machines/select-vm.png)
8088

81-
8. In **Resources to move**, click **Next**.
82-
9. In **Review**, check the source and destination settings.
89+
8. In **Resources to move**, select **Next**.
90+
9. In **Review**, check the source and the destination settings.
8391

8492
![Page to review settings and proceed with move](./media/tutorial-move-region-virtual-machines/review.png)
85-
10. Click **Proceed**, to begin adding the resources.
86-
11. After the add process finishes successfully, click **Adding resources for move** in the notification icon.
87-
12. After clicking the notification, review the resources on the **Across regions** page.
93+
10. Select **Proceed** to begin adding the resources.
94+
11. After the add process finishes successfully, select **Adding resources for move** in the notification icon.
95+
12. After selecting the notification, review the resources on the **Across regions** page.
8896

8997
> [!NOTE]
9098
> - Added resources are in a *Prepare pending* state.
@@ -93,15 +101,16 @@ Select the resources you want to move.
93101
94102
## Resolve dependencies
95103

96-
1. If resources show a *Validate dependencies* message in the **Issues** column, click the **Validate dependencies** button. The validation process begins.
97-
2. If dependencies are found, click **Add dependencies**.
104+
To resolve dependencies before the move, follow these steps:
105+
106+
1. If resources show a *Validate dependencies* message in the **Issues** column, select the **Validate dependencies** button. The validation process begins.
107+
2. If dependencies are found, select **Add dependencies**.
98108
3. In **Add dependencies**, leave the default **Show all dependencies** option.
99109

100110
- Show all dependencies and iterates through all of the direct and indirect dependencies for a resource. For example, for a VM it shows the NIC, virtual network, network security groups (NSGs), etc.
101111
- Show first-level dependencies only shows only direct dependencies. For example, for a VM it shows the NIC, but not the virtual network.
102112

103-
104-
4. Select the dependent resources you want to add > **Add dependencies**. Monitor progress in the notifications.
113+
4. Select the dependent resources you want to add > **Add dependencies**. Monitor the progress in the notifications.
105114

106115
![Add dependencies](./media/tutorial-move-region-virtual-machines/add-dependencies.png)
107116

@@ -111,7 +120,7 @@ Select the resources you want to move.
111120

112121
## Move the source resource group
113122

114-
Before you can prepare and move VMs, the VM resource group must be present in the target region.
123+
Before you can prepare and move the VMs, the VM resource group must be present in the target region.
115124

116125
### Prepare to move the source resource group
117126

@@ -120,7 +129,7 @@ During the Prepare process, Resource Mover generates Azure Resource Manager (ARM
120129
Prepare as follows:
121130

122131
1. In **Across regions**, select the source resource group > **Prepare**.
123-
2. In **Prepare resources**, click **Prepare**.
132+
2. In **Prepare resources**, select **Prepare**.
124133

125134
![Prepare resource group](./media/tutorial-move-region-virtual-machines/prepare-resource-group.png)
126135

@@ -130,18 +139,18 @@ Prepare as follows:
130139

131140
### Move the source resource group
132141

133-
Initiate the move as follows:
142+
Start the move as follows:
134143

135144
1. In **Across regions**, select the resource group > **Initiate Move**
136-
2. ln **Move Resources**, click **Initiate move**. The resource group moves into an *Initiate move in progress* state.
145+
2. ln **Move Resources**, select **Initiate move**. The resource group moves into an *Initiate move in progress* state.
137146
3. After initiating the move, the target resource group is created, based on the generated ARM template. The source resource group moves into a *Commit move pending* state.
138147

139-
![Click the initiate move button](./media/tutorial-move-region-virtual-machines/commit-move-pending.png)
148+
![select the initiate move button](./media/tutorial-move-region-virtual-machines/commit-move-pending.png)
140149

141150
To commit and finish the move process:
142151

143152
1. In **Across regions**, select the resource group > **Commit move**.
144-
2. ln **Move Resources**, click **Commit**.
153+
2. ln **Move Resources**, select **Commit**.
145154

146155
> [!NOTE]
147156
> After committing the move, the source resource group is in a *Delete source pending* state.
@@ -150,7 +159,7 @@ To commit and finish the move process:
150159

151160
Now that the source resource group is moved, you can prepare to move other resources that are in the *Prepare pending* state.
152161

153-
1. In **Across regions**, verify that resources are now in a *Prepare pending* state, with no issues. If they're not, validate again and resolve any outstanding issues.
162+
1. In **Across regions**, verify that the resources are now in a *Prepare pending* state, with no issues. If they're not, validate again and resolve any outstanding issues.
154163

155164
![Page showing resources in prepare pending state](./media/tutorial-move-region-virtual-machines/prepare-pending.png)
156165

@@ -175,12 +184,12 @@ Now that the source resource group is moved, you can prepare to move the other r
175184

176185
## Initiate the move
177186

178-
With resources prepared, you can now initiate the move.
187+
With resources prepared, you can now initiate the move. To start the move, follow these steps:
179188

180-
1. In **Across regions**, select resources with state *Initiate move pending*. Then click **Initiate move**.
181-
2. In **Move resources**, click **Initiate move**.
189+
1. In **Across regions**, select resources with state *Initiate move pending*. Then select **Initiate move**.
190+
2. In **Move resources**, select **Initiate move**.
182191

183-
![Click for the initiate move button](./media/tutorial-move-region-virtual-machines/initiate-move.png)
192+
![select for the initiate move button](./media/tutorial-move-region-virtual-machines/initiate-move.png)
184193

185194
3. Track move progress in the notifications bar.
186195

@@ -194,7 +203,7 @@ With resources prepared, you can now initiate the move.
194203

195204
## Discard or commit?
196205

197-
After the initial move, you can decide whether you want to commit the move or discard it.
206+
After the initial move, you can decide if you want to commit the move or discard it.
198207

199208
- **Discard**: You might discard a move if you're testing, and you don't want to actually move the source resource. Discarding the move returns the resource to a state of *Initiate move pending*.
200209
- **Commit**: Commit completes the move to the target region. After committing, a source resource will be in a state of *Delete source pending*, and you can decide if you want to delete it.
@@ -204,8 +213,8 @@ After the initial move, you can decide whether you want to commit the move or di
204213

205214
You can discard the move as follows:
206215

207-
1. In **Across regions**, select resources with state *Commit move pending*, and click **Discard move**.
208-
2. In **Discard move**, click **Discard**.
216+
1. In **Across regions**, select resources with state *Commit move pending*, and select **Discard move**.
217+
2. In **Discard move**, select **Discard**.
209218
3. Track move progress in the notifications bar.
210219

211220

@@ -214,10 +223,10 @@ You can discard the move as follows:
214223
215224
## Commit the move
216225

217-
If you want to complete the move process, commit the move.
226+
If you want to complete the move process, commit the move. To commit the move, follow these steps:
218227

219-
1. In **Across regions**, select resources with state *Commit move pending*, and click **Commit move**.
220-
2. In **Commit resources**, click **Commit**.
228+
1. In **Across regions**, select resources with state *Commit move pending*, and select **Commit move**.
229+
2. In **Commit resources**, select **Commit**.
221230

222231
![Page to commit resources to finalize move](./media/tutorial-move-region-virtual-machines/commit-resources.png)
223232

@@ -233,6 +242,8 @@ If you want to complete the move process, commit the move.
233242

234243
## Configure settings after the move
235244

245+
Configure the following settings after the move process:
246+
236247
- The Mobility service isn't uninstalled automatically from VMs. Uninstall it manually, or leave it if you plan to move the server again.
237248
- Modify Azure role-based access control (Azure RBAC) rules after the move.
238249

@@ -244,24 +255,28 @@ After the move, you can optionally delete resources in the source region.
244255
> [!NOTE]
245256
> A few resources, for example key vaults and SQL Server servers, can't be deleted from the portal, and must be deleted from the resource property page.
246257
247-
1. In **Across Regions**, click the name of the source resource that you want to delete.
258+
1. In **Across Regions**, select the name of the source resource that you want to delete.
248259
2. Select **Delete source**.
249260

250261
## Delete additional resources created for move
251262

252-
After the move, you can manually delete the move collection, and Site Recovery resources that were created.
263+
After the move, you can manually delete the move collection and Site Recovery resources that were created.
264+
265+
Before you delete the additional resources created for the move, note that:
253266

254267
- The move collection is hidden by default. To see it you need to turn on hidden resources.
255268
- The cache storage has a lock that must be deleted, before it can be deleted.
256269

257-
Delete as follows:
270+
To delete the additional resources created for the move, follow these steps:
271+
258272
1. Locate the resources in resource group ```RegionMoveRG-<sourceregion>-<target-region>```.
259273
2. Check that all the VM and other source resources in the source region have been moved or deleted. This ensures that there are no pending resources using them.
260274
2. Delete the resources:
261275

262276
- The move collection name is ```movecollection-<sourceregion>-<target-region>```.
263277
- The cache storage account name is ```resmovecache<guid>```
264278
- The vault name is ```ResourceMove-<sourceregion>-<target-region>-GUID```.
279+
265280
## Next steps
266281

267282
In this tutorial, you:
@@ -270,7 +285,4 @@ In this tutorial, you:
270285
> * Moved Azure VMs to another Azure region.
271286
> * Moved resources associated with VMs to another region.
272287
273-
Now, trying moving Azure SQL databases and elastic pools to another region.
274-
275-
> [!div class="nextstepaction"]
276-
> [Move Azure SQL resources](./tutorial-move-region-sql.md)
288+
Now, try [moving Azure SQL databases and elastic pools to another region](./tutorial-move-region-sql.md).

0 commit comments

Comments
 (0)