rgy_switchover

Makes a backup registry server host the primary registry server host

Applicability

Product

Command type

VersionVault

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 VersionVault clients to use the new primary registry server host. rgy_switchover logs its activities to /var/adm/hcl/versionvault/log/albd_log (UNIX® and Linux®) or the Windows® event log.

rgy_switchover can modify configuration information only on hosts that are running VersionVault. 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 VersionVault 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/hcl/versionvault/rgy/*
  • /var/adm/hcl/versionvault/rgy/backup/*
  • /var/adm/hcl/versionvault/config/rgy_hosts.conf
  • /var/adm/hcl/versionvault/config/rgy_svr.conf
  • /var/adm/hcl/versionvault/log/albd_log
  • /var/adm/hcl/versionvault/client_list.db

Windows® files

  • versionvault-home-dir\var\rgy\*
  • versionvault-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