Skip to content

Commit 1ec558e

Browse files
Merge pull request #288875 from b-ahibbard/patch-1
Cloud backup for VMs
2 parents ae255bc + ae40a2f commit 1ec558e

7 files changed

+343
-18
lines changed

articles/azure-netapp-files/whats-new.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,24 @@ author: b-hchen
66
ms.service: azure-netapp-files
77
ms.custom: linux-related-content
88
ms.topic: overview
9-
ms.date: 11/12/2024
9+
ms.date: 12/03/2024
1010
ms.author: anfdocs
1111
---
1212

1313
# What's new in Azure NetApp Files
1414

1515
Azure NetApp Files is updated regularly. This article provides a summary about the latest new features and enhancements.
1616

17+
## December 2024
18+
19+
* [Cloud Backup for Virtual Machines on Azure NetApp Files datastores for Azure VMware Solution:](../azure-vmware/install-cloud-backup-virtual-machines.md) enhanced backup capabilities (Preview)
20+
21+
Cloud Backup for Virtual Machines now integrates with [Azure NetApp Files backup](backup-introduction.md), significantly enhancing data protection by offering a fully managed backup solution for long-term recovery, archiving, and compliance. This integration allows you to mount a datastore from a snapshot or Azure NetApp Files backup to restore files. You can [mount the backup](../azure-vmware/configure-cloud-backup-virtual-machine.md) to either the Azure VMware Solution host where it was created or to an alternate host.
22+
23+
Cloud Backup for Virtual Machines now also includes the capability to [attach one or more VMDKs](../azure-vmware/configure-cloud-backup-virtual-machine.md) from a backup to the parent VM, to an alternate VM on the same Azure VMware Solution host, or to an alternate VM on an alternate host managed by the same vCenter instance.
24+
25+
Cloud Backup for Virtual Machines also enables you [to restore a virtual machine](../azure-vmware/restore-azure-netapp-files-vms.md) to an alternate location on the same Azure VMware Solution host or a different host managed by the same vCenter instance. Additionally, it supports [restoring guest files and folders from a snapshot or an Azure NetApp Files backup](../azure-vmware/restore-guest-files-folders.md).
26+
1727
## November 2024
1828

