chepoch
Applicability
| Product | Command type |
|---|---|
| MultiSite | multiutil subcommand |
| Platform |
|---|
| UNIX |
| Windows |
Synopsis
- chepoch
[ –cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser user-name [ –p/assword ] password { [ –f/orce ]
replica [ replica=value ... ] }
Description
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.
Restrictions
You must have Super User privileges.
Options and arguments
Specifying the clan, site, and family
- Default
- Clan: First clan replicated at this site. If there is more than one dbset
connection registered on this host, –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.
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.
Suppressing interactive prompts
- Default
- You must confirm each change.
- –f/orce
- Suppresses confirmation steps.
Specifying the changes
- 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:
- replica
- Column of the epoch number matrix. This argument, along with the preceding replica argument, specifies a particular location in the matrix.
- value
- New epoch number to be entered at the specified matrix location.
Examples
In these examples, the lines are broken for readability. You must enter each command on a single physical line.
- Change two columns of epoch estimates in the boston_hub replica's
row for the sanfran_hub replica.
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 - Similar to preceding example, but use –force to suppress confirmation
steps.
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