rgy_backup

Copies registry files and client list from primary registry server host to backup registry server host

APPLICABILITY

ClearCase (administrative command)

SYNOPSIS

rgy_backup

DESCRIPTION

By default, the ClearCase scheduler runs rgy_backup periodically. See the schedule reference page for information on describing and changing scheduled jobs.

When it runs on a host that is not a backup registry host, rgy_backup checks backup server configuration and exits. When it runs on a backup registry server host, rgy_backup takes two snapshots:

• ClearCase registry files, ccase-home-dir\var\rgy\*, on the primary registry server host (see also registry_ccase)
• Primary registry host's client list, which is maintained by the registry server host's albd_server

rgy_backup stores these snapshot files in the directory ccase-home-dir\var\rgy\backup on the backup registry server host. rgy_backup removes files older than 96 hours.

rgy_backup names the snapshot file after the original file and appends a time stamp to the file name. rgy_backup also creates a file, with the same name as the original file, that contains the full, time-stamp-extended name of the most recent snapshot file. For example, for registry file vob_tag, rgy_backup creates in the backup directory:

• vob_tag.17-Jul-99.18:30:15
• A file named vob_tag that contains the string vob_tag.17-Jul-99.18:30:15

If the primary registry server fails, you can run rgy_switchover to activate the backup registry server and reset all client hosts accordingly. The backup server must be running the same release of ClearCase as that running on the primary server.

rgy_backup logs its snapshot activity in the Windows event log.

Designating a Backup Registry Host

The Windows Registry key HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\RegBackup contains the name of the backup registry server host (or the string Unknown, if no backup host has been designated). You can change this key value on the Registry tab in the ClearCase Control Panel.

Typically, a backup registry server host is specified for each client when ClearCase is installed (although designating the backup registry host is not part of the installation procedure itself).

Do not designate a backup registry host that is unsuitable to serve as primary registry server host in an emergency.

NOTE: If your site uses multiple ClearCase registries, you cannot configure one primary registry server as the backup server for a different registry.

PERMISSIONS AND LOCKS

Permissions Checking: You must have write permission to the directory ccase-home-dir\var\rgy.

Locks: No locks apply.

OPTIONS AND ARGUMENTS

None.

EXAMPLES

• On a backup registry host, take a snapshot of the ClearCase registry files manually.

rgy_backup

FILES

ccase-home-dir\var\rgy\*
ccase-home-dir\var\rgy\backup\*

WINDOWS REGISTRY KEYS

HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\AtriaRegy
HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ServerType
HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\RegBackup

SEE ALSO

lsclients, registry_ccase, rgy_switchover, schedule