Checks whether a replica’s epoch numbers have rolled back when the replica is not in restoration mode
epoch_watchdog { –all | –vobs VOB-tag,... | list-file }
epoch_watchdog –help
On UNIX, epoch_watchdog is located in ccase-home-dir/config/scheduler/tasks. On Windows, epoch_watchdog is located in ccase-home-dir\config\scheduler\tasks.
epoch_watchdog checks whether a replica’s epoch numbers have rolled back without a restorereplica command being run. If the epoch numbers have rolled back and the replica is not in restoration mode, the replica may have been improperly restored from backup. This script is intended to be run regularly by the ClearCase scheduler. For more information, see the schedule reference page in the Command Reference.
epoch_watchdog writes a replica’s epoch number to a log file in /var/adm/rational/clearcase/log/epoch_logs on UNIX or ccase-home-dir\var\log\epoch_logs on Windows. The next time the script is run, it compares the current epoch number to the logged number. If the current number is lower than the logged number, epoch_watchdog checks to see if the replica is in restoration mode. If the replica is not being restored, epoch_watchdog attempts to lock the affected VOB, and optionally sends e-mail notification. You must specify e-mail addresses in the scheduled job. In this situation, you must contact Rational Support before unlocking the VOB or attempting any repair procedures.
Note: If you do not schedule epoch_watchdog to run frequently, the activity level in the replica can be high enough that a rollback may not be detected if restorereplica is not performed.
If an error occurs, epoch_watchdog creates an entry in /var/adm/rational/clearcase/log/error_log on UNIX or the Event Viewer on Windows. This entry references the epoch_logs file.
You must be root on UNIX or a member of the ClearCase administrators group on Windows.
–h·elp
Prints help on command options.
–all
Checks all replicated VOBs on the current computer.
–vobs VOB-tag,...
VOB tags of replicated VOBs to be checked. Specify multiple VOB tags in a comma-separated list with no white space.
list-file
Path to file containing a list of VOBs to check. Specify one VOB on each line, with no white space, in the form vob:VOB-tag
For an example of the command, see Running epoch_watchdog.
/var/adm/rational/clearcase/log/epoch_logs (UNIX)
/var/adm/rational/clearcase/log/error_log (UNIX)
ccase-home-dir\var\log\epoch_logs (Windows)
schedule (in the Command Reference)