Transferring mastership of all objects mastered by a replica

Before removing a replica, you must transfer mastership of all objects mastered by that replica, using the chmaster –all command.

About this task

The following example shows a partially successful chmaster –all command and describes how to fix it. In this example, the administrator at replica bangalore is transferring mastership to boston_hub. 
RAMOHALLI> multitool chmaster –all –long boston_hub@\dev
Changed mastership of versioned object base \dev\
Changed mastership of directory element \dev\.@@
Changed mastership of directory element \dev\lost+found@@
...
multitool: Error: Branch type "bangalore_main" has branches (with 
default mastership) that have outstanding checkouts.
Changed mastership of branch type v1.0_bugfix
...
multitool: Error: Lock on label type "V1.0_BUGFIX" prevents operation 
"change master".
Changed mastership of label type BANGALORE_V2.0
...
Changed mastership of replica bangalore
multitool: Warning: Not all objects had mastership changed.
These errors prevent the successful completion of this chmaster command:
  • There are checkouts on the bangalore_main branch.
  • There is a lock on a label type.

Procedure

  1. Find the checkouts and either check in the files or cancel the checkouts: 
    H:\dev> cleartool lscheckout –all
03-Jun.17:28 jk checkout version "\dev\cmdsyn.c" from 
\main\bangalore_main\83 (unreserved)
08-Jun.12:45 singh     checkout version "\dev\etc\util\tool.c" from 
\main\bangalore_main\22 (unreserved)
...

    See the checkin, checkout, and uncheckout reference pages.

  2. Unlock the type object. 
    cleartool unlock lbtype:V1.0_BUGFIX@\dev
Unlocked label type "V1.0_BUGFIX".

    Alternatively, enter a lock –replace –nusers command and add yourself to the –nusers list. 

    cleartool lock –replace –nusers ms_admin lbtype:V1.0_BUGFIX@\dev
Locked label type "V1.0_BUGFIX".
  3. Reenter the chmaster command. 
    RAMOHALLI> multitool chmaster –all –long boston_hub@\dev
Changed mastership of branch type bangalore_main
Changed mastership of label type V1.0_BUGFIX
Changed mastership of all objects.