lsepoch

Displays epoch information

APPLICABILITY

SYNOPSIS

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

DESCRIPTION

By default, lsepoch displays the epoch number matrix of the VOB replica containing the current working directory. The replica's own epoch row represents its actual state. The other rows represent the replica's best estimate of other replicas' states.

NOTE: lsepoch output includes rows for replicas that have been deleted, in addition to the rows for replicas still in use. Oplog records for deleted replicas are saved in case a replica undergoing restoration must receive oplogs from the deleted replica. (For example, a replica may be restored from a backup created before the deleted replica was removed.)

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.

RESTRICTIONS

None.

OPTIONS AND ARGUMENTS

-invob vob-selector

Displays the epoch number matrix of the current replica in the VOB 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)

EXAMPLES

• Display the epoch number matrix for the current replica in the VOB 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 VOB 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)

SEE ALSO

chepoch, recoverpacket, restorereplica