lsepoch

Lists epoch information

Applicability

Product Command type
MultiSite multitool subcommand
Platform
UNIX®
Linux
Windows®

Synopsis

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

Description

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.

Note: lsepoch output includes rows for deleted replicas, 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 operations 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

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)

Examples

  • 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)