rgy_switchover
Makes a backup registry
server host the primary registry server host
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.
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.
- Same
as previous example, but make omega the new backup
registry host.
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 |