lsepoch

lsepoch

[ –invob vob-selector | [ –actual ] replica-selector ... ]

This command displays the epoch number matrix for a replica. The replica's own epoch row represents its actual state. The other rows represent the replica's best estimate of other replicas' states.

With –actual, lsepoch contacts sibling replicas and retrieves their epoch rows. These epoch rows reflect the replicas' actual states. lsepoch–actual works only between sites with IP connections. If lsepoch cannot contact a sibling replica, it prints an error and tries to contact the next replica you specified. lsepoch –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.

None.

Default

Displays the epoch number matrix of the replica containing the current working directory.

–invob vob-selector

Displays the epoch number matrix of the current replica in the family specified by vob-selector. 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)

–actual

Retrieves epoch rows from sibling replicas.

replica-selector ...

Without –actual, displays the current replica's row for each specified replica. With –actual, contacts each specified replica and displays the replica's own epoch row. 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)

• Display the epoch number matrix for the current replica in the family /vobs/dev.

  
  
  cd /vobs/dev
  multitool lsepoch
  
  
  For VOB replica "/vobs/dev":
  Oplog IDs for row "bangalore" (@ ramohalli):
  oid:7ag3b0bc.defa11d0.ba57.00:01:72:73:3c:94=0      (bangalore)
  oid:87f6265f.72d911d4.a5cd.00:01:80:c0:4b:e7=950    (boston_hub)
  oid:0eaa6fc3.737d11d4.adbe.00:01:80:c0:4b:e7=10     (sanfran_hub)
  Oplog IDs for row "boston_hub" (@ minuteman):
  oid:7ag3b0bc.defa11d0.ba57.00:01:72:73:3c:94=0      (bangalore)
  oid:87f6265f.72d911d4.a5cd.00:01:80:c0:4b:e7=1      (boston_hub)
  oid:0eaa6fc3.737d11d4.adbe.00:01:80:c0:4b:e7=10     (sanfran_hub)
  Oplog IDs for row "sanfran_hub" (@ goldengate):
  oid:7ag3b0bc.defa11d0.ba57.00:01:72:73:3c:94=0      (bangalore)
  oid:87f6265f.72d911d4.a5cd.00:01:80:c0:4b:e7=1      (boston_hub)
  oid:0eaa6fc3.737d11d4.adbe.00:01:80:c0:4b:e7=16     (sanfran_hub)
  
  

• Display the epoch number matrix for the current replica in the family \doc.

  
  
  multitool lsepoch –invob \doc
  
  
  For VOB replica "\doc":
  Oplog IDs for row "boston_hub" (@ minuteman):
  oid:fb4d4850.093022d1.b033.00:50:98:97:24:76=836    (boston_hub)
  oid:lw5b4639.039011d1.b083.00:60:97:98:42:69=580    (sanfran_hub)
  Oplog IDs for row "sanfran_hub" (@ goldengate):
  oid:fb4d4850.093022d1.b033.00:50:98:97:24:76=600    (boston_hub)
  oid:lw5b4639.039011d1.b083.00:60:97:98:42:69=785    (sanfran_hub)
  
  

• List the current replica's estimate of the state of replica sydney.

  
  
  multitool lsepoch sydney@/vobs/dev
  
  
  For VOB replica "/vobs/dev":
  Oplog IDs for row "sydney" (@ sanfran_hub):
  oid:87f6265f.72d911d4.a5cd.00:01:80:c0:4b:e7=0      (boston_hub)
  oid:0eaa6fc3.737d11d4.adbe.00:01:80:c0:4b:e7=1      (sanfran_hub)
  oid:c6b8c9b0.038d11d1.b083.00:60:97:98:42:69=16     (sydney)
  
  

• List the actual state of the bangalore and buenosaires replicas.

  
  
  multitool lsepoch –actual bangalore@/vobs/dev buenosaires@/vobs/dev
  
  
  Contacting remote replica...
  bangalore:
  oid:7ag3b0bc.defa11d0.ba57.00:01:72:73:3c:94=0      (bangalore)
  oid:87f6265f.72d911d4.a5cd.00:01:80:c0:4b:e7=20     (boston_hub)
  oid:ac93e6cf.14a311d5.bbcc.00:01:80:c0:4b:e7=950    (buenosaires)
  Contacting remote replica...
  buenosaires:
  oid:7ag3b0bc.defa11d0.ba57.00:01:72:73:3c:94=0      (bangalore)
  oid:87f6265f.72d911d4.a5cd.00:01:80:c0:4b:e7=16     (boston_hub)
  oid:ac93e6cf.14a311d5.bbcc.00:01:80:c0:4b:e7=950    (buenosaires)
  
  

chepoch, recoverpacket, restorereplica