Setting Watermarks

A watermark is a value that identifies the most recent transaction in a system. In AccuRev, the watermark is represented by the transaction number in a depot. For example, a watermark of 10979 means that the last recorded transaction for a given depot was number 10979. In Rally and JIRA, the watermark is represented by the timestamp of the most recent transaction. For example, a watermark of 2012-03-29 12:45:33 means that the last transaction occurred at 12:45:33 on March 29.

The current watermark is displayed on the status page for the AccuSync Configuration for the currently selected system, as shown in the following illustration, which displays the watermark for AccuWork:

Generally speaking, you do not need to adjust the watermark, but there are occasions when you might want

to. For example, you might want to adjust the watermark:

Prior to the initial synchronization

Imagine the current AccuWork transaction number is at 1000 when you install and configure AccuSync. If you want to synchronize with your ITS using an earlier watermark, either based on transaction number or date, you can do so. If you do not modify the watermark, AccuSync synchronizes all the issues in your systems, starting with the first transaction/ earliest date, that match the mapping definitions you have defined for your synchronization patterns.

To synchronize a previously skipped issue

Imagine that you make a change to an issue that was skipped by the synchronization process, perhaps a filter prevented the issue from being synchronized, and you now want to synchronize the issue. You can redefine the filter to include this issue the next time you synchronize, but because the watermark is now greater than it was when you changed the filter, AccuSync will still not synchronize the issue. In this case, you can set the watermark to a value lower/earlier than the watermark recorded for that issue and then run synchronization again.

You adjust the watermark using the watermark tool.