Changing Mastership of Database Objects


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:

  1. At the master replica, change mastership of one or more objects to another replica.
  2. At the old master replica, export an update packet from the old master replica to the new master replica.
  3. At the new master replica, import the update packet.

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:

Transferring Mastership of a Record with the GUI

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:

  1. In the Workspace, expand Record Types, and then expand the desired record type.
  2. Double-click the form.
  3. Click the tab to which you want to add the field, or click Edit > Add Tab to add a new tab to contain the field.
  4. Using the Field List, drag the ratl_mastership field to the tab.
  5. Check in the modified schema.
  6. Upgrade the appropriate user databases to use the new schema.
  7. Generate and send an update packet. Update packets automatically contain schema updates. Administrators at other sites must upgrade their user database replicas to use the new schema revision. For more information, see Applying Packets That Include Schema Updates.

For more information about modifying a schema, see the Administrator’s Guide for Rational ClearQuest.

Transferring Mastership of a Record with chmaster

To transfer mastership of a record:

  1. At the master replica (in this example, boston_hub), enter a chmaster command:
  2. 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’
  3. At the old master replica, export an update packet to the new master replica:
  4. multiutil syncreplica -export -clan telecomm -site boston_hub -family DOC 
    -user susan -password passwd -workdir d:\shipping\temp -fship -sclass 
    cq_default bangalore 
  5. At the new master replica, import the packet:
  6. multiutil syncreplica -import -clan telecomm -site bangalore -family DOC -user 
    kumar -password passwd -receive -sclass cq_default 
  7. At the new master replica, verify that mastership has been received:
  8. multiutil describe -clan telecomm -site bangalore -family DOC -user kumar 
    -password passwd entity:DOC00013
    multiutil: The mastership of entity:DOC00013 is ‘bangalore’

Transferring Mastership of a Workspace Item with the GUI

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.

  1. In the Workspace, right-click the item you want to modify and click Mastership.
  2. In the Change Mastership dialog box, select the new master replica from the New Mastering Site list.
  3. Click OK.
  4. Export an update packet from the old master replica to the new master replica, and import the packet at the new master replica.

Transferring Mastership of a Workspace Item with chmaster

Follow these guidelines to specify Workspace items:

For example:

"Workspace:Personal Queries(susan)\My Projects\My Query" 

To change mastership of a Workspace item:

  1. At the master replica (in this example, boston_hub), enter a chmaster command:
  2. multiutil chmaster -clan telecomm -site boston_hub -family DOC -user susan 
    -password passwd bangalore "Workspace:Public Queries\Triage\project 
    report" 
  3. At the old master replica, export an update packet to the new master replica:
  4. multiutil syncreplica -export -clan telecomm -site boston_hub -family DOC 
    -user susan -password passwd -workdir d:\shipping\temp -fship -sclass 
    cq_default bangalore 
  5. At the new master replica, import the packet:
  6. multiutil syncreplica -import -clan telecomm -site bangalore -family DOC -user 
    kumar -password passwd -receive -sclass cq_default 
  7. At the new master replica, verify that mastership has been received:
  8. 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’

Transferring Mastership of a User or Group

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:

  1. At the old master replica:
    1. Use the chmaster command or the ClearQuest Designer to change the mastership of the users or groups to the new replica.
    2. Export an update packet to the new master replica.
  2. Notify the administrator of the new master replica that the incoming packet requires a user database upgrade.
  3. At the new master replica:
    1. Import the update packet.
    2. Upgrade the associated user databases with the changes.
    3. Export and send a synchronization packet to ensure that other replicas in the family are updated with the change.

Changing Mastership of Users or Groups with the GUI

To change mastership of a user:

  1. In ClearQuest Designer, click Tools > User Administration.
  2. In the User Administration dialog box, double-click the user you want to modify.
  3. In the User Properties dialog box, open the Mastership list and select the new master replica.
  4. Click OK.
  5. Click OK.
  6. Export and send an update packet from the old master replica to the new master replica, and import the packet at the new master replica.

To change mastership of a user group:

  1. In ClearQuest Designer, click Tools > User Administration.
  2. In the User Administration dialog box, select the user group you want to modify.
  3. Click Group Action > Edit Group.
  4. In the Group Property dialog box, open the Mastership list and select the new master replica.
  5. Click OK.
  6. Click OK.
  7. Export and send an update packet from the old master replica to the new master replica, and import the packet at the new master replica.

Changing Mastership of Users or Groups with chmaster

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.

  1. At the master replica (in this example, boston_hub), enter a chmaster command:
  2. 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.
  3. At the old master replica, export an update packet to the new master replica:
  4. multiutil syncreplica -export -clan telecomm -site boston_hub -family DOC 
    -user susan -password passwd -workdir d:\shipping\temp -fship -sclass 
    cq_default bangalore 
  5. At the new master replica, import the packet:
  6. multiutil syncreplica -import -clan telecomm -site bangalore -family DOC -user 
    kumar -password passwd -receive -sclass cq_default 
  7. At the new master replica, upgrade the user database with the new user information. For more information about upgrading user databases, see the Administrator’s Guide for Rational ClearQuest.
  8. At the new master replica, verify that mastership has been received:
  9. 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'

Transferring Mastership of a Working Schema Repository

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:

  1. At the working schema repository replica, enter a chmaster command:
  2. multiutil chmaster -clan telecomm -site boston_hub -family MASTR -user susan 
    –password passwd sanfran_hub -workingmaster 
  3. At the old working schema repository, export an update packet to the new working schema repository:
  4. multiutil syncreplica -export -family MASTR -user susan -password passwd 
    -workdir c:\temp\shipping -fship -sc cq_default sanfran_hub 
  5. At the new working schema repository, import the packet:
  6. multiutil syncreplica -import -family MASTR -user jcole -password passwd 
    -receive -sc cq_default 
  7. At the new working schema repository, verify that mastership has been received:
  8. multiutil describe -clan telecomm -site sanfran_hub -family MASTR 
    -workingmaster