epoch_watchdog

Checks whether a replica's epoch numbers have rolled back when the replica is not in restoration mode

APPLICABILITY

SYNOPSIS

• Check for rollback of epoch numbers:

epoch_watchdog { -all | -vobs VOB-tag,... | list-file }

• Print help on command options:

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.

DESCRIPTION

epoch_watchdog checks whether a VOB 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 VOB 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/atria/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 epoch_watchdog finds that the current number is lower than the logged number, it checks to see if the replica is in restore mode. If the replica is not being restored, epoch_watchdog attempts to lock the affected VOB, and optionally sends email notification (you must specify email addresses in the scheduled job). In this situation, you must contact Rational Support before unlocking the VOB or attempting any repair procedures.

NOTE: If the time window between scheduled jobs of epoch_watchdog is large enough, the activity level in the replica can be high enough that a rollback can go undetected in the case where restorereplica is not performed.

If an error occurs, epoch_watchdog creates an entry in /var/adm/atria/log/error_log on UNIX or the Event Viewer on Windows. This entry references the epoch_logs file.

RESTRICTIONS

You must be root on UNIX or a member of the ClearCase administrators group on Windows.

OPTIONS AND ARGUMENTS

-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 following form:

vob:VOB-tag

EXAMPLES

FILES

/var/adm/atria/log/epoch_logs (UNIX)
/var/adm/atria/log/error_log (UNIX)
ccase-home-dir\var\log\epoch_logs (Windows)

SEE ALSO

schedule (in the Command Reference)