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 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 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 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 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 and the UNIX 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".