Product | Command type |
---|---|
MultiSite | multitool subcommand |
Platform |
---|
UNIX |
Windows |
CAUTION: To delete a replica, you must complete all steps described in Deleting a Replica. If you do not complete all steps in the correct order, synchronization and mastership problems can occur in other replicas in the VOB family.
This command deletes from the current replica's database the VOB-replica object that records the existence and identity of another replica. Typically, you use this command at your site to record the fact that a replica at another site has been decommissioned and deleted.
NOTE: If executing this command makes the current replica the last remaining member of the VOB family, rmreplica turns off operation logging for this VOB and removes all operation logs, which may take a long time.
Identities: You must have one of the following identities:
VOB owner
root (UNIX)
Member of the ClearCase administrators group (Windows)
Locks: An error occurs if one or more of these objects are locked: VOB, replica.
Mastership: Your current replica must master the replica being removed.
Other: The following restrictions apply:
You cannot delete your current replica's VOB-replica object.
You cannot delete a replica if your current replica considers it to master one or more objects.
EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, with commenting controlled by the standard ClearCase user profile (default: -nc). See EVENT RECORDS AND COMMENTS in the multitool reference page. To edit a comment, use cleartool chevent.
SPECIFYING THE REPLICA. Default: None.
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) |
Remove the VOB-replica object that records the existence of replica tokyo from the database of the current replica.
multitool rmreplica tokyo
Deleted replica "tokyo".
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |