FAQ - Windows File Archiver Agent

How can I see the file attributes after running a restore job?

Run the GXHSMUtility from the command line to validate the attributes of the recalled files or stub files by using the -vr command line option. Recalled files should not have off-line, Reparse-Point or Sparse attributes set. The validation logic will display any file that is found to have only one or two of the stub attributes. Incorrect file attributes are set when an AntiVirus program interferes with or triggers a recall. Quota management drivers and other file filter drivers can also interrupt the normal recall process.

Examples:

GXHSMUtility.exe -vr G:\foo\

GXHSMUtility.exe -vr -z G:\foo\

GXHSMUtility.exe -vr -z -a G:\foo\

How Can I Disable ACL Restore?

ACLs are restored by default. However you can create the following registry key to disable ACL restore:

  1. From the CommCell Console, navigate to Client Computers | <Client>.
  2. Right-click File Archiver.
  3. Select Properties.
  4. Select the Registry Key Settings tab.
  5. Click Add.
  6. In the Name box enter GXHSMSERVICERESTOREACLS.
  7. In the Location box enter iDataAgent.
  8. In the Type box select STRING.
  9. In the Value box, enter N.
  10. Click OK.

How do I recall stubs that reside on the PolyServe File System?

Use the following steps to recall stubs from the PolyServe cluster:

  1. Make sure  that the Archiver Agent is installed on the physical nodes of Polyserve cluster.
  2. Make sure that the Use Classic File Scan option is enabled in the backupset as described in Setting up the Backupset.
  3. Make sure that the Use VSS option is not selected from the subclient used to perform the PolyServe cluster backup as described in Setting up the Subclient.
  4. To perform stub recall, add the EnableThirdPartyFS registry key on the physical nodes of PolyServe cluster as described in Configuring Stub Recalls.

What happens to stubs deleted using Erase Data by Browsing option?

If stubs are deleted using Erase data by browsing option, the subsequent backups will not prune the stubs from the disk. The stubs would still be available in the disk. However, you cannot perform a recall or a restore operation on these stubs.

How can I prevent an executable from triggering Stub Recoveries for files?

In order to prevent an executable from triggering stub recoveries for files associated with a particular application, use the NoRecallPrivileges key.

  1. From the CommCell Console, navigate to Client Computers | <Client>.
  2. Right-click File Archiver.
  3. Select Properties.
  4. Select the Registry Key Settings tab.
  5. Click Add.
  6. In the Name box enter NoRecallPrivileges.
  7. In the Location box enter WinFSDataMigrator.
  8. In the Type box select KEY.
  9. Click OK.

Is Distributed File System Replication (DFSR) service compatible with stub recall?

Distributed File System Replication (DFSR) is not compatible with stub recall. This is due to a Microsoft known issue.

For more information, see Microsoft article DFSR Reparse Point Support.

Contact Microsoft if you still experience issues related to archiving or stub recall.

How Does the Stub Recall Process Work?

Follow the image available alongside for the complete stub recall process.