chreplica

Changes the properties of a replica

APPLICABILITY

SYNOPSIS

chrep·lica [ -c·omment comment | -cfi·le comment-file-pname | -cq·uery

| -cqe·ach | -nc·omment ] [ -hos·t hostname ]
[ -pre·serve | -npr·eserve ]
[ -isconn·ected | -nconn·ected ] replica-selector

DESCRIPTION

This command changes the properties of a VOB replica. For more information, see Changing the Host Name for a Replica and Changing Ownership Preservation.

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 (UNIX)

• 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 -host, -preserve, -npreserve, -isconnected, or -nconnected.

-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 the 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 the Control Panel.

-pre·serve

Makes the specified replica ownership-preserving.

-npr·eserve

Removes the specified replica from the set of ownership-preserving replicas.

-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

• 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 non-ownership-preserving replica.

multitool chreplica -npreserve tokyo
Updated replica information for "tokyo".

• Mark replica sydney as not connected.

multitool chreplica -nconnected sydney
Updated replica information for "sydney".

SEE ALSO

chmaster, syncreplica