Configure Shadow Folders

The Configure Shadow Folders dialog allows you to determine which folders in your repository will be shadowed.

A shadow folder is a local folder that contains the contents of a repository folder, and is kept up-to-date in the shadow folder by the Vault server as changes are applied to repository folder.

A special Shadow Folder Web Service is installed with the Vault server that is notified of changes as they happen, and the Shadow Folder Service keeps the local disk up to date. A shadow folder must be accessible from the machine the Shadow Folder Web Service is located on.

Please Note: The Shadow Folder Web Service is configured to run under the Vault Admin user account. If you change the Admin user’s password, you must do it from the Vault Admin tool, and not from another Vault client. Otherwise, the Shadow Folder configuration data will not get updated to reflect the password change, and Shadow Folders will not be updated until the password is corrected.

 

Note on UNC paths: If you want to shadow files to a UNC path (e.g, one that you specify as //machinename/folder, rather than one that is local to the Vault server), there are also additional configuration steps required. See a knowledge base article at http://support.sourcegear.com/viewtopic.php?t=188 for more information.

 

Folder in Repository

The Folder in Repository box contains the folder you want to shadow in the given repository.

The Browse button will bring up a tree of folders in the current repository that you can select to be shadowed.

Shadow Directory Location

The Shadow Directory Location box contains the local directory where the Shadow Folder Web Service will place repository files and keep them up to date.

The Browse button will bring up a local folder chooser that allows you to select a folder.

NOTE: This browse button brings up folders on the machine the Admin Tool is running. If this is a different machine than the Shadow Folder Web Service is on, then a folder selected here will likely be invalid.

Set read-only flag for all files

This checkbox determines the read-write flag for any files that are placed in the shadow folder. If checked, the files will be read-only, otherwise they will be read-write.

Add

Press the Add button to add the repository/shadow folder association to the database, and to begin shadowing the folder.

Shadow Folders

The Shadow Folders list contains all the associations between repository folders and the local folders they are shadowed to.

Delete

Press the Delete button to delete the selected shadow folder association from the Shadow Folders list. Note that this does not delete the files from the disk, but merely deletes the association.