chreplica


Changes the properties of a replica

Applicability

Product
Command type
MultiSite
multitool subcommand

Platform
UNIX
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 ] replica-selector

Description

This command changes the properties of a replica. For more information, see Changing the Host Name for a VOB Replica, Changing Preservation Mode for a VOB Family, and Setting the Connectivity Property for a VOB Replica.

Restrictions

Identities: You must have one of the following identities:

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.

–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 UNIX, use the uname –n command to display the computer name. On Windows NT, the computer name is displayed in the Network Settings dialog box, which is accessible from the Network icon in Control Panel. On Windows 2000, the computer name is displayed on the Network Identification tab in the System Properties dialog box, 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.

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

See Also

chmaster, syncreplica