chmaster

轉送物件的主控權

適用性

產品 指令類型
MultiSite multiutil 次指令
平台
UNIX®
Windows®

用法概要

chmaster

[ –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] }
}

說明

這個指令將一或多個物件的主控權從一個抄本轉送到另一個抄本。只有現行抄本會立即受影響;會透過更新封包的正常交換向其他抄本通知已轉送主控權。

限制

身分:您必須有 Super User 專用權。

主控權:您現行的抄本必須主控物件。使用 –force–forceall 可置換這個限制;但除非遇到特殊情況,否則您絕不能使用這些選項。

選項和引數

指定群體、網站及系列

預設值
群體:在這個網站上第一個抄寫的群體。如果在這個主機上有多個登錄的 dbset 連線,則 –clan 是必要的。

網站:現行網站。如果在這個主機上有多個網站,則 –site 是必要的。

系列:無預設值;您必須指定系列。

–cl/an clan-name
抄本的群體名稱。
–site site-name
抄本的網站名稱。
–fam/ily family-name
使用者資料庫系列:建立使用者資料庫時提供的資料庫名稱。

綱目儲存庫系列:系列名稱為 MASTR。若使用 –workingmaster 選項,則必須指定 MASTR

指定使用者名稱及密碼

預設值
您必須指定使用者名稱和密碼。
–u/ser user
具有 Super User 專用權的使用者名稱。
–p/assword password
與指定使用者相關聯的密碼。

指定新的主要抄本

預設值
無。
new-master-replica
您要轉送主控權的抄本名稱。

指定物件

預設值
無。您必須指定特定物件 (entity-selector)、抄本中的所有物件 (–all),或僅工作中綱目儲存庫。
entity-selector
指定您要變更主控權的物件。您可以變更下列物件的主控權:
物件
語法
記錄
record-type:record-id
使用者或群組
user:username

group:group-name

公用工作區項目
"workspace:Public Queries\folder-name\query-name"
個人工作區項目
"workspace:Personal Queries(username)\folder-name\query-name"
沒有唯一名稱的無狀態記錄
record-type:record-id<keysite-name>
沒有唯一名稱的工作區項目
"workspace:query-name<keysite-name>"
沒有唯一名稱的使用者或群組
user:username<keysite-name>

group:group-name<keysite-name>

如需使名稱成為唯一的相關資訊,請參閱本手冊中的「疑難排解 MultiSite 作業 - 解析命名衝突」。

–a/ll [ –l/ong ]
轉送至您以 –clan–site–family 指定的抄本所主控且位於其中的所有物件之 new-master-replica 主控權。如果發生錯誤,指令會繼續執行,但在完成之後,它會報告並非所有的主控權變更都成功。

使用 –longchmaster 列出正在變更其主控權的物件。

註: 如果要變更工作中綱目儲存庫的主控權,請使用 –workingmaster
–working/master
將工作中綱目儲存庫的主控權轉送到您指定的網站。您只能將 –workingmaster 選項用於工作中綱目儲存庫的網站。

您使用這個選項時,必須指定 –family MASTR

–f/orce obsolete-replica
重要事項:不正確使用 –force 選項會造成系列的抄本差異。

使用 –forcechmaster 會將 obsolete-replica 指定之抄本中的所有物件主控權傳送出去。只有當不能再使用抄本 obsolete-replica 時(例如,意外加以刪除),才可以使用 chmaster 這個格式。

–forceall
重要事項:不正確使用 –forceall 選項會造成系列的抄本差異。

使用 –forceallchmaster 會將物件的主控權轉送到指定的抄本,即使現行抄本未主控物件也一樣。

範例

在這些範例中會斷行以便於閱讀,您必須在實際的一行中輸入每一個指令。

  • 將使用者 admin 的主控權從 boston_hub 抄本轉送到 sanfran_hub

    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.

  • tokyo 抄本(包含工作中綱目儲存庫),將所有綱目及工作中綱目儲存庫作業的主控權轉送至 sydney 抄本。

    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'.

  • DEV 資料庫(由 sanfran_hub 抄本主控)所有物件的主控權轉送到 boston_hub 抄本。

    multiutil chmaster -clan telecomm -site sanfran_hub -family DEV
    -user jcole -p passwd boston_hub -all

    Multiutil: Total number of objects changed: 5.

  • 類似上一個範例,但使用 –long 選項。

    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.

  • boston_hub 抄本,將 bangalore 抄本主控的所有項目之主控權轉送到 boston_hub 抄本。假設不再能夠使用 bangalore

    multiutil chmaster -clan telecomm -site boston_hub -family DOC
    -user susan -password passwd boston_hub -all -force bangalore

    將使用者和群組的主控權從 bangalore 綱目儲存庫變更為 boston_hub

    multiutil chmaster -clan telecomm -site boston_hub -family MASTR
    -user susan -password passwd boston_hub -all -force bangalore

    將工作中綱目儲存庫的主控權從 bangalore 變更為 boston_hub

    multiutil chmaster -clan telecomm -site boston_hub -family MASTR
    -user susan -password passwd boston-hub -workingmaster -force bangalore

  • boston_hub,使用 –forceall 將使用者 admin 的主控權從 sanfran_hub 變更為 tokyo

    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'.


意見