Troubleshoot Azure Backup Server

Use the information in the following tables to troubleshoot errors that you encounter while using Azure Backup Server.

Basic troubleshooting

We recommend you perform the following validation, before you start troubleshooting Microsoft Azure Backup Server (MABS):

Configure antivirus for MABS server

MABS is compatible with most popular antivirus software products. We recommend the following steps to avoid conflicts:

  1. Disable real-time monitoring - disable real-time monitoring by the antivirus software for the following:
    • C:\Program Files<MABS Installation path>\XSD folder
    • C:\Program Files<MABS Installation path>\Temp folder
    • Drive letter of Modern Backup Storage volume
    • Replica and transfer logs: To do this, disable real-time monitoring of dpmra.exe, which is located in the folder Program Files\Microsoft Azure Backup Server\DPM\DPM\bin. Real-time monitoring degrades performance because the antivirus software scans the replicas each time MABS synchronizes with the protected server, and scans all affected files each time MABS applies changes to the replicas.
    • Administrator console: To avoid an impact on performance, disable real-time monitoring of the csc.exe process. The csc.exe process is the C# compiler, and real-time monitoring can degrade the performance because the antivirus software scans files that the csc.exe process emits when it generates XML messages. CSC.exe is located in the following paths:
      • \Windows\Microsoft.net\Framework\v2.0.50727\csc.exe
      • \Windows\Microsoft.NET\Framework\v4.0.30319\csc.exe
    • For the MARS agent installed on the MABS server, we recommend that you exclude the following files and locations:
      • C:\Program Files\Microsoft Azure Backup Server\DPM\MARS\Microsoft Azure Recovery Services Agent\bin\cbengine.exe as a process.
      • C:\Program Files\Microsoft Azure Backup Server\DPM\MARS\Microsoft Azure Recovery Services Agent as a folder.
      • Scratch location (if you're not using the standard location).
  2. Disable real-time monitoring on the protected server: Disable the real-time monitoring of dpmra.exe, which is located in the folder C:\Program Files\Microsoft Data Protection Manager\DPM\bin, on the protected server.
  3. Configure anti-virus software to delete the infected files on protected servers and the MABS server: To prevent data corruption of replicas and recovery points, configure the antivirus software to delete infected files, rather than automatically cleaning or quarantining them. Automatic cleaning and quarantining might cause the antivirus software to modify files, making changes that MABS can't detect.

You should run a manual synchronization with a consistency. Check the job each time that the antivirus software deletes a file from the replica, even though the replica is marked as inconsistent.

MABS installation folders

The default installation folders for DPM are as follows:

  • C:\Program Files\Microsoft Azure Backup Server\DPM\DPM

You can also run the following command to find the install folder path:

Reg query "HKLM\SOFTWARE\Microsoft\Microsoft Data Protection Manager\Setup"

Invalid vault credentials provided

Operation Error details Workaround
Registering to a vault Invalid vault credentials provided. The file is corrupted or doesn't have the latest credentials associated with the recovery service. Recommended action:
  • Download the latest credentials file from the vault and try again.
    (OR)
  • If the previous action didn't work, try downloading the credentials to a different local directory or create a new vault.
    (OR)
  • Try updating the date and time settings as described in this article.
    (OR)
  • Check to see if c:\windows\temp has more than 65000 files. Move stale files to another location or delete the items in the Temp folder.
    (OR)
  • Check the status of certificates.
    a. Open Manage Computer Certificates (in Control Panel).
    b. Expand the Personal node and its child node Certificates.
    c. Remove the certificate Windows Azure Tools.
    d. Retry the registration in the Azure Backup client.
    (OR)
  • Check to see if any group policy is in place.
  • To prevent errors during vault registration, ensure that you've the MARS agent version 2.0.9249.0 or above installed. If not, we recommend you to download and install the latest version from here.

Replica is inconsistent

Operation Error details Workaround
Backup Replica is inconsistent Verify that the automatic consistency check option in the Protection Group Wizard is turned on. For more information about replication options and consistency checks, see this article .
  1. In the case of System State/BMR backup, verify that Windows Server Backup is installed on the protected server.
  2. Check for space-related issues in the DPM storage pool on the DPM/Microsoft Azure Backup Server, and allocate storage as required.
  3. Check the state of the Volume Shadow Copy Service on the protected server. If it's in a disabled state, set it to start manually. Start the service on the server. Then go back to the DPM/Microsoft Azure Backup Server console, and start the sync with the consistency check job.

Online recovery point creation failed

Operation Error details Workaround
Backup Online recovery point creation failed Error Message: Windows Azure Backup Agent was unable to create a snapshot of the selected volume.
Workaround: Try increasing the space in replica and recovery point volume.

Error Message: The Windows Azure Backup Agent can't connect to the OBEngine service
Workaround: verify that the OBEngine exists in the list of running services on the computer. If the OBEngine service isn't running, use the "net start OBEngine" command to start the OBEngine service.

Error Message: The encryption passphrase for this server isn't set. Please configure an encryption passphrase.
Workaround: Try configuring an encryption passphrase. If it fails, take the following steps:
  1. Verify that the scratch location exists. This is the location that's mentioned in the registry HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Azure Backup\Config, with the name ScratchLocation should exist.
  2. If the scratch location exists, try re-registering by using the old passphrase. Whenever you configure an encryption passphrase, save it in a secure location.

    The original and external DPM servers must be registered to the same vault

    Operation Error details Workaround
    Restore Error code: CBPServerRegisteredVaultDontMatchWithCurrent/Vault Credentials Error: 100110

    Error message: The original and external DPM servers must be registered to the same vault
    Cause: This issue occurs when you're trying to restore files to the alternate server from the original server using the External DPM recovery option, and if the server that's being recovered and the original server from where the data is backed-up aren't associated with the same Recovery Services vault.

    Workaround: To resolve this issue, ensure both the original and alternate servers are registered to the same vault.

    Online recovery point creation jobs for VMware VM fail

    Operation Error details Workaround
    Backup Online recovery point creation jobs for VMware VM fail. DPM encountered an error from VMware while trying to get ChangeTracking information. ErrorCode - FileFaultFault (ID 33621)
    1. Reset the CTK on VMware for the affected VMs.
    2. Check that independent disk isn't in place on VMware.
    3. Stop protection for the affected VMs and reprotect with the Refresh button.
    4. Run a CC for the affected VMs.

    The agent operation failed because of a communication error with the DPM agent coordinator service on the server

    Operation Error details Workaround
    Pushing agent(s) to protected servers The agent operation failed because of a communication error with the DPM Agent Coordinator service on <ServerName>. If the recommended action shown in the product doesn't work, then perform the following steps:
    • If you're attaching a computer from an untrusted domain, follow these steps.
      (OR)
    • If you're attaching a computer from a trusted domain, troubleshoot using the steps outlined in this blog.
      (OR)
    • Try disabling antivirus as a troubleshooting step. If it resolves the issue, modify the antivirus settings as suggested in this article.

    Setup could not update registry metadata

    Operation Error details Workaround
    Installation Setup could not update registry metadata. This update failure could lead to overusage of storage consumption. To avoid this update the ReFS Trimming registry entry. Adjust the registry key SYSTEM\CurrentControlSet\Control\FileSystem\RefsEnableInlineTrim. Set the value Dword to 1.
    Installation Setup could not update registry metadata. This update failure could lead to overusage of storage consumption. To avoid this, update the Volume SnapOptimization registry entry. Create the registry key SOFTWARE\Microsoft Data Protection Manager\Configuration\VolSnapOptimization\WriteIds with an empty string value.
    Operation Error details Workaround
    Pushing agent(s) to protected servers The credentials that are specified for the server are invalid. If the recommended action that's shown in the product doesn't work, take the following steps:
    Try to install the protection agent manually on the production server as specified in this article.
    Azure Backup Agent was unable to connect to the Azure Backup service (ID: 100050) The Azure Backup Agent was unable to connect to the Azure Backup service. If the recommended action that's shown in the product doesn't work, take the following steps:
    1. Run the following command from an elevated prompt: psexec -i -s "c:\Program Files\Internet Explorer\iexplore.exe. This opens the Internet Explorer window.
    2. Go to Tools > Internet Options > Connections > LAN settings.
    3. Change the settings to use a proxy server. Then provide the proxy server details.
    4. If your machine has limited internet access, ensure that firewall settings on the machine or proxy allow these URLs and IP address.
    Azure Backup Agent installation failed The Microsoft Azure Recovery Services installation failed. All changes that were made to the system by the Microsoft Azure Recovery Services installation were rolled back. (ID: 4024) Manually install Azure Agent.
    Server registration status verification with Microsoft Azure Backup failed. The server registration status could not be verified with Microsoft Azure Backup. Verify that you are connected to the internet and that the proxy settings are configured correctly. You'll encounter this issue when the MARS agent can't contact Azure services. To resolve this issue:

    - Ensure network connectivity and proxy settings.

    - Ensure that you are running the latest MARS agent.

    - Ensure your server is running on TLS 1.2.

    Configuring protection group

    Operation Error details Workaround
    Configuring protection groups DPM could not enumerate the application component on the protected computer (protected computer name). Select Refresh on the configure protection group UI screen at the relevant datasource/component level.
    Configuring protection groups Unable to configure protection If the protected server is a SQL server, verify that the sysadmin role permissions have been provided to the system account (NTAuthority\System) on the protected computer as described in this article.
    Configuring protection groups There is insufficient free space in the storage pool for this protection group. The disks that are added to the storage pool should not contain a partition. Delete any existing volumes on the disks. Then add them to the storage pool.
    Policy change The backup policy could not be modified. Error: The current operation failed due to an internal service error [0x29834]. Please retry the operation after some time has passed. If the issue persists, contact Microsoft support. Cause:
    This error occurs under three conditions: when security settings are enabled, when you try to reduce retention range below the minimum values specified previously, and when you're on an unsupported version. (Unsupported versions are those lower than Microsoft Azure Backup Server version 2.0.9052 and Azure Backup Server update 1.)
    Recommended action:
    To proceed with policy-related updates, set the retention period above the minimum retention period specified. (The minimum retention period is seven days for daily, four weeks for weekly, three weeks for monthly or one year for yearly.)

    Optionally, another preferred approach is to update the backup agent and Azure Backup Server to leverage all the security updates.

    Backup

    Operation Error details Workaround
    Backup An unexpected error occurred while the job was running. The device is not ready. If the recommended action that's shown in the product doesn't work, take the following steps:
    • Set the Shadow Copy Storage space to unlimited on the items in the protection group, and then run the consistency check.
    • (OR)
    • Try deleting the existing protection group and creating multiple new groups. Each new protection group should have an individual item in it.
    Backup If you are backing up only system state, verify that there is enough free space on the protected computer to store the system state backup.
    1. Verify that Windows Server Backup is installed on the protected machine.
    2. Verify that there is enough space on the protected computer for the system state. The easiest way to verify this is to go to the protected computer, open Windows Server Backup, click through the selections, and then select BMR. The UI then tells you how much space is required. Open WSB > Local backup > Backup schedule > Select Backup Configuration > Full server (size is displayed). Use this size for verification.
    Backup Back up failure for BMR If the BMR size is large, move some application files to the OS drive and retry.
    Backup The option to reprotect a VMware VM on a new Microsoft Azure Backup Server does not show as available to add. VMware properties are pointed at an old, retired instance of Microsoft Azure Backup Server. To resolve this issue:
    1. In VCenter (SC-VMM equivalent), go to the Summary tab, and then to Custom Attributes.
    2. Delete the old Microsoft Azure Backup Server name from the DPMServer value.
    3. Go back to the new Microsoft Azure Backup Server and modify the PG. After you select the Refresh button, the VM appears with a check box as available to add to protection.
    Backup Error while accessing files/shared folders Try modifying the antivirus settings as suggested in this article Run antivirus software on the DPM server.

    Change passphrase

    Operation Error details Workaround
    Change passphrase The security PIN that was entered is incorrect. Provide the correct security PIN to complete this operation. Cause:
    This error occurs when you enter an invalid or expired security PIN while you're performing a critical operation (such as changing a passphrase).
    Recommended action:
    To complete the operation, you must enter a valid security PIN. To get the PIN, sign in to the Azure portal and go to the Recovery Services vault. Then go to Settings > Properties > Generate Security PIN. Use this PIN to change the passphrase.
    Change passphrase Operation failed. ID: 120002 Cause:
    This error occurs when security settings are enabled, or when you try to change the passphrase when you're using an unsupported version.
    Recommended action:
    To change the passphrase, you must first update the backup agent to the minimum version, which is 2.0.9052. You also need to update Azure Backup Server to the minimum of update 1, and then enter a valid security PIN. To get the PIN, sign in to the Azure portal and go to the Recovery Services vault. Then go to Settings > Properties > Generate Security PIN. Use this PIN to change the passphrase.

    Configure email notifications

    Operation Error details Workaround
    Setting up email notifications using a work or school account Error ID: 2013 Cause:
    Trying to use work or school account
    Recommended action:
    1. The first thing to ensure is that "Allow Anonymous Relay on a Receive Connector" for your DPM server is set up on Exchange. For more information about how to configure this, see Allow Anonymous Relay on a Receive Connector.
    2. If you can't use an internal SMTP relay and need to set up by using your Office 365 server, you can set up IIS to be a relay. Configure the DPM server to relay the SMTP to Office 365 using IIS.

      Be sure to use the user@domain.com format and not domain\user.

    3. Point DPM to use the local server name as SMTP server, port 587. Then point it to the user email that the emails should come from.
    4. The username and password on the DPM SMTP setup page should be for a domain account in the domain that DPM is on.

    5. When you're changing the SMTP server address, make the change to the new settings, close the settings box, and then reopen it to be sure it reflects the new value. Simply changing and testing might not always cause the new settings to take effect, so testing it this way is a best practice.

      At any time during this process, you can clear these settings by closing the DPM console and editing the following registry keys: HKLM\SOFTWARE\Microsoft\Microsoft Data Protection Manager\Notification\
      Delete SMTPPassword and SMTPUserName keys
      . You can add them back to the UI when you launch it again.

    Common issues

    This section covers the common errors that you might encounter while using Azure Backup Server.

    CBPSourceSnapshotFailedReplicaMissingOrInvalid

    Error message Recommended action
    Backup failed because the disk-backup replica is either invalid or missing. To resolve this issue, verify the below steps and retry the operation:
    1. Create a disk recovery point
    2. Run consistency check on datasource
    3. Stop protection of datasource and then reconfigure protection for this data source

    CBPSourceSnapshotFailedReplicaMetadataInvalid

    Error message Recommended action
    Source volume snapshot failed because metadata on replica is invalid. Create a disk recovery point of this datasource and retry online backup again

    CBPSourceSnapshotFailedReplicaInconsistent

    Error message Recommended action
    Source volume snapshot failed due to inconsistent datasource replica. Run a consistency check on this datasource and try again

    CBPSourceSnapshotFailedReplicaCloningIssue

    Error message Recommended action
    Backup failed as the disk-backup replica could not be cloned. Ensure that all previous disk-backup replica files (.vhdx) are unmounted and no disk to disk backup is in progress during online backups