Skip to content

Commit ffb3740

Browse files
added screens and section intro
1 parent f86422b commit ffb3740

7 files changed

+26
-15
lines changed

articles/backup/backup-azure-manage-vms.md

Lines changed: 26 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -196,6 +196,8 @@ To protect your data, Azure Backup includes the soft delete feature. With soft d
196196

197197
## Uninstall and re-install the VMSnapshot extension on Windows operating system
198198

199+
If you 're experiencing Azure VM backup or extension failure issues, uninstall and reinstall the `VMSnapshot` extension on a Windows VM. This extension is responsible for enabling application-consistent snapshots during backup operations. Since it’s a hidden extension, the process involves manually cleaning up registry entries and plugin folders, followed by restarting the Azure Guest Agent. After the registry is cleaned, the extension automatically reinstalls during the next backup job.
200+
199201
To uninstall and re-install the VMSnapshot extension on Windows operating system for the backup operation, follow these steps:
200202

201203
1. Uninstall the `VMSnapshot` extension by running the following cmdlet:
@@ -204,17 +206,28 @@ To uninstall and re-install the VMSnapshot extension on Windows operating system
204206
Remove-AzVMExtension -ResourceGroupName "<Azure VM's resource group name>" -<VMName "Azure VM name>" -Name "VMSnapshot"
205207
```
206208
207-
2. Sign in to the Azure VM, right-click the Windows **Start** icon to open the **Run** window, and then enter **services.msc** to open the **Services** window.
208-
3. On the Services window, stop the **Windows Azure Guest Agent** service.
209-
4. Go to the folder `C:\Packages\Plugins`, and then rename the folder `Microsoft.Azure.RecoveryServices.VMSnapshot` to `Microsoft.Azure.RecoveryServices.VMSnapshot_old`.
210-
5. Right-click the Windows **Start** icon, select **Run**, and then enter **regedit** to open the **Registry Editor**.
211-
6. On the **Registry Editor** window, go to *HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsAzure* and export to an alternate location before modifying for the backup operation.
212-
7. Go to *HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsAzure\HandlerState*, and delete `Microsoft.Azure.RecoveryServices.VMSnapshot_1.X.XX.X`.
209+
:::image type="content" source="./media/backup-azure-manage-vms/uninstall-backup-extension.png" alt-text="Screenshot shows the execution of the extension uninstall command." lightbox="./media/backup-azure-manage-vms/uninstall-backup-extension.png":::
210+
211+
1. Sign in to the Azure VM, right-click the Windows **Start** icon to open the **Run** window, and then enter **services.msc** to open the **Services** window.
212+
1. On the Services window, stop the **Windows Azure Guest Agent** service.
213+
214+
:::image type="content" source="./media/backup-azure-manage-vms/stop-windows-azure-guest-agent-service.png" alt-text="Screenshot shows the Windows Azure guest agent service is stopped." lightbox="./media/backup-azure-manage-vms/stop-windows-azure-guest-agent-service.png":::
215+
216+
1. Go to the folder `C:\Packages\Plugins`, and then rename the folder `Microsoft.Azure.RecoveryServices.VMSnapshot` to `Microsoft.Azure.RecoveryServices.VMSnapshot_old`.
217+
218+
1. Right-click the Windows **Start** icon, select **Run**, and then enter **regedit** to open the **Registry Editor**.
219+
1. On the **Registry Editor** window, go to *HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsAzure* and export to an alternate location before modifying for the backup operation.
220+
221+
:::image type="content" source="./media/backup-azure-manage-vms/export-registry-key.png" alt-text="Screenshot shows the registry key for export.":::
222+
223+
1. Go to *HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsAzure\HandlerState*, and delete `Microsoft.Azure.RecoveryServices.VMSnapshot_1.X.XX.X`.
213224
214225
>[!Note]
215-
>The plugin version **1.X.XX.X** might change based on your environment.
226+
>The backup extension version **1.X.XX.X** might change based on your environment.
227+
228+
:::image type="content" source="./media/backup-azure-manage-vms/delete-registry-key.png" alt-text="Screenshot shows the deletion of backup extension registry key values." lightbox="./media/backup-azure-manage-vms/delete-registry-key.png":::
216229
217-
8. Open the **Command prompt** as **Administrator** and add the required registry entries by running the following commands:
230+
1. Open the **Command prompt** as **Administrator** and add the required registry entries by running the following commands:
218231
219232
```
220233
REG ADD "HKLM\SOFTWARE\Microsoft\BcdrAgent" /v IsProviderInstalled /t REG_SZ /d False /f
@@ -224,16 +237,14 @@ To uninstall and re-install the VMSnapshot extension on Windows operating system
224237
REG ADD "HKLM\SOFTWARE\Microsoft\BcdrAgentPersistentKeys" /v IsCommonProviderInstalled /t REG_SZ /d False /f
225238
```
226239
227-
9. On the **Services** window, start **Windows Azure Guest Agent**.
228-
1. Restart the Azure VM.
229-
1. Run an on-demand backup of Azure VM; this operation installs a new `VMSnapshot` extension.
230-
231-
232-
233-
240+
:::image type="content" source="./media/backup-azure-manage-vms/install-backup-agent.png" alt-text="Screenshot shows the installation of backup agent." lightbox="./media/backup-azure-manage-vms/install-backup-agent.png":::
234241
242+
1. On the **Services** window, start **Windows Azure Guest Agent**.
235243
244+
:::image type="content" source="./media/backup-azure-manage-vms/start-windows-azure-guest-agent-service.png" alt-text="Screenshot shows the Windows Azure guest agent service is started." lightbox="./media/backup-azure-manage-vms/start-windows-azure-guest-agent-service.png":::
236245
246+
1. Restart the Azure VM.
247+
1. Run an on-demand backup of Azure VM; this operation installs a new `VMSnapshot` extension.
237248
238249
## Next steps
239250
182 KB
Loading
163 KB
Loading
114 KB
Loading
180 KB
Loading
193 KB
Loading
125 KB
Loading

0 commit comments

Comments
 (0)