Skip to content

Commit edb0f3f

Browse files
authored
Merge pull request #207633 from roygara/unMEL
Terminology change
2 parents 267923c + 67ac486 commit edb0f3f

File tree

3 files changed

+47
-47
lines changed

3 files changed

+47
-47
lines changed

articles/virtual-machines/linux/convert-unmanaged-to-managed-disks.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Convert a Linux VM from unmanaged disks to managed disks
3-
description: How to convert a Linux VM from unmanaged disks to managed disks by using Azure CLI.
2+
title: Migrate a Linux VM from unmanaged disks to managed disks
3+
description: How to Migrate a Linux VM from unmanaged disks to managed disks by using Azure CLI.
44
author: roygara
55
ms.service: storage
66
ms.collection: linux
@@ -10,47 +10,47 @@ ms.author: rogarana
1010
ms.subservice: disks
1111
---
1212

13-
# Convert a Linux virtual machine from unmanaged disks to managed disks
13+
# Migrate a Linux virtual machine from unmanaged disks to managed disks
1414

1515
**Applies to:** :heavy_check_mark: Linux VMs
1616

17-
If you have existing Linux virtual machines (VMs) that use unmanaged disks, you can convert the VMs to use [Azure Managed Disks](../managed-disks-overview.md). This process converts both the OS disk and any attached data disks.
17+
If you have existing Linux virtual machines (VMs) that use unmanaged disks, you can migrate the VMs to use [Azure Managed Disks](../managed-disks-overview.md). This process converts both the OS disk and any attached data disks.
1818

19-
This article shows you how to convert VMs by using the Azure CLI. If you need to install or upgrade it, see [Install Azure CLI](/cli/azure/install-azure-cli).
19+
This article shows you how to migrate VMs by using the Azure CLI. If you need to install or upgrade it, see [Install Azure CLI](/cli/azure/install-azure-cli).
2020

2121
## Before you begin
2222
* Review [the FAQ about migration to Managed Disks](../faq-for-disks.yml).
2323

2424
[!INCLUDE [virtual-machines-common-convert-disks-considerations](../../../includes/virtual-machines-common-convert-disks-considerations.md)]
2525

26-
* The original VHDs and the storage account used by the VM before conversion are not deleted. They continue to incur charges. To avoid being billed for these artifacts, delete the original VHD blobs after you verify that the conversion is complete. If you need to find these unattached disks in order to delete them, see our article [Find and delete unattached Azure managed and unmanaged disks](find-unattached-disks.md).
26+
* The original VHDs and the storage account used by the VM before migration are not deleted. They continue to incur charges. To avoid being billed for these artifacts, delete the original VHD blobs after you verify that the migration is complete. If you need to find these unattached disks in order to delete them, see our article [Find and delete unattached Azure managed and unmanaged disks](find-unattached-disks.md).
2727

28-
## Convert single-instance VMs
29-
This section covers how to convert single-instance Azure VMs from unmanaged disks to managed disks. (If your VMs are in an availability set, see the next section.) You can use this process to convert the VMs from premium (SSD) unmanaged disks to premium managed disks, or from standard (HDD) unmanaged disks to standard managed disks.
28+
## Migrate single-instance VMs
29+
This section covers how to migrate single-instance Azure VMs from unmanaged disks to managed disks. (If your VMs are in an availability set, see the next section.) You can use this process to migrate the VMs from premium (SSD) unmanaged disks to premium managed disks, or from standard (HDD) unmanaged disks to standard managed disks.
3030

3131
1. Deallocate the VM by using [az vm deallocate](/cli/azure/vm). The following example deallocates the VM named `myVM` in the resource group named `myResourceGroup`:
3232

