This article lists possible causes and solutions
This article applies to:
- Acronis vmProtect 7
- Acronis vmProtect 8
- Acronis Backup for VMware 9 (Acronis vmProtect 9)
Exchange-aware backup fails with the following error in the log:
16 Error 1/13/12 5:19:25 PM Failed to prepare for the Microsoft Exchange database validation.
Error code: 368
Message: Failed to prepare for the Microsoft Exchange database validation.
Error code: 358
Message: VSS metadata is missing or corrupt.
Error code: 1001
Message: Failed to parse MsExchange VSS writer metadata.
Error code: 1003
Message: Expected XML tag not found: WRITER_COMPONENTS
OR with the following log. See Solution #3 for this specific error. Note the bolded line:
Task 'Exchange' failed: 'Failed to create a backup.
Error code: 3
Message: Failed to create a backup.
Error code: 32786
Message: Failed to prepare for backing up.
Error code: 353
Message: Failed to back up the group.
Error code: 2
Message: Error occurred while running the backup and recovery engine.
Error code: 367
Fields: command : --check-env
Message: The agent on the guest system has failed to process the request.
Error code: 1
Fields: $module : C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\1995738C-A9A9-4B1F-ADBE-5C7E2D8A98EE\exchange_backup_agent.exe
Message: Failed to process command 'CheckEnvironment'.
Error code: 25
Message: The VSS components of VMware Tools are corrupted or not installed.
There are several possible causes. Please look through the Solution section of the article.
- If you are running Microsoft Exchange on Windows 2008-based machine in ESX(i) 4.1 or higher environment then please ensure that disk.EnableUUID parameter is present in the Exchange VM configuration. For detailed instructions please see VMware KB: Enabling Windows 2008 application-consistent quiescing on ESX/ESXi 4.1.
- Exchange-aware backup is not possible if Microsoft Exchange is installed on Windows 2003 SBS edition without additional adjustments. By default, the Setup program for Microsoft Windows Small Business Server 2003 turns off the Microsoft Exchange Server 2003 writer for the Volume Shadow Copy service. To protect data using Acronis vmProtect 7, the Exchange 2003 writer must be turned on: See Microsoft TechNet: Troubleshooting Exchange Server Protection Issues. For Exchange 2007/2010 versions the VSS writer is turned on by default, so these versions are not affected by this issue. This is a by-design behavior.
- This solution applies to ESX(i) 5.0 and older. This solution applies only if you have the The VSS components of VMware Tools are corrupted or not installed error message.
The VMware Snapshot Provider service is required for proper application level quiescing. The solution is to register the necessary COM component manually as described in VMware KB: Unable to create snapshots on Windows guest operating systems. To ensure the proper registration of VMware Snapshot Provider COM component use the following command for registration which sends the log output into a file: "C:\Program Files\VMware\VMware Tools\COMREG.EXE" -register "C:\Program Files\VMware\VMware Tools\Drivers\vss\VCBSnapshotProvider.dll" "VMware Snapshot Provider" "vmvss" "VMware Snapshot Provider" > C:\register.log 2>&1 . The successful log will look similar to the following:
Couldn't find application to unregister: VMware Snapshot Provider
Creating new COM+ application (VMware Snapshot Provider)...
Setting application options...
Creating the service...
Registering the DLL...
Securing the application...
Searching for admin group using WMI...
Searching for LocalSystem account using WMI...
Granting new role to LocalSystem user...
- In case the VMware tools were installed on the Exchange VM in non-interactive (silent) mode the VSS modules may not be registered properly. The solution in this case would be to re-install VMware tools in interactive mode by logging into VM and performing the installation of the VMware tools.
- In case there is User Account Control enabled inside the VM running Microsoft Exchange, make sure you have installed the Exchange Backup Agent prior to running Exchange-aware backup of this VM. It can be extracted from Acronis Backup for VMware (former vmProtect) installation package: look for "Acronis Backup for VMware Backup Agent" component.
- If nothing of the above helps then the most probable reason is incorrect vss_manifests***.zip archive generated while quiescing the Exchange VM, i.e. it is not generating proper VSS manifest output. Please ensure that your VM meets all prerequisites imposed by VMware for Application-consistent quiescing which depend on vSphere version and the Guest OS type. For example Windows 2008 installed on IDE disks in vSphere 4.1+ environment doesn't support Application-consistent quiescing. Application-consistent quiescing is required to get non-empty VSS manifests .zip output: See the following description of VSS handling specifics from VMware.
When creating a quiesced snapshot of the VM from vSphere Client interface there must be vss_manifests***.zip file generated on the datastore in the folder where this VM is:
Under normal circumstances the VSS manifests .zip file is not empty, however if there are some problems with the VMware tools then the outputs may be corrupted even though the VM meets the requirements for Application-consistent quiescing, which means that VMware tools need to be re-installed.
- If re-installation of VMware tools or other suggestions above does not help then please collect the following information after creation of the quiesced snapshot of the Exchange VM and contact Acronis Customer Central with the following diagnostic information:
- Outputs of the vssadmin list writers command from the guest OS (Exchange VM) in to check that there are no failing VSS writers. See VSS Log Files;
- Windows System Information from the guest OS (Exchange VM): Start -> Run -> msinfo32 -> Save to File…
- Windows Event Logs from the guest OS (Exchange VM): Start -> Run -> eventvwr.msc. Both System and Application logs are required.
- The vss_manifests***.zip file obtained in step 6 of the above described steps.
See also Acronis Backup for VMware 9.