Home
Command  Home
Scalable Graphic

Soft - is your software and documentation
Asset - is something that must be protected
Management - is what we do
Enterprise - is the capability
Computing - is the power
Services - are what we provide


   

A.    This command changes a replica's epoch number estimates for other replicas. You cannot change a replica's own epoch numbers because they record the actual state of the replica. With –actual, chepoch contacts sibling replicas, retrieves their own epoch rows, and changes their rows in the current replica's epoch number matrix. This brings the current replica's epoch number matrix up to date with changes made at the sibling replicas. chepoch –actual works only between sites that have IP connections. If chepoch cannot contact a sibling replica, it prints an error and tries to contact the next replica you specified.chepoch –actual detects whether the sibling replica or the current replica is missing oplog entries. If oplog entries are missing, the command prints one of the following messages:

Your replica ("replica-name") has fewer oplog entries for itself than "replica-selector" has for your replica.
To avoid permanent data loss, your VOB administrator must initiate the documented replica restoration procedure. The replica
"replica-name" has more oplog entries for "replica-selector" than "replica-selector" has for itself.
To avoid permanent data loss, its administrator must initiate the documented replica restoration procedure.


B.    Restrictions

Identities: You must have one of the following identities:  

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.

Mastership: No mastership restrictions.


C.    Contact sibling-replica-selector, retrieves its actual state, and changes its row in the epoch number matrix of the current replica.


D.    With -raise_only, chepoch raises epoch numbers for the sibling replica but does not lower any of them. This option optimizes synchronization when packets have been sent from the current replica to the sibling replica but have not yet been imported.


E.    replica-selector in the format:

[replica:]replica-name[@vob-selector]

Notes:

1. If you do not specify a vob-selector uses the current VOB

2. replica-name = the name of the replica display with lsreplica

3. 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 where pname-in-vob (Pathname of the VOB tag (whether or not the VOB is mounted) or of any file system object with the VOB (if the VOB is mounted)


F.    chepoch reads a set of replica-selector=value or oid=value pairs, one per line, from standard input. You can copy and paste lsepoch output, or type the data in the format described below. Extra white space is allowed. To terminate input, type a period character ( . ) and a carriage return (<CR>) at the beginning of a line.


G.    Specify sibling-replica-selector in the form [replica:]replica-name[@vob-selector]

For further breakdown see replica-selector comments above.

 

Table of Contents

Table of Contents. 3

How do I use the multitool chepoch command.. 3

1.       to change two columns in the current replica's row for the delhi replica. 3

2.       to change an item in a replica's estimate of the state of the delhi replica, specifying the VOB family of the replica whose matrix is to be changed. 4

3.       to set the current replica's estimate of the state of the sydney replica to its actual state. 4

4.       to update the current replica's epoch numbers for replicas boston and sydney. 4

 

How do I use the multitool chepoch command

1.   to change two columns in the current replica's row for the delhi replica.

multitool chepoch delhi  london=950 sydney=2000

Change oplog IDs in row "delhi" [no] yes
Epoch row successfully set.

Make the same change as in the preceding example, but bypass the confirmation steps

multitool chepoch –force delhi  london=950 sydney=2000

Epoch row successfully set.

Make the same change as in the preceding examples, specifying the changes as terminal input instead of as command-line arguments.

multitool chepoch delhi

Enter specifications for epochs to change in row "delhi"
(one per line)
oid:87f6265f.72d911d4.a5cd.00:01:80:c0:4b:e7=950
oid:0eaa6fc3.737d11d4.adbe.00:01:80:c0:4b:e7=2000
.
Change oplog IDs in row "delhi" [no] yes
Epoch row successfully set.

2.   to change an item in a replica's estimate of the state of the delhi replica, specifying the VOB family of the replica whose matrix is to be changed.

multitool chepoch –force delhi@/vobs/samecs sydney=800

Epoch row successfully set.

3.   to set the current replica's estimate of the state of the sydney replica to its actual state.

multitool chepoch –actual sydney@/vobs/samecs
Entry for              boston changed from:        1400 to        1300
Entry for              london changed from:         985 to         950
Entry for               delhi changed from:        2562 to        2000

4.   to update the current replica's epoch numbers for replicas boston and sydney.

multitool chepoch –actual boston@/vobs/samecs sudney@/vobs/samecs

Entry for           boston_hub changed from:        1400 to        1300
Entry for          sanfran_hub changed from:         985 to        1000

Make the same change as in the previous example, but do not lower any of the numbers.

multitool chepoch –actual –raise_only boston_hub@/vobs/dev
sanfran_hub@/vobs/dev
Entry for           boston_hub unchanged from:        1400
Entry for          sanfran_hub   changed from:         985 to     1000

 

This website is published "as is". There is no warranty of any kind (express or implied) as to the operation of our site, the accuracy of the information or the services or products referred to on it. All warranties are excluded as far as permitted at law. Neither we nor any third party will be liable for any losses or damage that may result from use of the website or as a consequence of any inaccuracies in, or any omissions from, the information which it contains.