Troubleshooting commands

MultiSite provides commands you can use to troubleshoot failed requests for mastership.

To determine which replica masters a branch or branch type:
  • Use the cleartool describe command. For example: 
    cleartool describe –fmt "%[master]p\n" file1.txt@@\main
boston_hub@\dev

    cleartool describe –fmt "%[master]p\n" brtype:main@/vobs/doc
boston_hub@/vobs/doc
  • (Windows®) Display properties of the branch or branch type and click the Mastership tab.
To determine whether a mastership request will succeed:
  • Use reqmaster –list (see Status messages for descriptions of the output): 
    multitool reqmaster –nc –list file1.txt@@/main
multitool: Error: The following errors will be encountered
multitool: Error: file1.txt@@/main
Request Mastership remote "reqmaster" operation (host "taronga") would fail:
You do not have permission to request mastership from the sibling replica.
  • (Windows) In the Request Mastership window, click Preview Request for Mastership.
To list the event history of a branch or branch type and determine who has requested its mastership, use the lshistory –minor –fmt command: 

cleartool lshistory –min –fmt "%n\t%o\n%c" file.fm@@/main
file.fm@@/main chmaster
Reqmaster changed master replica from "boston_hub" to "buenosaires".
Requester: user "PURPLEDOC\fangio" in domain "PURPLEDOC" on host "mardelplata"
file.fm@@/main chmaster
Reqmaster changed master replica from "tokyo" to "boston_hub".
Requester: user "PURPLEDOC\susan" in domain "PURPLEDOC" on host "minuteman"
file.fm@@/main chmaster
Reqmaster changed master replica from "bangalore" to "tokyo".
Requester: user "PURPLEDOC\masako" in domain "PURPLEDOC" on host "shinjuku"
file.fm@@/main chmaster
Reqmaster changed master replica from "sanfran_hub" to "bangalore".
Requester: user "PURPLEDOC\kumar" in domain "PURPLEDOC" on host "ramohalli"
...

cleartool lshistory –min –fmt "%n\t%o\n%c" brtype:main@/vobs/doc
main chmaster
Reqmaster changed master replica from "sanfran_hub" to "boston_hub".
Requester: user "PURPLEDOC\susan" in domain "PURPLEDOC" on host "minuteman"
main chmaster
Reqmaster changed master replica from "tokyo" to "sanfran_hub".
Requester: user "PURPLEDOC\jcole" in domain "PURPLEDOC" on host "goldengate"
main chmaster
Reqmaster changed master replica from "bangalore" to "tokyo".
Requester: user "PURPLEDOC\masako" in domain "PURPLEDOC" on host "shinjuku"
...