Provided by: gfarm-client_2.4.1-1ubuntu1_i386 bug

NAME

       gfhost - gfarm ホスト管理コマンド

SYNOPSIS

       gfhost [ -H | -l | -M ] [ -iLprUv ] [ -P path ] [ -a  ] [
       -D  ] [ -j  ] [  ... ]

       gfhost -c [ -P path ] -a -p [ -nCPU ]  
        [  ... ]

       gfhost -m [ -P path ] [ -a ] [ -p ] [ -nCPU ]
       [ -A ]  [  ... ]

       gfhost -d [ -P path ]  ...

       gfhost -R [ -P path ]

DESCRIPTION

       gfhost は、gfarm のファイルシステムノードに  関する情報の表示や管理を行
       ないます。gfhost  が  実行する機能は、-c, -d, -H, -l, -M, -m, -R のオプ
       ションで指定します。 これら機能の指定は排他的であり、どれか一つだけを指
       定することができます。 また、一つも指定しなかった場合には、デフォールト
       の機能であるホスト名 表示が行なわれます。

FUNCTIONS

       機能指定のうち、-c, -d, -M, -m, -R はメタデータサーバーのみを  アクセス
       し、登録されているホスト情報の追加、削除、表示、変更を行ないます。

       機能指定のうち、-H, -l, -M, および特に機能を指定しなかった場合は、 ファ
       イルシステムノードに関する情報を表示します。 このうち  -M  はメタデータ
       サーバーのみをアクセスしますが、 それ以外の機能はファイルシステムノード
       で動作している gfsd にもアクセスします。 gfsd  にアクセスする機能に関し
       ては、そのアクセスに 関するオプションを -i, -j, -U, -v で指定できます。

       表示機能に関しては、ホスト名の指定を省略することができます。この場合、
       メタデータに登録されている全てのホストに関する表示を試みます。 また、-a
       および  -D  オプションで表示するホストの種類を限定 することもできます。
       表示の順序は、ホスト名のアルファベット順ですが、-L, -r, -u オプションで
       順序を変更することができます。ただし、-M  機能 と、機能を指定しなかった
       場合 に関しては -L オプションは無効です。

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

       無指定 機能を特に指定しなかった場合、gfsd への 問い合わせを行ない、動作
              しているホストのホスト名のみを表示します。  デフォールトでは、ホ
              スト名のアルファベット順で表示します。

       -c     引数で指定したホストをメタデータへ登録します。   オプション   -a
              で、そのホストのアーキテクチャを指定する必要があります。  同様に
              オプション  -p  で、そのホストのポート番号を指定する必要がありま
              す。 オプション -n で、そのホストの CPU 数を指定します。省略した
              場合には 1 CPU だとみなします。

              ホスト名は、一つのコマンドで複数記述できます。この場合、最初に
              指定した名前が、そのホストの固有識別子として、複製情報の管理に
              用いられます。残りのホスト名は、そのホストに対する別名として  扱
              われます。

              あるホストが複数のネットワークインターフェースを持ち、それぞれの
              インターフェースに別々のホスト名が割り当てられている場合、それら
              全てのインターフェースのホスト名を、固有識別子あるいは別名として
              登録してください。

              また、/etc/hosts  ファイルや NIS の hosts データベースに登録され
              た ホスト名が、ドメイン部を含んでないような場合  (/etc/hosts  や
              NIS  hosts  データベースに FQDN が登録されてないような場合) も、
              必ずホストの別名登録が必要となります。このような場合、固有識別子
              としてドメイン名を含むホスト名 (FQDN) を、別名としてドメイン名を
              含まないホスト名を登録してください。

       -d     引数に指定したホスト情報をメタデータから削除します。  現在のとこ
              ろ、複製情報として参照されているホストも    削除できてしまいます
              が、これを行なうと複製データベースが不整合  状態となってしまいま
              すので注意が必要です。  ホスト名に指定できるのは  固有識別子のみ
              です。

       -H     gfsd に問い合わせて得た情報、すなわち ロードアベレージと認証手段
              を表示します。    この機能に関しては、引数でホスト名を指定した場
              合、表示される  のは、固有識別子として用いられているホスト名では
              なく、引数 で指定した名前になります。 また、ホスト名の後に、アク
              セスに用いられた IP アドレスを括弧で 囲って表示します。

              ホストが停止やネットワーク障害のためにアクセスできなかった場合、
              ロードアベレージの部分に  x.xx/x.xx/x.xx と表示します。 ホストが
              動作しているが、そのホストの gfsd へ  アクセスできなかった場合に
              は -.--/-.--/-.-- と表示します。

              その次の一桁の欄は認証手段で、「G」は   GSI   認証および暗号化、
              「g」は認証処理のみ       GSI       で認証後は保護のない生データ
              (gsi_auth)、 「s」は sharedsecret 認証、「x」は認証失敗、「-」は
              認証を  試みなかったことを示します。また、「-U」オプション指定時
              には、 この認証手段の表示欄はなくなります。

              デフォールトでは、ホスト名のアルファベット順で表示します。

       -l     gfsd に問い合わせて得た情報、 すなわちロードアベレージおよび認証
              手段と、  メタデータ・サーバーに問い合わせて得た情報、  すなわち
              アーキテクチャ名、CPU数およびホスト別名を 全て表示します。またア
              クセスに用いられたホスト名の後に、 IP アドレスを括弧で囲って表示
              します。

              ホストが停止やネットワーク障害のためにアクセスできなかった場合、
              ロードアベレージの部分に x.xx/x.xx/x.xx と表示します。  ホストが
              動作しているが、そのホストの  gfsd へ アクセスできなかった場合に
              は -.--/-.--/-.-- と表示します。

              その次の一桁の欄は認証手段で、「G」は   GSI   認証および暗号化、
              「g」は認証処理のみ       GSI       で認証後は保護のない生データ
              (gsi_auth)、 「s」は sharedsecret 認証、「x」は認証失敗、「-」は
              認証を  試みなかったことを示します。また、「-U」オプション指定時
              には、 この認証手段の表示欄はなくなります。

              デフォールトでは、ホスト名のアルファベット順で表示します。

       -M     メタデータに登録されているホスト情報を表示します。  デフォールト
              では、ホスト名のアルファベット順で表示します。

       -m     固有識別子として用いられているホスト名を指定し、メタデータ  に登
              録されているホスト情報を変更します。 -a オプションおよび -n オプ
              ションは、それぞれ既存の値を置き換えます。  これに対し、ホストの
              別名に関しては、追加を意味します。  追加ではなく、別名の置き換え
              や削除を行ないたい場合には、-A オプション を指定してください。こ
              の場合、全ての別名を削除してから、(もしあれば)  引数で指定した別
              名を追加します。

       -R     標準入力からホストに関する情報を読み込み、メタデータに  追加しま
              す。与える情報の形式は、-M 機能の表示形式と同じです。

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

