rmreplica

Deletes a VOB-replica object

APPLICABILITY

SYNOPSIS

rmreplica [ -c·omment comment | -cfi·le comment-file-pname | -cq·uery

| -cqe·ach | -nc·omment ] replica-selector

DESCRIPTION

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.

RESTRICTIONS

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.

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

• 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".

SEE ALSO

chmaster, mkreplica