V11 SP8

Frequently Asked Questions - 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.

  • The (-a) option, displays the three attribute settings for files found with incorrect attributes.
  • The (-z) option, limits the result to display files with incorrect stub attributes, and files containing zeros only.


GXHSMUtility.exe -vr G:\foo\

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

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

After a recall operation will I be able to stub my file again?

Yes. By default, when a stub is recalled but no changes are made to its content, it is restubbed during the next archiving cycle. During restubbing, the stubs are replaced by the existing copies of stubs available in the stub cache. If you have an upgraded client, restubbing is enabled by default. However, if you want to disable restubbing, use the following steps:

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

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

  2. In the Value box, type N to disable restubbing of files.
  3. Click OK to save the additional setting configuration.
  4. Click OK.
  5. After modifying the value for this key, restart the DataArchiver services for the changes to take effect.

How Can I Disable ACL Restore?

By default, ACLs are restored with every restore operation.

To disable the restore of ACLs, create the GXHSMSERVICERESTOREACLS additional setting on the client computer.

  1. From the CommCell Browser, right-click the OnePass client, and then click Properties.
  2. In the Client Computer Properties dialog box, click Advanced.
  3. In the Additional Settings tab, click Add.
  4. In the Name box, type GXHSMSERVICERESTOREACLS.

    Alternatively, click Lookup, select GXHSMSERVICERESTOREACLS from the list, and click OK.

    The Category and Type details are automatically populated.

  5. In the Value box, type N.
  6. Click OK to close the Additional Settings dialog box.
  7. Click OK.

How Does the Stub Recall Process Work?

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