rmreplica


Deletes a VOB-replica object

Applicability

Product
Command type
MultiSite
multitool subcommand

Platform
UNIX
Windows

Synopsis

rmreplica [ –c·omment comment | –cfi·le comment-file-pname | –cq·uery
| –cqe·ach | –nc·omment ] replica-selector

Description

Warning: To delete a replica, you must complete all steps described in Deleting a Replica, or synchronization and mastership problems can occur in other replicas in the family.

This command deletes from the current replica’s database the VOB-replica object for another replica. Use this command to record the fact that another replica has been deleted.

Note: If running rmreplica makes the current replica the last member of the family, rmreplica turns off operation logging for this VOB and removes all oplogs, which may take a long time.

Restrictions

Identities: You must have one of the following identities:

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:

Options and Arguments

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.

–c·omment comment | –cfi·le comment-file-pname | –cq·uery | –cqe·ach | –nc·omment
Overrides the default with the specified comment option.

Specifying the Replica

Default
None.

replica-selector
Specifies the VOB-replica object to be deleted from the current replica’s database. Specify replica-selector in the form [replica:]replica-name[@vob-selector]

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)

Examples

For an example of removing a VOB-replica object, see Deleting a Replica.

See Also

chmaster, mkreplica