Skip to content

Commit 90c81e1

Browse files
authored
Merge pull request #78413 from ThalathBhagya/master
added system state troubleshooting guide
2 parents f717f56 + e8090ef commit 90c81e1

File tree

7 files changed

+131
-1
lines changed

7 files changed

+131
-1
lines changed
Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
---
2+
title: Troubleshoot System State Backup with Azure Backup
3+
description: Troubleshoot issues in System State Backup.
4+
services: backup
5+
author: srinathvasireddy
6+
manager: sivan
7+
keywords: how to backup; backup system state
8+
ms.service: backup
9+
ms.topic: conceptual
10+
ms.date: 05/09/2019
11+
ms.author: srinathvasireddy
12+
---
13+
14+
# Troubleshoot System State Backup
15+
16+
This article describes solutions for issues that you might encounter while using System State Backup.
17+
18+
## Pre-requisite
19+
20+
Before we troubleshoot System State Backup with Azure Backup, ensure you preform the below pre-requisites check.
21+
22+
### Verify Windows Server Backup is installed
23+
24+
Ensure Windows Server Backup is installed and enabled in the server. To check the installation status, run the below PowerShell command:
25+
26+
```
27+
PS C:\> Get-WindowsFeature Windows-Server-Backup
28+
```
29+
If the output displays the **Install State** as **available**, then it means Windows Server backup feature is available for the installation but not installed on the server. However if Windows Server Backup is not installed, then use one of the below methods to install it.
30+
31+
**Method 1: Install Windows Server Backup using PowerShell**
32+
33+
To install Windows Server Backup using PowerShell, run the below command:
34+
35+
```
36+
PS C:\> Install-WindowsFeature -Name Windows-Server-Backup
37+
```
38+
39+
**Method 2: Install Windows Server Backup using Server Manager**
40+
41+
To install Windows Server Backup using Server Manager, perform the below:
42+
43+
1. In the **Sever Manger** and click **Add roles and features**. The **Add roles and features wizard** appears.
44+
45+
![Dashboard](./media/backup-azure-system-state-troubleshoot/server_management.jpg)
46+
47+
2. Select **Installation Type** and click **Next**.
48+
49+
![Installation Type](./media/backup-azure-system-state-troubleshoot/install_type.jpg)
50+
51+
3. Select a server from the server pool and click **Next**. In the Server Role, leave the default selection and click **Next**.
52+
4. Select **Windows Server Backup** in **Features** tab and click **Next**.
53+
54+
![features](./media/backup-azure-system-state-troubleshoot/features.png)
55+
56+
5. In the **Confirmation** tab, click **Install** to start the installation process.
57+
6. In the **Results** tab, it will display the Windows Server Backup feature is successfully installed on your Windows Server.
58+
59+
![result](./media/backup-azure-system-state-troubleshoot/results.jpg)
60+
61+
62+
### System Volume information permission
63+
64+
Ensure that the Local SYSTEM has full control on **System Volume Information** folder located in the volume where windows is installed. Usually this is **C:\System Volume Information**. Windows Server backup can fail if the above permissions are not set correctly
65+
66+
### Dependent services
67+
68+
Ensure the below services are in running state:
69+
70+
**Service Name** | **Startup Type**
71+
--- | ---
72+
Remote Procedure Call(RPC) | Automatic
73+
COM+ Event System(EventSystem) | Automatic
74+
System Event Notification Service(SENS) | Automatic
75+
Volume Shadow Copy(VSS) | Manual
76+
Microsoft Software Shadow Copy Provider(SWPRV) | Manual
77+
78+
### Validate Windows Server Backup status
79+
80+
To validate Windows Server Backup status, perform the below:
81+
82+
* Ensure WSB PowerShell is running
83+
84+
- Run `Get-WBJob` from an elevated PowerShell and make sure it does not return the following error:
85+
86+
> [!WARNING]
87+
> Get-WBJob: The term 'Get-WBJob' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
88+
89+
- If it fails with this error then re-install the Windows Server Backup feature on the server machine as mentioned in the step 1 prerequisites.
90+
91+
* Ensure WSB backup is working properly, by running the below command from elevated command prompt:
92+
93+
` wbadmin start systemstatebackup -backuptarget:X: -quiet `
94+
95+
> [!NOTE]
96+
>Replace X with the drive letter of the volume where you want to store the system state back up image.
97+
98+
- Periodically check the status of the job by running `Get-WBJob` command from elevated PowerShell
99+
- After backup job completes check the final status of the job by running `Get-WBJob -Previous 1` command
100+
101+
If the job fails, it indicates a WSB issue which would result in MARS agent System State Backups failure.
102+
103+
## Common Errors
104+
105+
### VSS Writer timeout error
106+
107+
| Symptom | Cause | Resolution
108+
| -- | -- | --
109+
| - MARS agent fails with error message: “WSB job failed with VSS errors. Check VSS event logs to resolve the failure”<br/><br/> - Following error log is present in VSS Application event logs: “A VSS writer has rejected an event with error 0x800423f2, the writer's timeout expired between the Freeze and Thaw events.”| VSS writer is unable to complete in time due to lack of CPU and memory resources on the machine <br/><br/> Another backup software is already using the VSS writer, as a result snapshot operation could not complete for this backup | Wait for CPU/memory to be freed up on system or abort processes taking too much memory/CPU and try the operation again <br/><br/> Wait for the ongoing backup to complete and try the operation at a later point when no backups are running on the machine
110+
111+
112+
### Insufficient disk space to grow shadow copies
113+
114+
| Symptom | Resolution
115+
| -- | --
116+
| - MARS agent fails with error message: Backup failed as the shadow copy volume could not grow due to insufficient disk space on volumes containing system files <br/><br/> - Following error/warning log is present in volsnap system event logs: “There was insufficient disk space on volume C: to grow the shadow copy storage for shadow copies of C: due to this failure all shadow copies of volume C: are at risk of being deleted” | - Free up space in the highlighted volume in the event log so that there is sufficient space for shadow copies to grow while backup is in progress <br/><br/> - While configuring shadow copy space we can restrict the amount of space used for shadow copy, for more information see this [article](https://docs.microsoft.com/previous-versions/windows/it-pro/windows-server-2012-r2-and-2012/cc788050(v=ws.11)#syntax)
117+
118+
119+
### EFI partition locked
120+
121+
| Symptom | Resolution
122+
| -- | --
123+
| MARS agent fails with error message: “System state back up failed as the EFI system partition is locked. This can be due to system partition access by a third-party security or back up software” | - If the issue is due to a third-party security software, then you need to contact the Anti Virus vendor so that they can allow MARS agent <br/><br/> - If a third-party backup software is running, then wait for it to finish and then retry back up
124+
125+
126+
## Next steps
127+
128+
- For more information about Windows system state in Resource Manager deployment, see [Back up Windows Server System State](backup-azure-system-state.md)

articles/backup/backup-support-matrix-iaas.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ Back up VMs in [availability sets](https://docs.microsoft.com/azure/virtual-mach
141141
Back up VMs in [availability zones](https://docs.microsoft.com/azure/availability-zones/az-overview) | Not supported.
142142
Back up VMs that are deployed with [Hybrid Use Benefit (HUB)](https://docs.microsoft.com/azure/virtual-machines/windows/hybrid-use-benefit-licensing) | Supported.
143143
Back up VMs that are deployed in a [scale set](https://docs.microsoft.com/azure/virtual-machine-scale-sets/overview) | Not supported.
144-
Back up VMs that are deployed from the [Azure Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/apps?filters=virtual-machine-images)<br/><br/> (Published by Microsoft, third party) | Supported.<br/><br/> The VM must be running a supported operating system.<br/><br/> When recovering files on the VM, you can restore only to a compatible OS (not an earlier or later OS).
144+
Back up VMs that are deployed from the [Azure Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/apps?filters=virtual-machine-images)<br/><br/> (Published by Microsoft, third party) | Supported.<br/><br/> The VM must be running a supported operating system.<br/><br/> When recovering files on the VM, you can restore only to a compatible OS (not an earlier or later OS). We do not restore the Azure Marketplace VMs backed as VMs, as these needs purchase information but only as Disks.
145145
Back up VMs that are deployed from a custom image (third-party) | Supported.<br/><br/> The VM must be running a supported operating system.<br/><br/> When recovering files on the VM, you can restore only to a compatible OS (not an earlier or later OS).
146146
Back up VMs that are migrated to Azure | Supported.<br/><br/> To back up the VM, the VM agent must be installed on the migrated machine.
147147
Back up Multi-VM consistency | Azure Backup does not provide data and application consistency across multiple VMs.
48.8 KB
Loading
75.3 KB
Loading
62.8 KB
Loading
61.5 KB
Loading

articles/backup/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,8 @@
252252
href: troubleshoot-azure-files.md
253253
- name: SQL Server
254254
href: backup-sql-server-azure-troubleshoot.md
255+
- name: System State
256+
href: backup-azure-system-state-troubleshoot.md
255257
- name: Monitor Azure Backup workloads
256258
items:
257259
- name: Using the Azure portal

0 commit comments

Comments
 (0)