Restore Troubleshooting - Windows File System iDataAgent

Backup Restore  
Table of Contents

WFS0024: Error messages during browse operation

When you are browsing the backup data, one of the following error condition can occur: 


Failure to connect the MediaAgent


Check the connectivity between MediaAgent and the client computer. Add the client host name and IP address in the host file on the MediaAgent.


Index Cache Inaccessible


Check the connectivity between MediaAgent and the client computer. Add the client host name and IP address in the host file on the MediaAgent.

WFS0025: Files prevented from overwriting


When a file is in use by the operating system or open with exclusive read access by an application, the file is locked and cannot be overwritten.


The system automatically restores the file with another file name within the same directory and records the instance in the Windows registry. These are restored automatically at the time when the computer is restarted.

These files can be viewed from the Restore Job Summary Report They have a "Needs Reboot" tag attached to it. They can be viewed in the Restore History from the CommCell Console. In order to view these files you need to select the Failed Objects check box in Job Summary Selection tab. These files are displayed as Skipped files.

WFS0026: Cluster Services are not started automatically during Disaster Recovery


If the cluster disks were repartitioned, a failure message may appear because the disk GUIDs for the quorum may have been changed.


If the cluster service does not start, or if you see Event ID 1034 in the System Event Log, reference the KB 305793 and KB 280425 Microsoft Knowledge Base articles on to get the cluster service back online.

If the cluster service does not start automatically, start it manually in the Process Manager.

Recovering data associated with deleted clients and storage policies


In a disaster recovery scenario, use the following procedure to recover data associated with the following entities:

  • Deleted storage policy
  • Deleted client, agent, backup set or instance

Before You Begin

This procedure can be performed when the following are available:

  • You have a Disaster Recovery Backup that contains information on the entity that you are trying to restore. For example, if you wish to recover a storage policy (and the data associated with the storage policy) that was accidentally deleted, you must have a copy of the disaster recovery backup that was performed before deleting the storage policy.
  • Media containing the data you wish to recover is available and not overwritten.
  • If a CommCell Migration license was available in the CommServe when the disaster recovery backup was performed, no additional licenses are required. If not, obtain the following licenses:
    • IP Address Change license
    • CommCell Migration license

    See License Administration for more details.

  • A standby computer, which is used temporarily to build a CommServe.
Recovering Deleted Data
  1. Locate the latest Disaster Recovery Backup that contains the information on the entity (storage policy, client, agent, backup set or instance) you are trying to restore.
    • Check the Phase 1 destination for the DR Set or use Restore by Jobs for CommServe DR Data to restore the data.
    • If the job was pruned and you know the media containing the Disaster Recovery Backup, you can move the media in the Overwrite Protect Media Pool. See Accessing Aged Data for more information. You can then restore the appropriate DR Set associated with the job as described in Restore by Jobs for CommServe DR Data.
    • If the job is pruned and you do not know the media containing the Disaster Recovery Backup, you can do one of the following:
      • If you regularly run and have copies of the Data on Media and Aging Forecast report, you can check them to see if the appropriate media is available.
      • If you do not have an appropriate report, and know the media that contains the DR Backup, catalog the media using Media Explorer. Once the cataloging process is completed, details of the data available in the media are displayed.
  2. On a standby computer, install the CommServe software. For more information on installing the CommServe, see Install the CommServe.
  3. Restore the CommServe database using the CommServe Disaster Recovery Tool from the Disaster Recovery Backup described in Step 1. (See CommServe Disaster Recovery Tool for step-by-step instructions.)
  4. Verify and ensure that the NetApp Client Event Manager NetApp Communications Service (EvMgrS) is running.
  5. If you did not have a CommCell Migration license available in the CommServe when the disaster recovery backup was performed, apply the IP Address Change license and the CommCell Migration license on the standby CommServe. See Activate Licenses for step-by-step instructions.
  6. Export the data associated with the affected clients from the standby CommServe as described in Export Data from the Source CommCell.

    When you start the Command Line Interface to capture data, use the name of the standby CommServe in the -commcell argument.

  7. Import the exported data to the main CommServe as described in Import Data on the Destination CommCell.

    This brings back the entity in the CommServe database and the entity is visible in the CommCell Browser. (Press F5 to refresh the CommCell Browser if the entity is not displayed after a successful merge.)

  8. You can now browse and restore the data from the appropriate entity.

    As a precaution, mark media (tape media) associated with the source CommCell as READ ONLY before performing a data recovery operation in the destination CommCell.

WFS0027: Error during the full system restore of Windows Vista or Windows Server 2003


During the Disaster Recovery of Windows Vista or Windows Server 2003, you may get the following error:

An unauthorized change was made to Windows


When rebuilding an entire computer, it is required that the Windows service pack and hotfixes in the backup are also applied on the target computer. The service pack on the target must always match the backup prior to a restore. To restore the hotfix from the backups, select the Overwrite Files check box on the Restore Options dialog box and then select the Unconditional Overwrite option.

Select this option if the source computer had Internet Explorer 8.0 and the target computer has Internet Explorer 7.0.

WFS0028: An unauthorized change was made to Windows. You must retype your Windows Service Product Key to activate the license.


When you perform the Disaster Recovery of a Windows Vista, Windows Server 2003, Windows Server 2008, Windows Server 2008 R2 or Windows Server 2012 computer, you may get the following error:

An unauthorized change was made to Windows. You must retype your Windows Service Product Key to activate the license.


If the Windows product license key is not activated on the target computer prior to a full restore, you will receive the following message, and you will be required to provide the product license key after the restore. Refer to the check list that you have creating while planning for disaster recovery.

