rgy_switchover

Makes a backup registry server host the primary registry server host

APPLICABILITY

ClearCase (administrative command)

SYNOPSIS

rgy_switchover [ -time file-timestamp ]

[ -backup new-backup-host-list ] old-rgy-host  new-rgy-host

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 old-rgy-host new-rgy-host does the following:

1. On new-rgy-host, copies the ccase-home-dir\var\rgy\backup directory to ccase-home-dir\var\rgy.
2. On new-rgy-host, notifies the albd_server process that it is now running on a registry server host.
3. Uses the client list snapshot to inform clients of the change.
4. Reconfigures each client to recognize the new primary registry server host.
5. Reports an error for any client it cannot update. Update these clients manually when they become accessible. Update a client by selecting the Registry tab in the ClearCase Control Panel to reset its Use registry server on host field.

   If a host is down and misses the switchover reconfiguration, it operates in degraded mode when it comes back until you or the host's owner updates it manually. In degraded mode, a client tries to access the primary registry server host, and when that fails, it tries to access the backup registry server host (which is now the primary registry server host to clients successfully reconfigured by rgy_switchover).

rgy_switchover logs its activities to the Windows event log.

NOTE: You must ensure that only one registry server is active at any time. When the failed primary registry server host returns, or if it is still running when you invoke rgy_switchover, login on old-rgy-host and revoke its status as primary registry server host:

1. Open the ClearCase Control Panel.
2. On the Startup tab, click Shutdown ClearCase.
3. On the Registry tab, select the Use registry server on host option, specify the new registry host, and click OK.
4. Restart ClearCase.

SAMPLE SWITCHOVER PROCEDURE

In this sample procedure, primary registry server host rgy1 fails, and the ClearCase administrator makes backup registry server host rgy2 the new primary registry server host. This assumes rgy_backup has been executing successfully on rgy2 . While rgy1 is down and rgy2 is the primary registry server host, rgy3 becomes the backup registry server host. Later, rgy1 becomes available again and the administrator reverts to rgy1 as the primary registry server host.

1. Make rgy2 the primary registry server host. Make rgy3 the new backup registry server host. Make rgy1 a provisional backup registry server host, so that when it returns to life, it takes a registry snapshot in preparation for returning to its role as primary registry server host:

rgy_switchover  -backup "rgy3 rgy1"  rgy1  rgy2

1. Record the names of any client hosts for which the switchover fails. Reset these hosts by hand when they become available (or have their owners do so). Note that pre-3.0 ClearCase clients and ClearCase Attache clients cannot be reconfigured automatically and always appear on the returned list of "unreachable" clients.

   When a failed client becomes available, use the Registry tab in the ClearCase Control Panel to reset the Use registry server on host field to rgy2.

2. Host rgy1 becomes available again.
3. rgy1 is still configured as a primary registry server host. Reconfigure it to recognize rgy2 as the primary registry server host:
   1. Log in to rgy1.
   2. Open the ClearCase Control Panel.
   3. On the Startup tab, click Shutdown ClearCase.
   4. On the Registry tab, select the Use registry server on host option, type rgy2, and click OK.
   5. Restart ClearCase.
4. Run rgy_backup manually on rgy1, forcing it to take a snapshot of the active registry files on rgy2 in preparation for returning rgy1 to service as the primary registry server host:

rgy_backup

NOTE: Running rgy_backup does not cause a snapshot operation unless rgy1 is configured as a backup registry server host on the primary registry server host (rgy2). rgy1 is correctly configured because it was named in the -backup argument in Step #1.

1. Stop registry service on rgy2:
   1. Log in to rgy2.
   2. Open the ClearCase Control Panel.
   3. On the Startup tab, click Shutdown ClearCase.
   4. On the Registry tab, select the Use registry server on host option, type rgy1, and click OK.
   5. Restart ClearCase.
2. Make rgy1 the primary registry server host. Return rgy2 to its former role as the backup registry host:

rgy_switchover -backup "rgy2"  rgy2  rgy1

PERMISSIONS AND LOCKS

Permissions Checking: You must be the domain Administrator to execute this command. See the permissions reference page.

Locks: No locks apply.

OPTIONS AND ARGUMENTS

SPECIFYING THE NEW BACKUP REGISTRY SERVER.   Default: rgy_switchover does not configure a new backup registry host.

-backup new-backup-host-list

Configures the hosts named in new-backup-host-list as backup registry server hosts, after switching the current backup registry server host to primary registry server host. If you specify multiple backup registry server hosts, enclose the space-separated host names in quotes, like this: "venus mars"

SPECIFYING A TIME STAMP.   Default: rgy_switchover uses the most recent registry backup files in the new-primary-rgy-host's ccase-home-dir\var\rgy\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 ccase-home-dir\var\rgy\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

• Same as previous example, but add alpha to the backup host list. This approach is recommended when the primary registry host (alpha) failed, prompting the switchover, but you plan to return it to primary registry host status when it becomes available again.

rgy_switchover  -backup "omega alpha"  alpha  beta

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, registry_ccase, rgy_backup, rgy_passwd, schedule