rgy_switchover

Makes a backup registry server host the primary registry server host

Applicability

Product

Command type

ClearCase®

command

Platform

UNIX

Linux

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/devops/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/devops/clearcase/rgy/*
  • /var/adm/devops/clearcase/rgy/backup/*
  • /var/adm/devops/clearcase/config/rgy_hosts.conf
  • /var/adm/devops/clearcase/config/rgy_svr.conf
  • /var/adm/devops/clearcase/log/albd_log
  • /var/adm/devops/clearcase/client_list.db

Windows files

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

Windows registry keys

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