Restores VOB replica from backup
Product | Command type |
---|---|
MultiSite | multitool subcommand |
Platform |
---|
UNIX |
Windows |
Execute this command IMMEDIATELY after restoring a VOB replica from backup. Proceeding with normal development (and generating new changes) at a restored replica before executing this command can lead to IRREPARABLE inconsistencies among the replicas in a VOB family.
restorereplica replaces missing changes in a VOB replica that has been restored from backup, as follows:
Causes the current replica to create special update packets that contain update requests to other replicas.
Locks the current replica's VOB object and marks the replica as being in the process of restoration.
Increments the recovery incarnation for the replica.
Causes lsreplica -long to indicate which replicas must send restoration updates to the current replica.
The current replica remains in the restoration state until your site has received and applied (using syncreplica -import) all the restoration updates needed to bring the replica up to date with the state of the VOB family. Collectively, these updates include all the changes to the VOB family since the backup was made, including changes made in the current replica before its failure. During the process of restoration, the lsreplica -long command annotates its listing to indicate which replicas must send restoration updates to the replica.
For a description of the replica restoration procedure, see Restoring and Replacing Replicas.
restorereplica locks the current replica's VOB object. This ensures that while restoration proceeds through execution of syncreplica -import commands, no other changes are made to the current replica.
When syncreplica applies the final required update, it displays a message indicating that the restoration process is complete. At this point, use the cleartool unlock vob: command to unlock the restored VOB replica, enabling normal development to proceed.
By default, restorereplica requires that the replica receive restoration updates from all other replicas in its VOB family (either directly or indirectly). Only after all the updates are imported does the syncreplica command display the message indicating that restoration is complete.
In some cases, you can relax this requirement without compromising the correctness of the restoration process. The replica will be brought up to date if it receives a restoration update from only one replica-the last one to which the replica sent an update before it was restored from the backup version. You can specify the name of that last-updated replica (or a list of replicas, one of which must be the last-updated one) to restorereplica. syncreplica displays the restoration-completed message after receiving restoration updates from all the specified replicas.
CAUTION: Making a mistake in using this optimization can make the restored replica irreparably inconsistent with other replicas.
Identities: You must have one of the following identities:
VOB owner
root (UNIX)
Member of the ClearCase administrators group (Windows)
Mastership: No mastership restrictions.
EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, with commenting controlled by the standard ClearCase user profile (default: -cqe). See EVENT RECORDS AND COMMENTS in the multitool reference page. To edit a comment, use cleartool chevent.
SUPPRESSING INTERACTIVE PROMPTS. Default: restorereplica prompts you for confirmation.
SPECIFYING THE VOB FAMILY. Default: Processes the replica that contains the current working directory.
pname-in-vob | Pathname of the VOB-tag (whether or not the VOB is mounted) or of any file-system object within the VOB (if the VOB is mounted) |
replica-name | Name of the replica (displayed with lsreplica) | |
vob-selector | VOB family of the replica; can be omitted if the current working directory is within the VOB. Specify vob-selector in the form [vob:]pname-in-vob | |
pname-in-vob | Pathname of the VOB-tag (whether or not the VOB is mounted) or of any file-system object within the VOB (if the VOB is mounted) |
For an example of restoring a replica, see Restoring and Replacing Replicas.
chepoch, lsepoch, lsreplica, syncreplica
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |