lsepoch

Lists epoch information
Related reference:
chepoch
recoverpacket
restorereplica

Applicability

Product Command type
MultiSite multiutil subcommand
Platform
UNIX
Windows

Synopsis

lsepoch

[ –cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [ –p/assword] password [ replica ...]

Description

This command displays the epoch number matrix for a replica. The replica's own epoch row in its matrix represents its actual state. The other rows represent the replica's estimate of the 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.)

Restrictions

You must have Super User privileges. If you do not specify a clan or site, the user name and password must be valid for all local instances of clans and sites.

Options and arguments

Specifying the clan, site, and family

Default
Lists epoch estimates for all local clans and sites.
–cl/an clan-name
Clan for which you want to list epoch information.
–site site-name
Site for which you want to list epoch information.
–fam/ily family-name
Family for which you want to list epoch information.

User database family: Database name given to the user database when it was created.

Schema repository family: The family name is MASTR.

Specifying a user name and password

Default
You must specify a user name and password.
–u/ser user
Name of a user with Super User privileges.
–p/assword password
Password associated with the specified user.

Specifying the replica

Default
Lists the epoch numbers for each replica in the family. If you do not specify a clan or site, the epoch estimates for all local instances of clans and sites, respectively, are listed.
replica ...
Site of the replica for which you want to list epoch information.

Examples

In these examples, the lines are broken for readability. You must enter each command on a single physical line.

  • List epoch numbers in the boston_hub replica for the entire DEV family. In this example, the only replicas in the family are boston_hub and sanfran_hub.

    multiutil lsepoch -clan telecomm -site boston_hub -family DEV
    -user susan -p passwd
    Multiutil: Estimates of the epochs from each site replayed at
    site `BOSTON_HUB' (@minuteman):
    BOSTON_HUB: 4
    SANFRAN_HUB: 4
    Multiutil: Estimates of the epochs from each site replayed at
    site `SANFRAN_HUB' (@goldengate):
    BOSTON_HUB: 4
    SANFRAN_HUB: 4

  • List the boston_hub replica's estimate of the state of replica sanfran_hub in the DEV family.

    multiutil lsepoch -clan telecomm -site boston_hub -family DEV
    -user susan -p passwd sanfran_hub
    Multiutil: Estimates of the epochs from each site replayed at
    site `sanfran_hub' (@goldengate):
    BOSTON_HUB: 5
    SANFRAN_HUB: 3

  • List epoch numbers in the tokyo replica for the entire MASTR family. In this example, you can see that the sydney replica needs an update from the tokyo replica.

    multiutil lsepoch -clan testclan -site tokyo -family MASTR
    -user masako -p passwd
    Multiutil: Estimates of the epochs from each site replayed at
    site `TOKYO' (@shinjuku):
    TOKYO: 1
    SYDNEY: 0
    Multiutil: Estimates of the epochs from each site replayed at
    site `SYDNEY' (@taronga):
    TOKYO: 0
    SYDNEY: 0