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.