1929
* [Cool access support for large volumes](large-volumes-requirements-considerations.md#register-the-feature)

articles/azure-vmware/backup-azure-netapp-files-datastores-vms.md

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
---
2-
title: Back up Azure NetApp Files datastores and VMs using Cloud Backup (preview)
2+
title: Back up Azure NetApp Files datastores and VMs using Cloud Backup
33
description: Learn how to back up datastores and Virtual Machines to the cloud.
44
ms.topic: how-to
55
ms.service: azure-vmware
6-
ms.date: 3/22/2024
6+
ms.date: 12/03/2024
7+
ms.author: anfdocs
78
ms.custom: engagement-fy23
89
---
910

@@ -29,11 +30,14 @@ Before you back up your Azure NetApp Files datastores, you must add your Azure a
2930
"Microsoft.Resources/subscriptions/resourceGroups/resources/read",
3031
"Microsoft.Resources/subscriptions/resourceGroups/write",
3132
"Microsoft.Network/virtualNetworks/read",
33+
"Microsoft.Network/virtualNetworks/subnets/read",
3234
"Microsoft.Insights/Metrics/Read"
3335
],
3436
```
3537
For more information on creating custom roles, see [Azure custom roles](../role-based-access-control/custom-roles.md).
3638

39+
* You can't restore to an original location with Azure NetApp Files backup. If you're using Azure NetApp Files backup to restore, restore to an **Alternate location**.
40+
3741
### Add an Azure cloud subscription
3842

3943
1. Sign in to the VMware vSphere client.
@@ -53,20 +57,22 @@ Before you back up your Azure NetApp Files datastores, you must add your Azure a
5357
You must create backup policies before you can use Cloud Backup for Virtual Machines to back up Azure NetApp Files datastores and VMs.
5458

5559
1. In the left navigation of the vCenter web client page, select **Cloud Backup for Virtual Machines** > **Policies**.
56-
2. On the **Policies** page, select **Create** to initiate the wizard.
57-
3. On the **New Backup Policy** page, select the vCenter Server that uses the policy, then enter the policy name and a description.
58-
* **Only alphanumeric characters and underscores (_) are supported in VM, datastore, cluster, policy, backup, or resource group names.** Other special characters aren't supported.
59-
4. Specify the retention settings.
60-
The maximum retention value is 255 backups. If the **"Backups to keep"** option is selected during the backup operation, Cloud Backup for Virtual Machines retains backups within the specified retention count and delete the backups that exceed the retention count.
61-
5. Specify the frequency settings.
60+
1. On the **Policies** page, select **Create** to initiate the wizard.
61+
1. On the **New Backup Policy** page, select the vCenter Server that uses the policy, then enter the policy name and a description.
62+
* **Only alphanumeric characters and underscores (_) are supported in VM, datastore, cluster, policy, backup, or resource group names.** Other special characters aren't supported.
63+
1. Specify the retention settings.
64+
The maximum retention value is 255 backups. If the **Backups to keep** option is selected during the backup operation, Cloud Backup for Virtual Machines retains backups within the specified retention count and deletes the backups that exceed the retention count.
65+
1. Choose **Back up using Azure NetApp Files** if you want to use Azure NetApp Files as a backup. Specify the retention settings. If the "Backups to keep" option is selected, Cloud Backup for Virtual Machines retains backups within the specified retention count and deletes the backups that exceed the retention count. The maximum retention value is 255 backups.
66+
If so, provide a maximum retention value.
67+
1. Specify the frequency settings.
6268
The policy specifies the backup frequency only. The specific protection schedule for backing up is defined in the resource group. Therefore, two or more resource groups can share the same policy and backup frequency but have different backup schedules.
63-
6. **Optional:** In the **Advanced** fields, select the fields that are needed. The Advanced field details are listed in the following table.
69+
1. **Optional:** In the **Advanced** fields, select the fields that are needed. The Advanced field details are listed in the following table.
6470

6571
| Field | Action |
6672
| ---- | ---- |
6773
| VM consistency | Check this box to pause the VMs and create a VMware snapshot each time the backup job runs. <br> When you check the VM consistency box, backup operations might take longer and require more storage space. In this scenario, the VMs are first paused, then VMware performs a VM consistent snapshot. Cloud Backup for Virtual Machines then performs its backup operation, and then VM operations are resumed. <br> VM guest memory isn't included in VM consistency snapshots. |
6874
| Include datastores with independent disks | Check this box to include any datastores with independent disks that contain temporary data in your backup. |
69-
7. Select **Add** to save your policy.
75+
1. Select **Add** to save your policy.
7076
You can verify the policy was created successfully and review the configuration by selecting the policy in the **Policies** page.
7177

7278
## Resource groups
Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
title: Configure Cloud Backup for Virtual Machines
3+
description: Configure Cloud Backup for Virtual Machines enables you to mount and unmount datastores, and attach and detach VMDKs.
4+
ms.topic: how-to
5+
ms.service: azure-vmware
6+
ms.author: anfdocs
7+
ms.date: 12/03/2024
8+
ms.custom: engagement-fy24
9+
---
10+
11+
# Configure Cloud Backup for Virtual Machines (preview)
12+
13+
Learn how to mount and unmount datastores and attach and detach virtual machine disks (VMDKs) using Cloud Backup for Virtual Machines.
14+
15+
## Mount a backup
16+
17+
You can mount a traditional datastore from a backup if you want to access files in the backup. You can either mount the backup to the same ESXi host where the backup was created or to an alternate ESXi host that has the same type of VM and host configurations. You can mount a datastore multiple times on a host.
18+
19+
1. In the left navigation of the vCenter web client page, select **Storage**.
20+
2. Right-click a datastore then go to **Cloud Backup for Virtual Machines > Mount Backup**.
21+
3. On the **Mount Datastore** page, select a backup and a backup location (primary or Azure NetApp Files backup), then select **Finish**.
22+
4. Optional: To verify that the datastore is mounted, perform the following:
23+
1. Select **Menu** in the toolbar, and then select Storage from the drop-down list.
24+
2. The left navigator pane displays the datastore you mounted.
25+
26+
## Unmount a backup
27+
28+
You can unmount a backup when you no longer need to access the files in the datastore.
29+
30+
If a backup is listed as mounted in the VMware vSphere client GUI, but it's not listed in the unmount backup screen, you need to use the REST API endpoint `/backup/{backup-Id}/cleanup` to clean up the out-of-bound datastores. After cleanup, try the unmount procedure again.
31+
32+
1. In the left navigation of the vCenter web client page, select **Storage**.
33+
2. Right-click a datastore and then go to **Cloud Backup for Virtual Machines > Unmount**.
34+
35+
>[!NOTE]
36+
> Ensure that you have selected the correct datastore to unmount. Choosing the incorrect datastore can cause an impact on production work.
37+
38+
3. In the **Unmount Cloned Datastore** dialog box, select a datastore, select the Unmount the cloned datastore checkbox, then select **Unmount**.
39+
40+
## Attach VMDKs to a VM
41+
42+
You can attach one or more VMDKs from a backup to the parent VM, or to an alternate VM on the same ESXi host, or to an alternate VM on an alternate ESXi host managed by the same vCenter.
43+
44+
You have the following attach options:
45+
* You can attach virtual disks from a primary or an Azure NetApp Files backup.
46+
* You can attach virtual disks to the parent VM (the same VM that the virtual disk was originally associated with) or to an alternate VM on the same ESXi host.
47+
48+
### Considerations for attaching VMDKs
49+
50+
* Attach and detach operations aren't supported for Virtual Machine Templates.
51+
* You cannot manually attach a virtual disk that was attached or mounted as part of a guest file restore operation.
52+
53+
### Attach VMDKs
54+
55+
1. In the VMware vSphere client GUI, select **Menu** in the toolbar then **Hosts and clusters** from the drop-down list.
56+
2. In the left navigation pane, right-click a VM, then select **Cloud Backup for Virtual Machines > Attach virtual disk(s)**.
57+
3. On the **Attach Virtual Disk** window, in the Backup section, select a backup.
58+
59+
Filter the backup list by selecting the filter icon and choosing a date and time range, selecting whether you want backups that contain VMware Snapshots, whether you want mounted backups, and the location. Select OK.
60+
61+
4. In the **Select Disks** section, select one or more disks you want to attach and the location you want to attach from (primary or Azure NetApp Files backup).
62+
63+
Change the filter to display primary and Azure NetApp Files backup locations.
64+
65+
5. By default, the selected virtual disks are attached to the parent VM. To attach the selected virtual disks to an alternate VM in the same ESXi host, select **Click here to attach to alternate VM** and specify the alternate VM.
66+
6. Select **Attach**.
67+
7. Optional: Monitor the operation progress in the Recent Tasks section.
68+
69+
Refresh the screen to display updated information.
70+
71+
8. Verify that the virtual disk is attached by performing the following:
72+
1. Select **Menu** in the toolbar then **VMs and Templates** from the drop-down list.
73+
2. In the left navigator pane right-click a VM, then select **Edit settings** in the drop-down list.
74+
3. In the **Edit Settings** window, expand the list for each hard disk to display the list of disk files.
75+
76+
The Edit Settings page lists the disks on the VM. You can expand the details for each hard disk to display the list of attached virtual disks.
77+
78+
## Detach a virtual disk
79+
After you have attached a virtual disk to restore individual files, you can detach the virtual disk from the parent VM.
80+
81+
1. In the VMware vSphere client GUI, select **Menu** in the toolbar. Select **VMs and Templates** from the drop-down list.
82+
2. In the left navigator pane, select a VM.
83+
3. In the left navigation pane, right-click the VM, then select **Cloud Backup for Virtual Machines** in the drop-down list, and then select **Detach virtual disk** in the secondary drop-down list.
84+
4. On the **Detach Virtual Disk** screen, select one or more disks you want to detach, then select the **Detach the selected disk(s)** checkbox, and click **Detach**.
85+
86+
>[!NOTE]
87+
> Ensure that you select the correct virtual disk. Selecting the wrong disk might affect production work.
88+
89+
5. Optional: Monitor the operation progress in the Recent Tasks section.
90+
91+
Refresh the screen to display updated information.
92+
93+
6. Verify that the virtual disk is detached by performing the following:
94+
1. Select **Menu** in the toolbar then **VMs and Templates** from the drop-down list.
95+
2. In the left navigator pane, right-click a VM, then select **Edit settings** in the drop-down list.
96+
3. In the **Edit Settings** window, expand the list for each hard disk to display the list of disk files.
97+
98+
The Edit Settings page lists the disks on the VM. You can expand the details for each hard disk to display the list of attached virtual disks.
99+
100+
## Next steps
101+
102+
* [Back up Azure NetApp Files datastores and VMs using Cloud Backup for Virtual Machines](backup-azure-netapp-files-datastores-vms.md)
103+
* [Restore VMs using Cloud Backup for Virtual Machines](restore-azure-netapp-files-vms.md)

articles/azure-vmware/install-cloud-backup-virtual-machines.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
---
2-
title: Install Cloud Backup for Virtual Machines (preview)
2+
title: Install Cloud Backup for Virtual Machines
33
description: Cloud Backup for Virtual Machines is a plug-in installed in the Azure VMware Solution and enables you to back up and restore Azure NetApp Files datastores and virtual machines.
44
ms.topic: how-to
5+
ms.author: anfdocs
56
ms.service: azure-vmware
6-
ms.date: 3/22/2023
7+
ms.date: 12/03/2024
78
ms.custom: engagement-fy23
89
---
910

articles/azure-vmware/restore-azure-netapp-files-vms.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
---
2-
title: Restore VMs using Cloud Backup for Virtual Machines (preview)
2+
title: Restore VMs using Cloud Backup for Virtual Machines
33
description: Learn how to restore virtual machines from a cloud backup to the vCenter.
44
ms.topic: how-to
5+
ms.author: anfdocs
56
ms.service: azure-vmware
6-
ms.date: 12/19/2023
7+
ms.date: 12/03/2024
78
ms.custom: engagement-fy23
89
---
910

@@ -20,8 +21,13 @@ This article covers how to:
2021
## Restore VMs from backups
2122

2223
When you restore a VM, you can overwrite the existing content with the backup copy that you select or you can restore a deleted VM from a backup copy.
23-
24-
You can restore VMs to the original datastore mounted on the original ESXi host, which overwrites the original VM.
24+
You can restore VMs to the following locations:
25+
* Restore to original location
26+
* To the original datastore mounted on the original ESXi host (this overwrites the original VM)
27+
* Restore to alternate location
28+
* To a different datastore mounted on the original ESXi host
29+
* To the original datastore mounted on a different ESXi host that is managed by the same vCenter
30+
* To a different datastore mounted on a different ESXi host that is managed by the same vCenter
2531

2632
## Prerequisites to restore VMs
2733

@@ -131,4 +137,4 @@ If you need to change the MySQL database backup configuration, you can modify:
131137
1. From the Application Configuration menu, enter option **6 MySQL backup and restore**.
132138
1. From the MySQL Backup & Restore Configuration, menu, enter option **1 Configure MySQL backup**.
133139

134-
:::image type="content" source="./media/cloud-backup/mysql-backup-configuration.png" alt-text="Screenshot of the CLI maintenance menu depicting menu options." lightbox="./media/cloud-backup/mysql-backup-configuration.png":::
140+
:::image type="content" source="./media/cloud-backup/mysql-backup-configuration.png" alt-text="Screenshot of the CLI maintenance menu depicting menu options." lightbox="./media/cloud-backup/mysql-backup-configuration.png":::

0 commit comments

Comments
 (0)