NAME

       gfmdhost - gfarm メタデータサーバ管理コマンド

SYNOPSIS

       gfmdhost [-l] [-P path] [-1]

       gfmdhost [-N] [-P path] [-1]

       gfmdhost {-c | -m} [-P path] [-1] [-p ポート番号] [-C クラスタ名] [-t {m | c | s}] {メタデータサーバ名}

       gfmdhost {-d} [-P path] [-1] {メタデータサーバ名}

DESCRIPTION

       gfmdhost は gfarm のメタデータサーバの冗長化機能に関連する情報の表示や管理を行います。 gfmdhost が実行す
       る機能は -l, -c, -m, -d のオプションで選択します。 これら機能の指定は排他的であり、どれか一つだけを指定す
       ることができます。 また、一つも指定しなかった場合には、 デフォルトの機能である gfmd ホスト名の一覧表示が
       行われます。

FUNCTIONS

       下記は、gfmdhostコマンドの機能一覧です。二つ以上の機能を同時に 指定することはできません。

       無指定
           登録されているgfmdホストのホスト名一覧を、 アルファベット順で表示します。

       -l
           登録されている gfmd ホストのホスト名一覧を、 詳細情報と共に表示します。クラスタ名ごとにホスト名を ア
           ルファベット順で表示します。

           詳細情報は次の順に表示されます。

           接続状態 (+|||-|?|x|e|u)

           "+" はマスター gfmd と正常に接続し、現在メタデータが同期している ことを表します。 "|" はマスター gfmd
           と正常に接続しているが、メタデータの同期が 完了していないことを表します。これは、たとえ同期スレーブ
           サーバで あっても、接続開始時には起きますし、いったん同期が完了した後で も、メタデータ転送の瞬間には
           起きることがあります。 "-" は接続していないことを表します。 "?" は、マスター gfmd と接続直後でまだ状
           態が判明してないか、あるいは Gfarm-2.5.0 の gfmd に対して、Gfarm-2.5.1 以降の gfmdhost コマンド から
           接続した場合に表示されます。 "x" はマスター gfmd と接続できたものの、切断している間の更新量が 多く自
           動同期が不可能となり、バックエンド・データベースのダンプ・ リストアを用いて同期をとる必要が生じている
           ことを表します。 "e" は何らかのエラーが生じ、ログの調査が必要なことを表します。 "x" および "e" につい
           ては、そのスレーブgfmdが停止した後でも、 表示が続きます。 "u" は、マスター gfmd と接続しているが、こ
           の gfmdhost コマンドでは サポートしていない状態にあることを示します。 Gfarm-2.5.0 の gfmd に対し
           て、Gfarm-2.5.1 以降の gfmdhost コマンド から接続した場合に表示されます。 マスター gfmd は常に "+" で
           す。

           サーバ種別 (master|slave)

           マスターであるか、スレーブであるかを表します。

           レプリケーション種別 (sync|async|-)

           sync は同期レプリケーション、 async は非同期レプリケーションを表します。 マスター gfmd には "-" が表
           示されます。

           マスター候補の設定 (c|m|s)

           m はデフォルトのマスター、c はマスター候補、 s はスレーブ専用の gfmd を表します。

           クラスタ名

           gfmd が属するクラスタ名です。 デフォルトのクラスタは "(default)" と表示されます。

       -N
           接続したメタデータサーバのホスト名とポート番号を表示します。

       -c
           引数で指定した gfmd ホストを登録します。 任意でオプション -C、-p、-t を指定します。

       -m
           引数で指定した gfmd ホストを変更します。 任意でオプション -C、-p、-t を指定します。

       -d
           引数で指定した gfmd ホストを削除します。 マスター gfmd を削除することはできません。

       -?
           引数オプションを表示します。

OPTIONS

       -C クラスタ名
           -c, -m 機能で gfmd ホストが属するクラスタ名を指定します。 省略した場合、デフォルトのクラスタに属しま
           す。

           クラスタ名は同期レプリケーションのグループを表します。 マスター gfmd と同一のクラスタに所属する gfmd
           間は同期レプリケー ションとなり、それ以外の gfmd は非同期レプリケーションとなります。 同期レプリケー
           ションが行われているスレーブ gfmd は、 メタデータ操作を失うことなくマスター gfmd に昇格することが可能
           です。

       -p ポート番号
           -c, -m 機能で gfmd のポート番号を指定します。 省略した場合、デフォルトのポート番号 601 を指定したこと
           になります。

       -t {m|c|s}
           -c, -m 機能でマスター候補の設定を指定します。 m はデフォルトのマスター、c はマスター候補、 s はスレー
           ブ専用を表します。 省略した場合、c を指定したことになります。 デフォルトのマスターをマスター候補およ
           びスレーブ専用へ、 直接変更することはできません。 デフォルトのマスター以外の gfmd を -t m によりデ
           フォルトのマスターに変更すると、 以前のデフォルトのマスターがマスター候補に変更されます。

       -P path
           このコマンドがアクセスするメタデータサーバを特定するための パス名または Gfarm URL を指定します。 省略
           した場合は、"/" を指定したのと同じ意味になります。

       -1
           このオプションを付与すると、gfmdhost はメタデータサーバ 1 台だけ に対して接続を試みます。 このとき接
           続を試みるのは、-P オプションで指定されたサーバか、 -P オプションが付与されていない場合は gfarm2.conf
           ファイルの中の metadb_server_host 行に指定されたサーバとなります。

SEE ALSO

       gfarm2.conf(5)

Gfarm                                             11 March 2014                                      GFMDHOST(1)