rgy_switchover

Makes a backup registry server host the primary registry server host

APPLICABILITY

ProductCommand type
ClearCasecommand

Platform
UNIX
Windows

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/rational/clearcase/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 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 FILES

/var/adm/rational/clearcase/rgy/*
/var/adm/rational/clearcase/rgy/backup/*
/var/adm/rational/clearcase/rgy/rgy_hosts.conf
/var/adm/rational/clearcase/rgy/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
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



Copyright© 2003 Rational Software. All Rights Reserved.