chmaster

オブジェクトのマスターシップを転送します。
関連概念
マスターシップの管理
関連資料
describe
syncreplica

適用性

製品名 コマンド タイプ
MultiSite multiutil サブコマンド
プラットフォーム
UNIXR
WindowsR

概要

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

説明

このコマンドは、1 つ以上のオブジェクトのマスターシップを複製間で転送します。現在の複製のみが即時に反映されます。他の複製は、更新パケットの通常の交換を介して、マスターシップの転送を通知されます。

制限

識別情報: スーパー ユーザー権限が必要です。

マスターシップ: 現在の複製がオブジェクトをマスター登録している必要があります。-force-forceall を使用するとこの制限を上書きしますが、特殊な状況以外では、これらのオプションを使用しないでください。

オプションと引数

所属、サイト、ファミリーの指定

デフォルト
所属: このサイトで複製された最初の所属です。このホストに複数のデータベース セット接続が登録されている場合は、-clan を指定する必要があります。

サイト: 現在のサイトです。このホストに複数のサイトがある場合は、-site を指定する必要があります。

ファミリー: デフォルトはありません。ファミリーを指定する必要があります。

-cl/an clan-name
複製の所属の名前。
-site site-name
複製のサイトの名前。
-fam/ily family-name
ユーザー データベース ファミリー: ユーザー データベースの作成時に付けられたデータベース名。

スキーマ リポジトリ ファミリー: ファミリー名は MASTR です。-workingmaster オプションを使用する場合は、MASTR を指定する必要があります。

ユーザー名とパスワードの指定

デフォルト
ユーザー名とパスワードを指定する必要があります。
-u/ser 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 マスターシップに転送します。エラーが発生した場合、コマンドは続行しますが、終了後、一部のマスターシップ変更が成功しなかったことが報告されます。

-long を指定すると、chmaster はマスターシップが変更されるオブジェクトを一覧表示します。

注: 作業スキーマ リポジトリのマスターシップを変更するには、-workingmaster を使用します。
-working/master
作業スキーマ リポジトリの マスターシップを指定したサイトに転送します。 -workingmaster オプションは、作業スキーマ リポジトリのサイトでのみ使用できます。

このオプションを使用する場合は、-family MASTR を指定する必要があります。

-f/orce obsolete-replica
重要: -force オプションを誤って使用すると、ファミリー内の複製間で相違が発生することがあります。

-force を指定すると、chmasterobsolete-replica が指定された複製内のすべてのオブジェクトのマスターシップを転送します。この形式の chmaster は、複製 obsolete-replica が使用できなくなった場合にのみ使用します (たとえば、意図せずに削除された場合)。

-forceall
重要: -forceall オプションを誤って使用すると、ファミリー内の複製間で相違が発生することがあります。

-forceall を指定すると、chmaster は、現在の複製がオブジェクトをマスター登録していない場合でも、オブジェクトのマスターシップを指定の複製に転送します。

以下の例では、読みやすいように行を分けてあります。各コマンドは、1 行に入力しなければなりません。

  • ユーザー admin のマスターシップを複製 boston_hub から sanfran_hub に転送します。

    multiutil chmaster -clan telecomm -site boston_hub -family DEV -user
    susan -p passwd sanfran_hub user:admin

    Multiutil: タイプ 'user' のレコード 'admin' のマスターシップが
    'BOSTON_HUB' から 'SANFRAN_HUB' に変更されました。
    Multiutil: 一部のユーザーまたはグループのマスターシップはこのサイトから転送されています。ローカルのユーザー管理者が
    新規マスター サイト 'sanfran_hub' にあるユーザー データベースを更新してからでないと、これらの変更はどのユーザー データベース
    からも参照可能になりません。

  • 作業スキーマ リポジトリを含む複製 tokyo で、すべてのスキーマと作業スキーマ リポジトリ タスクのマスターシップを複製 sydney に転送します。

    multiutil chmaster -clan testclan -site tokyo -family MASTR
    -user masako -p passwd sydney -workingmaster

    Multiutil: 動作中のマスターが 'TOKYO' から 'SYDNEY' に変更されました。

  • 複製 sanfran_hub がマスター登録する DEV データベース内のすべてのオブジェクトのマスターシップを複製 boston_hub に転送します。

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

    Multiutil: 変更されたオブジェクトの合計: 5。

  • 前の例と同様ですが、-long オプションを使用します。

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

    Multiutil: データベース 'DEV' 内の以下のオブジェクトのマスターシップが、
    'SANFRAN_HUB' から 'BOSTON_HUB' に変更されました。

    Multiutil: タイプ: customer、表示名: John Smith。
    Multiutil: タイプ: customer、表示名: Ethan Hunt。Multiutil: タイプ: customer、表示名: Jane Smith。Multiutil: タイプ: customer、表示名: Anne Johnson。Multiutil: タイプ: customer、表示名: 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: タイプ 'user' のレコード 'admin' のマスターシップが
    'SANFRAN_HUB' から 'TOKYO' に変更されました。


フィードバック