OPTIONS

       -A     -m 機能でホスト情報を変更する際に、ホストの別名を 追加ではなく置
              き換えたい場合に、このオプションを指定します。

       -a 
              CPUアーキテクチャを、sparc-sun-solaris8  や i386-redhat8.0-linux
              の ような形式で指定します。 -c および -m  機能の場合には、追加・
              変更するホストのアーキテクチャと    して、このオプションを用いま
              す。 -H, -l, -M および特に機能を指定しなかった場合で、かつ  ホス
              ト名を省略した場合には、指定したアーキテクチャのホストに  関して
              のみ表示を行ないます。

       -D 
              -H, -l, -M および特に機能を指定しなかった場合で、かつ ホスト名を
              省略した場合に、このオプションで、表示するドメイン名を  限定でき
              ます。

       -i     %%SYSCONFDIR%%/gfarm2.conf    ないし    $HOME/.gfarm2rc     中で
              「address_use」を指定すると、 アクセスに用いるネットワークアドレ
              スに優先順位をつけることができます。   gfhost   コマンドに対して
              も、この優先順位は影響しますが、-i オプションを つけると、この指
              定を無視して gfsd にアクセス するようになります。

       -j 
              gfsd にアクセスする際の並列度を指定します。 デフォールトは 10 で
              す。

       -L     -H、-l  機能の場合  、このオプションで、  表示順序を、ロードアベ
              レージ順に変更します。

       -n CPU
              -c および -m 機能で、ホスト情報を追加・変更する際に、 そのホスト
              が持つ CPU の数を指定します。

       -p 
              -c および -m 機能で、ホスト情報を追加・変更する際に、 そのホスト
              の gfsd が用いるポート番号を指定します。

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

       -r     表示を整列している場合、表示の順序を逆にします。

       -u     -H, -l, -M  および特に機能を指定しなかった場合に、表示する順序を
              アルファベット順に整列するのを止めます。 -M 機能の場合、引数でホ
              スト名を指定した場合には  その順序、さもなくばメタデータから取得
              した順序で表示します。 -H, -l 機能の場合および特に機能を指定しな
              かった場合、  ホストに順に問い合わせを行い、返事の返ってきた順序
              で表示します。

       -U     TCP  による認証をやめ、 UDP によるロードアベレージの問い合わせの
              みを行うようにします。 このオプションは、-H ないし -l 機能を指定
              した場合および  特に機能を指定しなかった場合に意味のあるオプショ
              ンで、 実行速度が速くなる効果があります。 -H ないし -l  を指定し
              ている場合、このオプションを指定すると、  認証方式の表示欄がなく
              なります。

       -v     -H ないし -l  機能を指定した場合および特に機能を指定しなかった場
              合、 デフォールトでは、gfsd に対する問い合わせに関するエラーメッ
              セージ を表示しません。-v オプションを指定すると、このエラーメッ
              セージを 表示するようになります。

SEE ALSO

       gfarm2.conf(5), gfsd(8)