chreplica
Changes the properties of a replica
Applicability
Product | Command type |
---|---|
MultiSite | multitool subcommand |
Platform |
---|
UNIX® |
Linux |
Windows® |
Synopsis
- chrep/lica
- [ –c/omment comment | –cfi/le comment-file-pname | –cq/uery | –cqe/ach | –nc/omment ] [ –hos/t hostname ] [ –pre/serve | –per/ms_preserve | –npr/eserve ] [ –isconn/ected | –nconn/ected ] [ –inreplica replica-name] replica-selector
Description
This command changes the properties of a replica.
Restrictions
Identities: You must have one of the following identities:
- Creator of the replica where you enter the command
- Owner of the replica where you enter the command
- VOB owner
- root (Linux®)
- Member of the VersionVault administrators group (Windows®)
Locks: An error occurs if one or more of these objects are locked: VOB object, replica object.
Mastership: With –isconnected and –nconnected, there are no mastership restrictions. With all other options, your current replica must master the replica being changed.
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 change
- Default
- None. You must specify at least one of the options described in this section. Note: Depending on the VOB family feature level, some options might not be applicable; see technote 73065 for details.
- –hos/t hostname
- Changes the host name associated with the specified replica. hostname must be
usable by hosts in different domains.
hostname can be either the IP address of the host or the computer name, for example, minuteman. You may have to append an IP domain name, for example, minuteman.purpledoc.com.
On Linux® system, use the uname–n command to display the computer name. On Windows® 2000, the computer name is displayed on the Network Identification tab in the System Properties window, which is accessible from the System icon in Control Panel. On Windows® XP, the computer name is displayed on the Computer Name tab in the System Properties window, which is accessible from the System icon in Control Panel.
- –pre/serve
- Makes the specified replica identities- and permissions-preserving.
- –per/ms_preserve
- Makes the specified replica permissions-preserving.
- –npr/eserve
- Makes the specified replica nonpreserving.
- –isconn/ected | –nconn/ected
- Indicates whether the replica has IP connectivity to the current replica. You must specify a sibling replica; you cannot set this property for your current replica.
- –inreplica replica-name
- Changes the properties of a replica as they are known to the replica specified by
replica-name.Note: To use this option, you must have Change or Full permissions on the MultiSite Administration ACL for the remote replica's host.
Specifying the replica
- Default
- None.
- replica-selector
- Specifies the replica to be changed. 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
- Associate replica bangalore with host ramohalli in
the database of the current replica.
multitool chreplica –host ramohalli bangalore
Updated replica information for "bangalore". - Make replica tokyo a nonpreserving replica.
multitool chreplica –npreserve tokyo@/vobs/doc
Updated replica information for "tokyo". - Mark replica sydney as not connected.
multitool chreplica –nconnected sydney@\doc
Updated replica information for "sydney".