You can transfer mastership of an object with a chmaster command or with the GUI. Mastership changes are appropriate in the following situations:
Mastership changes are communicated among replicas by the standard synchronization mechanism. The general procedure for changing mastership is as follows:
Until the update packet that contains the mastership change is imported at the new master replica, the mastership change is “in the packet,” and the replicas in the database family have different information about which replica masters the object.
For example, the administrator at the sanfran_hub replica transfers mastership of the user group QA_ENGINEERING to the bangalore replica and exports an update packet. At this point:
When you complete the mastership transfer by importing the update packet at bangalore, users at bangalore can modify the user group QA_ENGINEERING.
Notes on mastership changes:
ClearQuest MultiSite includes a system field called ratl_mastership. The value of this field is the replica that masters the respective record. To allow users to change the mastership of a record, you must add this field to the form of the record type. You can add the ratl_mastership field to the form of a record type at any time.
Note: Only users at the master replica of a record can change its mastership.
For each record type for which you want to allow users to change record mastership, use the ClearQuest Designer at the working schema repository to modify the schema of the replica family. To add the ratl_mastership field to a record form:
For more information about modifying a schema, see the Administrator’s Guide for Rational ClearQuest.
To transfer mastership of a record:
multiutil chmaster -clan telecomm -site boston_hub -family DOC -user susan -password passwd bangalore entity:DOC00013 multiutil: The mastership of entity:DOC00013 has been changed to site ‘bangalore’
multiutil syncreplica -export -clan telecomm -site boston_hub -family DOC -user susan -password passwd -workdir d:\shipping\temp -fship -sclass cq_default bangalore
multiutil syncreplica -import -clan telecomm -site bangalore -family DOC -user kumar -password passwd -receive -sclass cq_default
multiutil describe -clan telecomm -site bangalore -family DOC -user kumar -password passwd entity:DOC00013 multiutil: The mastership of entity:DOC00013 is ‘bangalore’
To change mastership of a Workspace item by using the ClearQuest client:
Note: You must have Public Folder Administrator privileges to modify Workspace items in the Public Queries folder.
Follow these guidelines to specify Workspace items:
For example:
To change mastership of a Workspace item:
multiutil chmaster -clan telecomm -site boston_hub -family DOC -user susan -password passwd bangalore "Workspace:Public Queries\Triage\project report"
multiutil syncreplica -export -clan telecomm -site boston_hub -family DOC -user susan -password passwd -workdir d:\shipping\temp -fship -sclass cq_default bangalore
multiutil syncreplica -import -clan telecomm -site bangalore -family DOC -user kumar -password passwd -receive -sclass cq_default
multiutil describe -clan telecomm -site bangalore -family DOC -user kumar -password passwd "Workspace:Public Queries\Triage\project report" multiutil: The mastership of Workspace:Public Queries\Triage\project report is ‘bangalore’
If you receive a synchronization packet that contains user administration changes such as new users or groups, you must upgrade the user database to use the changes. For more information about administering users in a MultiSite environment, see the Administrator’s Guide for Rational ClearQuest.
To change the mastership of a user or group, do the following things:
To change mastership of a user:
To change mastership of a user group:
Use the following conventions to specify users and groups:
The following example changes the mastership of users John Smith and Jane Doe from the boston_hub replica to the bangalore replica.
multiutil chmaster -clan telecomm -site boston_hub -family DOC -user susan -password passwd bangalore user:"John Smith" user:"Jane Doe" multiutil: The mastership of records "Jane Doe" and "John Smith"of type "user" has been changed to site ‘bangalore’ multiutil:The mastership of some users or groups have been transferred from this site. The local user admin must update user databases at the new mastering site 'BANGALORE' before these changes will be visible to any user database.
multiutil syncreplica -export -clan telecomm -site boston_hub -family DOC -user susan -password passwd -workdir d:\shipping\temp -fship -sclass cq_default bangalore
multiutil syncreplica -import -clan telecomm -site bangalore -family DOC -user kumar -password passwd -receive -sclass cq_default
multiutil describe -clan telecomm -site bangalore -family DOC -user kumar -password passwd user:"John Smith" user:"Jane Doe" multiutil: The mastership of user:John Smith is 'bangalore' multiutil: The mastership of user:Jane Doe is 'bangalore'
The administrator at the working schema repository is responsible for modifying schemas and adding new families to a clan. For more information, see Kinds of Schema Repositories. If you want to transfer responsibility for these tasks to another site, you must change mastership of the working schema repository.
To transfer mastership of a working schema repository:
multiutil chmaster -clan telecomm -site boston_hub -family MASTR -user susan –password passwd sanfran_hub -workingmaster
multiutil syncreplica -export -family MASTR -user susan -password passwd -workdir c:\temp\shipping -fship -sc cq_default sanfran_hub
multiutil syncreplica -import -family MASTR -user jcole -password passwd -receive -sc cq_default
multiutil describe -clan telecomm -site sanfran_hub -family MASTR -workingmaster