[ –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] |
–working/master } [ –f/orce 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.
Site: Current site. If there is more than one site on this host, –site is required.
Family: No default; you must specify a family.
Schema repository family: The family name is MASTR. You must specify MASTR when you use the –workingmaster option.
group:group-name
group:group-name<keysite-name>
For information about making names unique, see "Troubleshooting MultiSite operations - Resolving naming conflicts" in this guide.
With –long, chmaster lists the objects whose mastership is changing.
When you use this option, you must specify –family MASTR.
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).
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'.