rgy_switchover

Makes a backup registry server host the primary registry server host

Applicability

Product	Command type
ClearCase®	command

Platform
UNIX®
Linux®
Windows®

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/rational/clearcase/log/albd_log (UNIX and Linux) 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 reinitialize the tag registry password

Because rgy_backup does not copy the tag registry password 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 and Linux files

/var/adm/rational/clearcase/rgy/*
/var/adm/rational/clearcase/rgy/backup/*
/var/adm/rational/clearcase/config/rgy_hosts.conf
/var/adm/rational/clearcase/config/rgy_svr.conf
/var/adm/rational/clearcase/log/albd_log
/var/adm/rational/clearcase/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
\Atria\ClearCase\CurrentVersion\ServerType
\Atria\ClearCase\CurrentVersion\RegBackup