3333
```azurecli
3434
az vm deallocate --resource-group myResourceGroup --name myVM
3535
```
3636
37-
2. Convert the VM to managed disks by using [az vm convert](/cli/azure/vm). The following process converts the VM named `myVM`, including the OS disk and any data disks:
37+
2. Migrate the VM to managed disks by using [az vm convert](/cli/azure/vm). The following process converts the VM named `myVM`, including the OS disk and any data disks:
3838
3939
```azurecli
4040
az vm convert --resource-group myResourceGroup --name myVM
4141
```
4242
43-
3. Start the VM after the conversion to managed disks by using [az vm start](/cli/azure/vm). The following example starts the VM named `myVM` in the resource group named `myResourceGroup`.
43+
3. Start the VM after the migration to managed disks by using [az vm start](/cli/azure/vm). The following example starts the VM named `myVM` in the resource group named `myResourceGroup`.
4444
4545
```azurecli
4646
az vm start --resource-group myResourceGroup --name myVM
4747
```
4848
49-
## Convert VMs in an availability set
49+
## Migrate VMs in an availability set
5050
51-
If the VMs that you want to convert to managed disks are in an availability set, you first need to convert the availability set to a managed availability set.
51+
If the VMs that you want to migrate to managed disks are in an availability set, you first need to migrate the availability set to a managed availability set.
5252
53-
All VMs in the availability set must be deallocated before you convert the availability set. Plan to convert all VMs to managed disks after the availability set itself has been converted to a managed availability set. Then, start all the VMs and continue operating as normal.
53+
All VMs in the availability set must be deallocated before you migrate the availability set. Plan to migrate all VMs to managed disks after the availability set itself has been converted to a managed availability set. Then, start all the VMs and continue operating as normal.
5454
5555
1. List all VMs in an availability set by using [az vm availability-set list](/cli/azure/vm/availability-set). The following example lists all VMs in the availability set named `myAvailabilitySet` in the resource group named `myResourceGroup`:
5656
@@ -68,35 +68,35 @@ All VMs in the availability set must be deallocated before you convert the avail
6868
az vm deallocate --resource-group myResourceGroup --name myVM
6969
```
7070
71-
3. Convert the availability set by using [az vm availability-set convert](/cli/azure/vm/availability-set). The following example converts the availability set named `myAvailabilitySet` in the resource group named `myResourceGroup`:
71+
3. Migrate the availability set by using [az vm availability-set convert](/cli/azure/vm/availability-set). The following example converts the availability set named `myAvailabilitySet` in the resource group named `myResourceGroup`:
7272
7373
```azurecli
7474
az vm availability-set convert \
7575
--resource-group myResourceGroup \
7676
--name myAvailabilitySet
7777
```
7878
79-
4. Convert all the VMs to managed disks by using [az vm convert](/cli/azure/vm). The following process converts the VM named `myVM`, including the OS disk and any data disks:
79+
4. Migrate all the VMs to managed disks by using [az vm convert](/cli/azure/vm). The following process converts the VM named `myVM`, including the OS disk and any data disks:
8080
8181
```azurecli
8282
az vm convert --resource-group myResourceGroup --name myVM
8383
```
8484
85-
5. Start all the VMs after the conversion to managed disks by using [az vm start](/cli/azure/vm). The following example starts the VM named `myVM` in the resource group named `myResourceGroup`:
85+
5. Start all the VMs after the migration to managed disks by using [az vm start](/cli/azure/vm). The following example starts the VM named `myVM` in the resource group named `myResourceGroup`:
8686
8787
```azurecli
8888
az vm start --resource-group myResourceGroup --name myVM
8989
```
9090
91-
## Convert using the Azure portal
91+
## Migrate using the Azure portal
9292
93-
You can also convert unmanaged disks to managed disks using the Azure portal.
93+
You can also migrate unmanaged disks to managed disks using the Azure portal.
9494
9595
1. Sign in to the [Azure portal](https://portal.azure.com).
96-
2. Select the VM from the list of VMs in the portal.
97-
3. In the blade for the VM, select **Disks** from the menu.
98-
4. At the top of the **Disks** blade, select **Migrate to managed disks**.
99-
5. If your VM is in an availability set, there will be a warning on the **Migrate to managed disks** blade that you need to convert the availability set first. The warning should have a link you can click to convert the availability set. Once the availability set is converted or if your VM is not in an availability set, click **Migrate** to start the process of migrating your disks to managed disks.
96+
1. Select the VM from the list of VMs in the portal.
97+
1. In the blade for the VM, select **Disks** from the menu.
98+
1. At the top of the **Disks** blade, select **Migrate to managed disks**.
99+
1. If your VM is in an availability set, there will be a warning on the **Migrate to managed disks** blade that you need to migrate the availability set first. The warning should have a link you can click to migrate the availability set. Once the availability set is converted or if your VM is not in an availability set, click **Migrate** to start the process of migrating your disks to managed disks.
100100
101101
The VM will be stopped and restarted after migration is complete.
102102

articles/virtual-machines/windows/convert-unmanaged-to-managed-disks.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Convert a Windows virtual machine from unmanaged disks to managed disks
3-
description: How to convert a Windows VM from unmanaged disks to managed disks by using PowerShell in the Resource Manager deployment model
2+
title: Migrate a Windows virtual machine from unmanaged disks to managed disks
3+
description: How to migrate a Windows VM from unmanaged disks to managed disks by using PowerShell in the Resource Manager deployment model
44
author: roygara
55
ms.service: storage
66
ms.subservice: disks
@@ -9,11 +9,11 @@ ms.date: 07/12/2018
99
ms.author: rogarana
1010
---
1111

12-
# Convert a Windows virtual machine from unmanaged disks to managed disks
12+
# Migrate a Windows virtual machine from unmanaged disks to managed disks
1313

1414
**Applies to:** :heavy_check_mark: Windows VMs
1515

16-
If you have existing Windows virtual machines (VMs) that use unmanaged disks, you can convert the VMs to use managed disks through the [Azure Managed Disks](../managed-disks-overview.md) service. This process converts both the operating system (OS) disk and any attached data disks.
16+
If you have existing Windows virtual machines (VMs) that use unmanaged disks, you can migrate the VMs to use managed disks through the [Azure Managed Disks](../managed-disks-overview.md) service. This process converts both the operating system (OS) disk and any attached data disks.
1717

1818

1919
## Before you begin
@@ -25,11 +25,11 @@ If you have existing Windows virtual machines (VMs) that use unmanaged disks, yo
2525

2626
[!INCLUDE [virtual-machines-common-convert-disks-considerations](../../../includes/virtual-machines-common-convert-disks-considerations.md)]
2727

28-
* The original VHDs and the storage account used by the VM before conversion are not deleted. They continue to incur charges. To avoid being billed for these artifacts, delete the original VHD blobs after you verify that the conversion is complete. If you need to find these unattached disks in order to delete them, see our article [Find and delete unattached Azure managed and unmanaged disks](find-unattached-disks.md).
28+
* The original VHDs and the storage account used by the VM before migration are not deleted. They continue to incur charges. To avoid being billed for these artifacts, delete the original VHD blobs after you verify that the migration is complete. If you need to find these unattached disks in order to delete them, see our article [Find and delete unattached Azure managed and unmanaged disks](find-unattached-disks.md).
2929

3030

31-
## Convert single-instance VMs
32-
This section covers how to convert single-instance Azure VMs from unmanaged disks to managed disks. (If your VMs are in an availability set, see the next section.)
31+
## Migrate single-instance VMs
32+
This section covers how to migrate single-instance Azure VMs from unmanaged disks to managed disks. (If your VMs are in an availability set, see the next section.)
3333

3434
1. Deallocate the VM by using the [Stop-AzVM](/powershell/module/az.compute/stop-azvm) cmdlet. The following example deallocates the VM named `myVM` in the resource group named `myResourceGroup`:
3535

@@ -39,19 +39,19 @@ This section covers how to convert single-instance Azure VMs from unmanaged disk
3939
Stop-AzVM -ResourceGroupName $rgName -Name $vmName -Force
4040
```
4141