WFS0029: Files on the single instance storage linked volumes appear corrupted after restore


After the full system restore, the SIS-linked files are not be accessible, and they appear to be corrupted. The name and size of a SIS-linked file appear as normal. However, the file is a zero-length file and it does not have access to the data it should contain.


Before starting the restore, ensure the following

  • The source and target drive letter are the same.
  • The SIS/Groveler are running and attached to the volume to which you are restoring data.

For more information on How to restore a volume that is managed by Single Instance Storage, refer the KB 263027 Microsoft Knowledge Base article on

WFS0030: Completed with one or more errors

Restore jobs from Windows File System iDataAgent will be displayed as "Completed w/ one or more errors" in the Job History in the following cases:

For subclient containing only system state restore:

  • Fails to restore critical component - the job status is failed
  • Fails to restore non-critical component - the job status is completed w/ one or more errors

For subclient containing system state restore along with File system data:

  • Failure to restore critical component - marks the job as completed w/ one or more errors, so the data can be recovered.
  • Failure to restore non-critical component - marks the job as completed w/ one or more errors

Updating features and roles on Windows Server 2008

On Windows Server 2008, when you perform the Full System Restore, the Features and Roles do not get updated.

Select Configure Refresh from the Server Manager main page and update Features and Roles as they are not updated during a restart.

Restore operation goes to a pending state

When there is no change in the data during the time interval between an incremental prior to and after a synthetic full backup, the subsequent incremental backup will complete successfully even though no data got backed up. But the restore operation may go to a pending state. To complete the restore operation successfully, set the bUseRestoreFileCountToFailOnEmptyBackup additional settings to zero. Use the following steps to enable the additional settings:

  1. From the CommCell Browser, navigate to the CommServe.
  2. Right-click the <CommServe>, and then click Properties.
  3. On the CommServe Properties dialog box, click Advanced.
  4. Click the Additional Settings tab.
  5. Click Add.
  6. In the Name box, type bUseRestoreFileCountToFailOnEmptyBackup. The Category and Type details will be automatically populated.

    Alternatively, you can click Lookup and search for the additional setting using the Find box.

  7. In the Value box, type 0.
  8. Click OK to save the additional setting configuration.
  9. Click OK.

Unable to open encrypted files after an out-of-place restore operation

When you restore encrypted files to a different computer, you may not be able to open these files unless the keys or certificates to decrypt them are available in the destination computer.

To open the restored encrypted files, make sure that the private keys or certificates used to encrypt the files are available on the computer where the files are restored.

For more information, see Restoring Files to a Different Computer.

Distributed Component Object Model (DCOM) component appears disabled after a restore operation


Distributed Component Object Model (DCOM) component appears disabled after a restore operation is performed on the client computer.


Run the following command from the command prompt on the client computer after the restore operation is complete:

%windir%\system32\msdtc.exe –resetLog

Out-of-place restores of a subclient containing UNC path


If you select the root directory when performing an out-of-place restore on a subclient containing an UNC path as content, the data is restored under an automatically created directory "UNC_NT_<machine_IP>".


Prior to performing an out-of-place restore, make sure that you select the Remove n level from the beginning of the source path option and enter a value of 1 in the Restore Options for All Selected Items dialog box. For more information on how to set the Remove n level from the beginning of the source path option, see Performing an Out-of-Place Restore.

WFS0031: BSoD Error after a full system restore operation


After the full system restore, the computer reboots with a BSoD error screen.


Make sure that the following are not filtered while performing the full system restore operation:
  1. *:\drivers\*
  2. *:\win*\inf\*

CC0009: Users have access to files and folders belonging to others users


Users are able to Browse, Find and Restore files and folders associated with other users from all user-interfaces such as the CommCell Console, Web Console, etc.


  • ACLs (Access Control Lists) are not included in the backup, and/or
  • The user has Browse capability instead of only the End User Access capability.


  1. Make sure that only End User Access capability is configured on the client computer. For instructions, see Configuring End-User Operations on Client Computers.

    Specifically ensure that Browse capability is not assigned to these users.

    Assigning End User Access capability helps to maintain multiple user profiles on the same laptop (or desktop) and ensures that each user has the ability to browse and restore only the data to which he or she has access.

  2. Make sure that the Catalog ACL (end user access control list) option is enabled in the subclients before performing a backup as described in:

Once enabled, this option ensures that ACL s are included in the backup, which in turn, allows users to access only those files and folders for which they have permissions.

After enabling this option, make sure to run a Full backup subsequently. This will ensure that ACLs are available in the backup data.

Conversely, if you run a Differential or Incremental backup after enabling this option, only the newer data will include ACLs.

System State Restore Fails


If you back up certain system protected files in a cluster shared drive and the drive is no longer available, then the System State restore fails.


Create the nIgnoreNonexistingClusterDrivePathErrors additional setting to skip the files that belong to the cluster shared drive. The restore operation then completes successfully for other files.

To create the additional setting:

  1. Log on the CommCell Browser, right-click the CommServe, and select Properties.
  2. Click Advanced.

    The Advanced Properties dialog box appears.

  3. Click the Additional Settings tab, and click Add.

    The Add Additional Setting dialog box appears.

  4. In the Name box, type nIgnoreNonexistingClusterDrivePathErrors.
  5. In the Category box, type FileSystemAgent.
  6. In the Type box, select Integer.
  7. In the Value box, type the number 1.
  8. Click OK.

    The additional setting appears in the list on the Additional Settings tab.

  9. Click OK.