6 Jun 2013
gfservice-agent 1 Gfarm
gfservice-agent `gfservice` のエージェント
`gfservice-agent` オプション ホスト ID サブコマンド 引数 ...

## DESCRIPTION

`gfservice-agent` は、`gfservice` の エージェントです。 `gfservice` を用いて操作したいホストすべてに、この エージェントをインストールする必要があります。 `gfservice` と異なり、設定ファイルは読み込みません。

`gfservice-agent` は、ユーザが直接実行することを意図 して作成されたものではありません。 日常の利用では、SSH と Sudo を介して `gfservice` コマンド によって実行されるだけです。

ホスト ID 引数は `gfservice` のものと同じですが、 `gfservice-agent` ではホスト ID をホストの種別 ("gfmd", "gfsd", "client" のいずれか) を区別するため、および デバッグメッセージのためにしか使っていません。

`gfservice-agent` のサブコマンド名は `gfservice` のものに似ていますが、引数は異なります。 たとえば、`gfservice-agent` の `unmount` サブコマンドは、 「directory=ディレクトリ」 という引数をとります。

    	gfservice-agent client3 unmount directory=/somewhere

これに対して、`gfservice` では、 「ディレクトリ」という引数をとります。

    	gfservice unmount client3 /somewhere

`gfservice-agent` の引数はほとんどすべて、「キー=値」 という形になっています。 複数の引数をとる場合、引数の順序は任意です。 `gfservice-agent` は、未知のキーを無視します。

## OPTIONS

`-d`

  デバッグ情報を出力します。

## SUB-COMMANDS

`gfservice-agent` は現在のところ、次のサブコマンドを 認識します。

`get-config-gfarm-param` param=パラメタ名 config-gfarm-options=オプション

  「`config-gfarm -T`」コマンドを実行して、 「パラメタ名 」の値を標準出力に出力します。 引数「param=パラメタ名」 が省略された場合は、「`config-gfarm -T`」コマンドの 結果すべてを出力します。

`get-config-gfsd-param` param=パラメタ名 config-gfsd-options=オプション

  「`config-gfsd -T`」コマンドを実行して、 「パラメタ名」の値を標準出力に 出力します。 引数「param=パラメタ名」 が省略された場合は、「`config-gfsd -T`」コマンドの 結果すべてを出力します。

`backend-db-status` config-gfarm-options=オプション

  バックエンドデータベースが動作中であれば、終了コード 0 で終了します。 それ以外の場合は、1 で終了します。

`gfmd-status` config-gfarm-options=オプション

  gfmd が動作中であれば、終了コード 0 で終了します。 それ以外の場合は、1 で終了します。

`gfsd-status` config-gfsd-options=オプション

  gfsd が動作中であれば、終了コード 0 で終了します。 それ以外の場合は、1 で終了します。

`start-backend-db` config-gfarm-options=オプション timeout=時間

  バックエンドデータベースが実行中でなければ、実行を開始します。

`start-gfmd` config-gfarm-options=オプション timeout=時間

  gfmd が実行中でなければ、実行を開始します。

`start-gfsd` config-gfsd-options=オプション timeout=時間

  gfsd が実行中でなければ、実行を開始します。

`config-gfarm` config-gfarm-options=オプション

  「`config-gfarm`」コマンドを実行します。

`config-gfarm-master` config-gfarm-options=オプション

  「`config-gfarm` -r」コマンドを実行 します。

`config-gfsd` config-gfsd-options=オプション

  「`config-gfsd`」コマンドを実行します。

`unconfig-gfarm` config-gfarm-options=オプション

  `stop-gfarm` サブコマンドを実行して、その後 gfmd と バックエンドデータベースが作成したファイルやディレクトリをすべて削除します。

`unconfig-gfsd` config-gfsd-options=オプション

  サブコマンド `stop-gfsd` を実行し、その後 gfsd が作成した ファイルやディレクトリをすべて削除します。

`unconfig-client` config-gfsd-options=オプション

  `gfarm2.conf` ファイルと共有秘密鍵ファイルを削除します。

`promote` config-gfarm-options=オプション

  `gfmd` をスレーブからマスターへ昇格させます。

`promote-gfmd` config-gfarm-options=オプション

  サブコマンド `promote` の別名です。

`mount` directory=ディレクトリ options=オプション

  Gfarm2 ファイルシステムを「ディレクトリ」に マウントします。

`unmount` directory=ディレクトリ

  「ディレクトリ」にマウントされた Gfarm2 ファイルシステムをアンマウントします。

`umount` directory=ディレクトリ

  サブコマンド `unmount` の別名です。

`set-gfmd-conf` directive=設定名称 value=値

  `gfmd.conf` ファイルに、

      	設定名称 値

  という行を追加します。

`set-gfarm-conf` directive=設定名称 value=値

  `gfarm2.conf` ファイルに、

      	設定名称 値

  という行を追加します。

`set-gfsd-conf` directive=設定名称 value=値

  `gfsd.conf` ファイルに、

      	設定名称 値

  という行を追加します。

`unset-gfmd-conf` directive=設定名称

  「設定名称」行を `gfmd.conf` ファイルから削除します。

`unset-gfarm-conf` directive=設定名称

  「設定名称」行を `gfarm.conf` ファイルから削除します。

`unset-gfsd-conf` directive=設定名称

  「設定名称」行を `gfsd.conf` ファイルから削除します。

`backup-backend-db`

  バックエンドデータベースのバックアップを行い、バックアップデータを標準出力 へ出力します。

`backup-gfmd-conf`

  `gfmd.conf` ファイルを標準出力に出力します。

`backup-gfarm-conf`

  `gfarm2.conf` ファイルを標準出力に出力します。

`backup-gfsd-conf`

  `gfsd.conf` ファイルを標準出力に出力します。

`backup-usermap`

  `usermap` ファイルを標準出力に出力します。

`backup-shared-key`

  `$HOME/.gfarm_shared_key` ファイルを標準出力に 出力します。

`restore-backend-db`

  バックエンドデータベースをリストアします。 バックアップデータは、標準入力から読み込みます。

`restore-gfmd-conf`

  `gfmd.conf` ファイルをリストアします。 バックアップデータは、標準入力から読み込みます。

`restore-gfarm-conf`

  `gfarm2.conf` ファイルをリストアします。 バックアップデータは、標準入力から読み込みます。

`restore-gfsd-conf`

  `gfsd.conf` ファイルをリストアします。 バックアップデータは、標準入力から読み込みます。

`restore-usermap`

  `usermap` ファイルをリストアします。 バックアップデータは、標準入力から読み込みます。

`restore-shared-key`

  `$HOME/.gfarm_shared_key` ファイルをリストアします。 バックアップデータは、標準入力から読み込みます。

`gfcmd` cmd=コマンド名 args="コマンドの引数 ..."

  Gfarm コマンドを実行します。

`grid-proxy-init` args="コマンドの引数 ..."

  `grid-proxy-init` コマンドを実行します。