## 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)