42-
2. Convert the VM to managed disks by using the [ConvertTo-AzVMManagedDisk](/powershell/module/az.compute/convertto-azvmmanageddisk) cmdlet. The following process converts the previous VM, including the OS disk and any data disks, and starts the Virtual Machine:
42+
2. Migrate the VM to managed disks by using the [ConvertTo-AzVMManagedDisk](/powershell/module/az.compute/convertto-azvmmanageddisk) cmdlet. The following process converts the previous VM, including the OS disk and any data disks, and starts the Virtual Machine:
4343

4444
```azurepowershell-interactive
4545
ConvertTo-AzVMManagedDisk -ResourceGroupName $rgName -VMName $vmName
4646
```
4747

4848

4949

50-
## Convert VMs in an availability set
50+
## Migrate VMs in an availability set
5151

52-
If the VMs that you want to convert to managed disks are in an availability set, you first need to convert the availability set to a managed availability set.
52+
If the VMs that you want to migrate to managed disks are in an availability set, you first need to migrate the availability set to a managed availability set.
5353

54-
1. Convert the availability set by using the [Update-AzAvailabilitySet](/powershell/module/az.compute/update-azavailabilityset) cmdlet. The following example updates the availability set named `myAvailabilitySet` in the resource group named `myResourceGroup`:
54+
1. Migrate the availability set by using the [Update-AzAvailabilitySet](/powershell/module/az.compute/update-azavailabilityset) cmdlet. The following example updates the availability set named `myAvailabilitySet` in the resource group named `myResourceGroup`:
5555

