rmreplica

Deletes a VOB-replica object

Applicability

Product Command type
MultiSite multitool subcommand
Platform
UNIX
Linux
Windows

Synopsis

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

Description

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:
  • VOB owner
  • root (Linux and the UNIX system)
  • 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

For an example of removing a VOB-replica object, see the "Managing replicas" chapter of ClearCase MultiSite Administrator's Guidethis guide.