Troubleshoot System State Backup

This article describes solutions for issues that you might come across while using System State Backup.

Basic troubleshooting

We recommend you perform the following validation steps, before you start troubleshooting System State backup:

Limitation

  • Recovering to different hardware using System State recovery isn't recommended by Microsoft
  • System State backup currently supports "on-premises" Windows servers. This functionality isn't available for Azure VMs.

Prerequisites

Before we troubleshoot System State Backup with Azure Backup, perform the following prerequisites check.

Verify Windows Server Backup is installed

Ensure Windows Server Backup is installed and enabled in the server. To check the installation status, run this PowerShell command:

Get-WindowsFeature Windows-Server-Backup

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 isn't installed, then use one of the methods below to install it.

Method 1: Install Windows Server Backup using PowerShell

To install Windows Server Backup using PowerShell, run the following command:

Install-WindowsFeature -Name Windows-Server-Backup

Method 2: Install Windows Server Backup using Server Manager

To install Windows Server Backup using Server Manager, perform the following steps:

  1. In Server Manger, select Add roles and features. The Add roles and features wizard appears.

    Dashboard

  2. Select Installation Type and select Next.

    Installation Type

  3. Select a server from the server pool and select Next. In the Server Role, leave the default selection and select Next.

  4. Select Windows Server Backup in Features tab and select Next.

    Select features window

  5. In the Confirmation tab, select Install to start the installation process.

  6. In the Results tab, it will display the Windows Server Backup feature is successfully installed on your Windows Server.

    Results of installation

System Volume information permission

Ensure that the Local SYSTEM has full control on the 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 permissions above aren't set correctly.

Dependent services

Ensure the services below are in the running state:

Service Name Startup Type
Remote Procedure Call(RPC) Automatic
COM+ Event System(EventSystem) Automatic
System Event Notification Service(SENS) Automatic
Volume Shadow Copy(VSS) Manual
Microsoft Software Shadow Copy Provider(SWPRV) Manual

Validate Windows Server Backup status

To validate Windows Server Backup status, perform the following steps:

  • Ensure WSB PowerShell is running

    • Run Get-WBJob from an elevated PowerShell and make sure it doesn't return the following error:

      Warning

      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.

      • If it fails with this error, then reinstall the Windows Server Backup feature on the server machine as mentioned in step 1 of the prerequisites.
    • Ensure WSB backup is working properly, by running the following command from an elevated command prompt:

      wbadmin start systemstatebackup -backuptarget:X: -quiet

      Note

      Replace X with the drive letter of the volume where you want to store the system state back up image.

      • Periodically check the status of the job by running Get-WBJob command from elevated PowerShell
      • After backup job completes check the final status of the job by running Get-WBJob -Previous 1 command

If the job fails, it indicates a WSB issue that would result in MARS agent System State Backups failure.

Common errors

VSS Writer timeout error

Symptom Cause Resolution
- MARS agent fails with error message: "WSB job failed with VSS errors. Check VSS event logs to resolve the failure"

- 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

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 the processes taking too much memory/CPU and try the operation again.

Wait for the ongoing backup to complete and try the operation at a later point when no backups are running on the machine.

Insufficient disk space to grow shadow copies

Symptom Resolution
- 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

- 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's sufficient space for shadow copies to grow while backup is in progress

- While configuring shadow copy space we can restrict the amount of space used for shadow copy. For more information, see this article

EFI partition locked

Symptom Resolution
MARS agent fails with error message: "System state backup 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

- If a third-party backup software is running, then wait for it to finish and then retry back up

Next steps