Transfers mastership of an object
chmaster [ –cl·an clan-name ] [ –site site-name ] –fam·ily family-name
–u·ser username [ –p·assword ] password new-master-replica
{ { entity-selector... | { –all [ –l·ong ] | –workingmaster }
[ –force obsolete-replica | –forceall ] }
}
This command transfers the mastership of one or more objects from one replica to another. Only the current replica is affected immediately; other replicas are notified of the mastership transfers through the normal exchange of update packets.
Identities: You must have Super User privileges.
Mastership: Your current replica must master the object. Using –force or –forceall overrides this restriction, but you must not use these options except in special circumstances.
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. You must specify MASTR when you use the –workingmaster option.
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
None.
new-master-replica
The name of the replica to which you are transferring mastership.
Default
None. You must specify a particular object (entity-selector), all objects in a replica (–all), or only the working schema repository.
entity-selector
Specifies the object whose mastership you want to change. You can change mastership of the following objects:
For information about making names unique, see Resolving Naming Conflicts.
–a·ll [ –l·ong ]
Transfers to new-master-replica mastership of all objects located in and mastered by the replica you specify with –clan, –site, and –family. If errors occur, the command continues, but after finishing, it reports that not all mastership changes succeeded.
With –long, chmaster lists the objects whose mastership is changing.
Note: To change mastership of a working schema repository, use –workingmaster.
–workingmaster
Transfers mastership of a working schema repository to the site you specify. You can use this option only at the site of the working schema repository.
When you use this option, you must specify –family MASTR.
–f·orce obsolete-replica
Warning: Incorrect use of the –force option can lead to divergence among the replicas in a family.
With –force, chmaster transfers mastership of all objects in the replica specified with obsolete-replica. Use this form of chmaster only when replica obsolete-replica is no longer available (for example, it was deleted accidentally).
–f·orceall
Warning: Incorrect use of the –forceall option can lead to divergence among the replicas in a family.
With –forceall, chmaster transfers mastership of an object to a specified replica, even if the current replica does not master the object.
In these examples, the lines are broken for readability. You must enter each command on a single physical line.
multiutil chmaster -clan telecomm -site boston_hub -family DEV -user susan -p passwd sanfran_hub user:admin Multiutil: The mastership of record 'admin' of type 'user' has been changed from 'BOSTON_HUB' to 'SANFRAN_HUB'.
Multiutil: The mastership of some users or groups has been transferred from this site. The local user administrator must update user databases at the new mastering site 'sanfran_hub' before these changes will be visible to any user database.
multiutil chmaster -clan testclan -site tokyo -family MASTR -user masako -p passwd sydney -workingmaster Multiutil: The working master has been changed from 'TOKYO' to 'SYDNEY'.
multiutil chmaster -clan telecomm -site sanfran_hub -family DEV -user jcole -p passwd boston_hub -all Multiutil: Total number of objects changed: 5.
multiutil chmaster -clan telecomm -site sanfran_hub -family DEV -user jcole -p passwd boston_hub -all -long Multiutil: The mastership(s) of the following object(s) in database 'DEV' was(were) changed from 'SANFRAN_HUB' to 'BOSTON_HUB'.
Multiutil: Type: customer, display Name: John Smith. Multiutil: Type: customer, display Name: Ethan Hunt. Multiutil: Type: customer, display Name: Jane Smith. Multiutil: Type: customer, display Name: Anne Johnson. Multiutil: Type: customer, display Name: Joe Lee.
multiutil chmaster -clan telecomm -site boston_hub -family DOC -user susan -password passwd boston_hub -all -force bangalore
Change mastership of users and groups from the bangalore schema repository to boston_hub.
multiutil chmaster -clan telecomm -site boston_hub -family MASTR -user susan -password passwd boston_hub -all -force bangalore
Change mastership of the working schema repository from bangalore to boston_hub:
multiutil chmaster -clan telecomm -site boston_hub -family MASTR -user susan -password passwd boston-hub -workingmaster -force bangalore
multiutil chmaster -clan telecomm -site boston_hub -family DEV -user susan -p passwd tokyo user:admin –forceall Multiutil: The mastership of record 'admin' of type 'user' has been changed from 'SANFRAN_HUB' to 'TOKYO'.
describe, syncreplica
Managing Mastership