Changes epoch number estimates
chepoch [ –cl·an clan-name ] [ –site site-name ] –fam·ily family-name
–u·ser user-name [ –p·assword ] password
{ [ –f·orce ] replica [ replica=value ... ] }
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. For more information about epoch numbers, see The Operation Log. For descriptions of scenarios using chepoch, see Cannot Find Oplog Entry and Recovering from Lost Packets.
You must have Super User privileges.
Default
Clan: First clan replicated at this site. If there is more than one clan at the site, –clan is required.
Site: Current site. If there is more than one site on this host, –site is required.
Family: No default; you must specify a family.
–cl·an clan-name
Name of the replica’s clan.
–site site-name
Name of the replica’s site.
–fam·ily family-name
User database family: Database name given to the user database when it was created.
Schema repository family: The family name is MASTR.
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.
Default
You must confirm each change.
–f·orce
Suppresses confirmation steps.
Default
You must specify the replica whose estimated epoch numbers are to be changed. chepoch reads a set of replica=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.
replica
Site name of the replica whose estimated epoch numbers are to be changed; that is, it changes the current replica’s estimate of the state of replica.
replica=value
One or more arguments, where
In these examples, the lines are broken for readability. You must enter each command on a single physical line.
multiutil chepoch -clan telecomm -site boston_hub -family SAMPL -user susan -p passwd sanfran_hub sanfran_hub=100 boston_hub=350 Multiutil: Change the estimate for the epochs of site ‘sanfran_hub’ replayed at site ‘sanfran_hub’ to 100 [yes|NO|quit] yes Multiutil: Change the estimate for the epochs of site ‘boston_hub’ replayed at site ‘sanfran_hub’ to 350 [yes|NO|quit] yes Multiutil: 2 epoch estimate(s) for site ‘sanfran_hub’ successfully changed; 0 failures. Multiutil: Estimates of the epochs from each site replayed at site ‘sanfran_hub’ (@goldengate): BOSTON_HUB: 350 SANFRAN_HUB: 100
multiutil chepoch -clan telecomm -site boston_hub -family SAMPL -user susan -p passwd sanfran_hub sanfran_hub=100 boston_hub=350 -force Multiutil: Estimates of the epochs from each site replayed at site ‘sanfran_hub’ (@goldengate): BOSTON_HUB: 350 SANFRAN_HUB: 100
lsepoch, recoverpacket, restorereplica