5656
```azurepowershell-interactive
5757
$rgName = 'myResourceGroup'
@@ -68,7 +68,7 @@ If the VMs that you want to convert to managed disks are in an availability set,
6868
Update-AzAvailabilitySet -AvailabilitySet $avSet -Sku Aligned
6969
```
7070

71-
2. Deallocate and convert the VMs in the availability set. The following script deallocates each VM by using the [Stop-AzVM](/powershell/module/az.compute/stop-azvm) cmdlet, converts it by using [ConvertTo-AzVMManagedDisk](/powershell/module/az.compute/convertto-azvmmanageddisk), and restarts it automatically as apart of the conversion process:
71+
2. Deallocate and migrate the VMs in the availability set. The following script deallocates each VM by using the [Stop-AzVM](/powershell/module/az.compute/stop-azvm) cmdlet, converts it by using [ConvertTo-AzVMManagedDisk](/powershell/module/az.compute/convertto-azvmmanageddisk), and restarts it automatically as apart of the migration process:
7272

7373
```azurepowershell-interactive
7474
$avSet = Get-AzAvailabilitySet -ResourceGroupName $rgName -Name $avSetName
@@ -84,21 +84,21 @@ If the VMs that you want to convert to managed disks are in an availability set,
8484

8585
## Troubleshooting
8686

87-
- Before converting, make sure all the VM extensions are in the 'Provisioning succeeded' state or the conversion will fail with the error code 409.
88-
- If there is an error during conversion, or if a VM is in a failed state because of issues in a previous conversion, run the `ConvertTo-AzVMManagedDisk` cmdlet again. A simple retry usually unblocks the situation.
89-
- If you are converting a Linux VM to managed disks, use the latest version of the Azure Linux Agent. Operations using Azure Linux Agent versions '2.2.0' and earlier will likely fail. Running the conversion on a generalized VM or a VM that belongs to a classic availability set is also not supported.
90-
- If the conversion fails with the "SnapshotCountExceeded" error, delete some snapshots and attempt the operation again.
87+
- Before converting, make sure all the VM extensions are in the 'Provisioning succeeded' state or the migration will fail with the error code 409.
88+
- If there is an error during migration, or if a VM is in a failed state because of issues in a previous migration, run the `ConvertTo-AzVMManagedDisk` cmdlet again. A simple retry usually unblocks the situation.
89+
- If you are converting a Linux VM to managed disks, use the latest version of the Azure Linux Agent. Operations using Azure Linux Agent versions '2.2.0' and earlier will likely fail. Running the migration on a generalized VM or a VM that belongs to a classic availability set is also not supported.
90+
- If the migration fails with the "SnapshotCountExceeded" error, delete some snapshots and attempt the operation again.
9191

9292

93-
## Convert using the Azure portal
93+
## Migrate using the Azure portal
9494

95-
You can also convert unmanaged disks to managed disks using the Azure portal.
95+
You can also migrate unmanaged disks to managed disks using the Azure portal.
9696

9797
1. Sign in to the [Azure portal](https://portal.azure.com).
9898
2. Select the VM from the list of VMs in the portal.
9999
3. In the blade for the VM, select **Disks** from the menu.
100100
4. At the top of the **Disks** blade, select **Migrate to managed disks**.
101-
5. If your VM is in an availability set, there will be a warning on the **Migrate to managed disks** blade that you need to convert the availability set first. The warning should have a link you can click to convert the availability set. Once the availability set is converted or if your VM is not in an availability set, click **Migrate** to start the process of migrating your disks to managed disks.
101+
5. If your VM is in an availability set, there will be a warning on the **Migrate to managed disks** blade that you need to migrate the availability set first. The warning should have a link you can click to migrate the availability set. Once the availability set is converted or if your VM is not in an availability set, click **Migrate** to start the process of migrating your disks to managed disks.
102102

103103
The VM will be stopped and restarted after migration is complete.
104104

0 commit comments

Comments
 (0)