When a watershed is configured to be a master watershed, the CAVI will track the different versions of the watershed (the main copy on the network drive or CWMS server, and the local copies on the team members' computers). The CAVI manages all files and their changes, not the native models (i.e., HEC-MetVue, HEC-HMS, HEC-ResSim, HEC-RAS, HEC-FIA). However, the CAVI does not know what changes have been made since editing is done through the native model interfaces. If you update your local copy, the version number on the local copy will not change, and the Team Synchronization dialogs will not indicate that your forecast or watershed files are more recent than the master. 

When new files for a watershed are uploaded, the CAVI compares the local files with those on the master watershed. The name, size and checksum of the local files are compared with the name, size and checksum of the files on the server. If there are any differences, the files are updated. For downloads, the local and master watershed files are compared. If the version numbers are different, the system updates all of files that have undergone revisions between your local version and the version on the master watershed.

The following sections provide further details on these concepts.

Master Watershed Team Modeling Files

As part of the upload process for the master watershed, there are new files created to track versions. In the master watershed, the main watershed directory and all sub-directories will contain a file labeled .block.revision.dss. These .block.revision.dss files contain a running history of all the file changes that have been made for the directory. Each time an upload occurs for a selected folder, the .block.revision.dss file will log a new entry that contains the name of the files that were changed on the master watershed, the user that performed the upload action, the date and time of the upload, and any comments entered at time of upload.

There should not be a .block.revision.dss file in the local copies of the watershed, only in the master watershed. If these files become present, the CAVI may think that the watershed is the master watershed and will give warning. If this happens, delete the local copy of the .block.revision.dss files.

Local Watershed Team Modeling Files

In addition to the files that are created in the master watershed at the time of the upload, there are new files created for the local copy in the main watershed directory on your computer and all sub-directories. These files are labeled .block.revision. Unlike the HEC-DSS files on the master watershed, the local copy .block.revision files are XML files. The .block.revision files will contain information about the last update to the specified local folder, instead of a complete history stored with the master watershed.

Version Information

CWMS manages the different master watershed .block.revision.dss and local .block.revision files to determine the proper versioning for your local copy of the master watershed. The Master Watershed Synchronization form (described in Master Watershed Synchronization Dialog) will display information from both the local and master watershed revision files. When a team member selects a node in the Master Watershed Synchronization form, it will display the current revision number as defined locally and on the master watershed, the last updated date and time, the username who made the changes, Status, and Comments. If you click the History button at the bottom of the window, a Revision History dialog will launch. This dialog will display information from the master watershed's .block.revision.dss file, which contains the complete version history for the selected node. From the Revision History dialog, you can select two different uploads and click the File Changes button to see the differences between the two revision numbers. Please see Revision History Dialog for more information on using this dialog.