rgy_switchover

Makes a backup registry server host the primary registry server host

APPLICABILITY

SYNOPSIS

rgy_switchover [ -time file-timestamp ]

[ -backup new-backup-server ]  old-registry-server  new-registry-server

DESCRIPTION

The rgy_switchover command upgrades a backup registry server host (see rgy_backup) to primary registry server host and resets ClearCase clients to use the new primary registry server host. rgy_switchover logs its activities to /var/adm/atria/log/albd_log (UNIX) or the Windows event log.

rgy_switchover can modify configuration information only on hosts that are running ClearCase. This means that if the failure of a primary registry server causes a switchover, the (former) primary registry server cannot be informed of the switchover.

To Re-Initialize the Tag Registry Password

Because rgy_backup does not copy the tag registry passsword file to a backup registry, you must initialize the tag registry password with the rgy_passwd command after you run rgy_switchover.

RESTRICTIONS

Identities: No special identity required.

Locks: No locks apply.

Mastership: (Replicated VOBs only) No mastership restrictions.

OPTIONS AND ARGUMENTS

SPECIFYING THE NEW BACKUP REGISTRY SERVER.   Default: None.

-backup new-backup-server

Configures new-backup-server as the backup registry server host, after switching the current backup registry server host to the primary registry server host.

SPECIFYING A TIME STAMP.   Default: rgy_switchover uses the most recent registry backup files in the new-primary-rgy-host's backup directory.

-time file-timestamp

Activates an alternate set of backup registry files. The file-timestamp much match an existing set of time-stamped files in backup. By default, the ClearCase scheduler runs rgy_backup periodically and deletes backed-up registry files more than three days old.

SPECIFYING THE OLD AND NEW PRIMARY REGISTRY SERVERS.   Default: None. You must specify the current and target primary registry server hosts.

old-rgy-host

The current primary registry server host.

new-rgy-host

The current backup registry server host that will become the new primary registry server host.

EXAMPLES

• Make backup registry host beta the new primary registry host.

rgy_switchover  alpha  beta

• Same as previous example, but make omega the new backup registry host.

rgy_switchover  -backup omega  alpha  beta

UNIX FILES

/var/adm/atria/rgy/*
/var/adm/atria/rgy/backup/*
/var/adm/atria/rgy/rgy_hosts.conf
/var/adm/atria/rgy/rgy_svr.conf
/var/adm/atria/log/albd_log
/var/adm/atria/client_list.db

WINDOWS 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, rgy_backup, rgy_passwd, schedule, Administrator's Guide