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 VersionVault 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 VersionVault 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)