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 users 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.
Shadow Folders
The Current Shadow Folder Associations list contains all the associations between repository folders and the shadow folder targets. It also shows read-only status, speed optimization, and file date setting for each shadow folder.
New
Click the New button to create a new shadow folder association.
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.
Synchronization Options
Synchronized with Repository - The Shadow Folder service maintains an exact copy of the repository folder. If changes are made to any of the files within the file system of the Shadow Folder's target, these changes are overwritten on the next Shadow Folder update. This is the default setting for existing shadow folder assignments created prior to installing Vault 3.5.2.
Optimized for Speed - After the Shadow Folder target has been retrieved to the file system, only changes within monitored transactions are reflected on disk. The Shadow Folder target will not be fully synchronized with the Shadow Folder's repository folder if changes are made to items on the file system. Only the change set items committed to the repository will be synchronized in the Shadow Folder target. This is the default setting for new shadow folders in Vault 3.5.2.
File Dates
This option allows you to establish a default for the timestamp of the files retrieved to the shadow folder.
Current - the time the file was downloaded from the server.
Modification - the time the file was last modified on a client machine.
Checkin - the server time at the time this version was checked in.
Press OK to add the repository/shadow folder association to the database, and to begin shadowing the folder.
Press Cancel to cancel your changes.
Edit
Press the Edit button to modify the selected shadow folder association.
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.