Man page - gfservice(1)

Packages contains this manual

Package:  gfarm-client
apt-get install gfarm-client

Manuals in package:
• gfusage(1)
• gfgetfacl(1)
• gfservice(1)
• gfdirquota(1)
• gfreg(1)
• gfchgrp(1)
• gfquota(1)
• gfstat(1)
• gfsched(1)
• gfln(1)
• gfchown(1)
• gfedquota(1)
• gfexport(1)
• gfhostgroup(1)
• gfdf(1)
• gfmdhost(1)
• gfhost(1)
• gfquotacheck(1)
• gfgroup(1)
• gfmv(1)
• gfwhere(1)
• gfsudo(1)
• gfwhoami(1)
• gfstatus(1)
• gfpcopy(1)
• gfrm(1)
• gfrep(1)
• gfkey(1)
• gfcksum(1)
• gfprep(1)
• gflsof(1)
• gfchmod(1)
• gffindxmlattr(1)
• gfuser(1)
• gfncopy(1)
• gftest(1)
• gfls(1)
• gfsetfacl(1)
• gfrmdir(1)
• gfxattr(1)
• gfmkdir(1)
• gfarmbb(1)
Documentations in package:
• gfarm-client

Available languages:

en ja

Manual

GFSERVICE

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SUB-COMMANDS FOR GFMD
SUB-COMMANDS FOR GFSD
SUB-COMMANDS FOR CLIENT
SUB-COMMANDS FOR MULTIPLE HOSTS
PLUG-IN SYSTEM

---

NAME

gfservice - リ モ ー ト ホ ス ト か ら Gfarm の サ ー バ ー を 制 御 す る 。

SYNOPSIS

gfservice [ オ プ シ ョ ン ] サ ブ コ マ ン ド [ホ ス ト ID] [ 引 数  ... ]

DESCRIPTION

gfservice は 、 Gfarm の 管 理 者 が リ モ ー ト ホ ス ト 上 の サ ー バ ー ( gfmd 、 gfsd 、 PostgreSQL) を 操 作 す る た め の ツ ー ル で す 。 今 の と こ ろ 、 OpenLDAP に は 対 応 し て い ま せ ん 。 サ ー バ ー の 実 行 開 始 、 停 止 、 セ ッ ト ア ッ プ ( config-gfarm や config-gfsd の 実 行 )、 サ ー バ ー 廃 止 の 後 始 末 と い っ た こ と が で き ま す 。

gfservice の コ マ ン ド 行 は 、 た と え ば 次 の よ う に な り ま す 。

gfservice start-gfmd gfmd2

こ こ で 、 「 start-gfmd 」 は サ ブ コ マ ン ド 、 「 gfmd2 」 は ホ ス ト ID を そ れ ぞ れ 表 し て い ま す 。 こ の コ マ ン ド 行 を 実 行 す る と 、 gfservice は 「 gfmd2 」 と 名 付 け ら れ た ホ ス ト 上 の gfmd の 実 行 開 始 を 試 み ま す 。 リ モ ー ト の サ ー バ ー ホ ス ト を 指 定 す る 際 、 gfservice で は ホ ス ト 名 の 代 わ り に ホ ス ト ID を 用 い ま す 。 ホ ス ト ID ( gfmd1 、 gfmd2 、 ...) は gfservice 用 の 設 定 フ ァ イ ル で 定 義 し ま す 。 以 下 に 、 設 定 フ ァ イ ル の 記 述 例 を 載 せ ま す 。

	gfmd1=metadb1.example.com
	gfmd1_CONFIG_GFARM_OPTIONS="-A $LOGNAME -X"
	gfmd2=metadb2.example.com
	gfmd2_CONFIG_GFARM_OPTIONS="-A $LOGNAME -X"
	gfsd1=spool1.example.com
	gfsd2=spool2.example.com

gfservice は 、 読 み 込 む べ き 設 定 フ ァ イ ル の パ ス を 次 の 要 領 で 決 定 し ま す 。

1. 「 -f フ ァ イ ル 」 オ プ シ ョ ン が 指 定 さ れ て い れ ば 、 そ の フ ァ イ ル を 読 み 込 み ま す 。

2. 上 記 以 外 の 場 合 で 、 環 境 変 数 GFSERVICE_CONF が 定 義 さ れ 、 か つ 値 が 空 文 字 列 で な け れ ば 、 値 と し て 記 さ れ た フ ァ イ ル を 読 み 込 み ま す 。

3. 上 記 以 外 の 場 合 は 、 $HOME/.gfservice を 読 み 込 み ま す 。

gfservice は 設 定 フ ァ イ ル の 読 み 込 み に 失 敗 す る と 、 エ ラ ー メ ッ セ ー ジ を 出 力 し て 、 た だ ち に 終 了 し ま す 。 設 定 フ ァ イ ル そ れ 自 体 は Bourne シ ェ ル ス ク リ プ ト で 、 gfservice は そ の フ ァ イ ル を 自 身 の 一 部 と し て 取 り 込 み ま す (正 確 に 言 え ば 、 ス ク リ プ ト と し て 評 価 し ま す )。 設 定 フ ァ イ ル に つ い て の 詳 し い 説 明 は 、 gfservice.conf(5) を 参 照 し て 下 さ い 。

gfservice は 、 リ モ ー ト ホ ス ト と 接 続 す る た め に 、 SSH (Secure Shell) を 使 用 し ま す 。 サ ブ コ マ ン ド 1 個 の 処 理 を 遂 行 す る 間 、 何 度 も ssh を 実 行 す る こ と が あ る の で 、 SSH エ ー ジ ェ ン ト (OpenSSH の ssh-agent な ど ) を 用 い る か 、 パ ス フ レ ー ズ が 空 の 認 証 キ ー を 用 い る な ど し て 、 パ ス フ レ ー ズ を 毎 回 入 力 し な く て 済 む よ う に す る こ と を お 薦 め し ま す 。

SSH に 加 え て 、 gfservice は リ モ ー ト ホ ス ト 上 で root 権 限 を 得 る た め に Sudo コ マ ン ド を 使 用 し ま す 。 各 リ モ ー ト ホ ス ト の sudoers フ ァ イ ル (Sudo の 設 定 フ ァ イ ル ) に 以 下 の よ う な 行 を 足 し て 下 さ い 。

user ALL=(root, _gfarmfs, _gfarmmd) NOPASSWD: gfservice-agent

こ こ で 、 user は gfservice を 実 行 す る ユ ー ザ の 名 前 で す 。 NOPASSWD は 必 須 で は あ り ま せ ん が 、 省 く と sudo は 何 度 も パ ス ワ ー ド を 訊 い て く る こ と が あ り ま す 。

gfservice は SSH と Sudo を 用 い て 、 リ モ ー ト ホ ス ト 上 に あ る gfservice-agent と い う エ ー ジ ェ ン ト コ マ ン ド を 実 行 し ま す の で 、 gfservice コ マ ン ド で 操 作 し た い ホ ス ト す べ て に 、 gfservice-agent を イ ン ス ト ー ル し て お く 必 要 が あ り ま す 。

gfservice は ユ ー ザ が 新 し く サ ブ コ マ ン ド を 追 加 で き る よ う に 、 プ ラ グ イ ン シ ス テ ム を 採 用 し て い ま す 。 詳 し い 説 明 は "PLUG-IN SYSTEM" の 節 を 参 照 し て 下 さ い 。

OPTIONS

-d

デ バ ッ グ 情 報 を 出 力 し ま す 。 gfservice は 、 こ の オ プ シ ョ ン を gfservice-agent に 渡 し ま す の で 、 gfservice-agent か ら も デ バ ッ グ 情 報 が 出 力 さ れ ま す 。

-f フ ァ イ ル

デ フ ォ ル ト の 設 定 フ ァ イ ル の 代 わ り に 、 「 フ ァ イ ル 」 を 読 み 込 み ま す 。

-t 時 間

操 作 の タ イ ム ア ウ ト を 、 「 時 間 」 秒 と し ま す 。 gfservice が サ ー バ ー プ ロ グ ラ ム (gfmd、 gfsd、 バ ッ ク エ ン ド デ ー タ ベ ー ス ) の 実 行 開 始 な い し 終 了 を 試 み る 際 、 処 理 が 完 了 す る か 、 も し く は gfservice の 指 定 時 間 が 経 過 す る か ま で 待 ち ま す 。 「 時 間 」 と し て 「 no」 を 指 定 す る と 、 タ イ ム ア ウ ト は 起 き な く な り ま す 。 デ フ ォ ル ト 値 は 、 「 no」 で す 。

-k

こ の オ プ シ ョ ン が config-gfarm サ ブ コ マ ン ド も し く は config-gfarm-master サ ブ コ マ ン ド と 共 に 指 定 さ れ た 場 合 、 gfservice は gfkey コ マ ン ド を 用 い て 共 有 秘 密 鍵 フ ァ イ ル を 作 成 し ま す 。

SUB-COMMANDS FOR GFMD

以 下 に 挙 げ て い る の は 、 gfmd を 操 作 す る サ ブ コ マ ン ド で す 。 コ マ ン ド 行 に 与 え る ホ ス ト ID は 、 「 gfmd n 」 (gfmd1, gfmd2, ...) で な く て は な り ま せ ん 。 そ れ 以 外 の 場 合 、 gfservice は エ ラ ー を 通 知 し て た だ ち に 終 了 し ま す 。

backend-db-status ホ ス ト ID

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

gfmd-status ホ ス ト ID

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

start-backend-db ホ ス ト ID

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

start-gfmd ホ ス ト ID

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

start-gfmd-master ホ ス ト ID

サ ブ コ マ ン ド start-gfmd の 別 名 で す 。

start-gfmd-slave ホ ス ト ID

サ ブ コ マ ン ド start-gfmd と 同 じ で す が 、 gfmd に は -S オ プ シ ョ ン が 付 与 さ れ ま す 。

start-gfarm ホ ス ト ID

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

start-gfarm-master ホ ス ト ID

サ ブ コ マ ン ド start-gfarm の 別 名 で す 。

start-gfarm-slave ホ ス ト ID

サ ブ コ マ ン ド start-gfarm と 同 じ で す が 、 gfmd に は -S オ プ シ ョ ン が 付 与 さ れ ま す 。

stop-backend-db ホ ス ト ID

バ ッ ク エ ン ド デ ー タ ベ ー ス が 実 行 中 な ら 、 実 行 を 停 止 し ま す 。

stop-gfmd ホ ス ト ID

gfmd が 実 行 中 な ら 、 実 行 を 停 止 し ま す 。

stop-gfarm ホ ス ト ID

バ ッ ク エ ン ド デ ー タ ベ ー ス お よ び gfmd が 実 行 中 な ら 、 実 行 を 停 止 し ま す 。

kill-gfmd ホ ス ト ID

gfmd が 実 行 中 な ら 、 強 制 停 止 (SIGKILL を 送 付 ) し ま す 。

restart-backend-db ホ ス ト ID

サ ブ コ マ ン ド stop-backend-db と start-backend-db を 続 け て 実 行 し ま す 。

restart-gfmd ホ ス ト ID

サ ブ コ マ ン ド stop-gfmd 」 と 「 start-gfmd を 続 け て 実 行 し ま す 。

restart-gfmd-master ホ ス ト ID

サ ブ コ マ ン ド restart-gfmd の 別 名 で す 。

restart-gfmd-slave ホ ス ト ID

サ ブ コ マ ン ド stop-gfmd と start-gfmd-slave を 続 け て 実 行 し ま す 。

restart-gfarm ホ ス ト ID

サ ブ コ マ ン ド stop-gfarm と start-gfarm を 続 け て 実 行 し ま す 。

restart-gfarm-master ホ ス ト ID

サ ブ コ マ ン ド restart-gfarm の 別 名 で す 。

restart-gfarm-slave ホ ス ト ID

サ ブ コ マ ン ド stop-gfarm と start-gfarm-slave を 続 け て 実 行 し ま す 。

promote ホ ス ト ID

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

promote-gfmd ホ ス ト ID

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

set-gfmd-conf ホ ス ト ID 設 定 名 称 値

リ モ ー ト ホ ス ト 上 の gfmd.conf フ ァ イ ル に

設 定 名 称 値

と い う 行 を 加 え ま す 。 既 に gfmd.conf に 「 設 定 名 称 」 と い う 行 が 存 在 し て い る 場 合 、 gfservice は そ れ を 削 除 し て か ら 、 新 た に 行 を 追 加 し ま す 。

set-gfsd-conf ホ ス ト ID 設 定 名 称 値

リ モ ー ト ホ ス ト 上 の gfsd.conf フ ァ イ ル に

設 定 名 称 値

と い う 行 を 加 え ま す 。 既 に gfsd.conf に 「 設 定 名 称 」 と い う 行 が 存 在 し て い る 場 合 、 gfservice は そ れ を 削 除 し て か ら 、 新 た に 行 を 追 加 し ま す 。

unset-gfmd-conf ホ ス ト ID 設 定 名 称

リ モ ー ト ホ ス ト 上 の gfmd.conf フ ァ イ ル か ら 「 設 定 名 称 」 行 を 削 除 し ま す 。 gfmd.conf フ ァ イ ル に 「 設 定 名 称 」 行 が な い 場 合 、 フ ァ イ ル は 更 新 さ れ ま せ ん 。

unset-gfsd-conf ホ ス ト ID 設 定 名 称

リ モ ー ト ホ ス ト 上 の gfsd.conf フ ァ イ ル か ら 「 設 定 名 称 」 行 を 削 除 し ま す 。 gfsd.conf フ ァ イ ル に 「 設 定 名 称 」 行 が な い 場 合 、 フ ァ イ ル は 更 新 さ れ ま せ ん 。

backup-backend-db ホ ス ト ID

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

backup-gfmd-conf ホ ス ト ID

リ モ ー ト ホ ス ト 上 の gfarm2.conf フ ァ イ ル を 、 標 準 出 力 へ 出 力 し ま す 。

backup-gfsd-conf ホ ス ト ID

リ モ ー ト ホ ス ト 上 の gfsd.conf フ ァ イ ル を 、 標 準 出 力 へ 出 力 し ま す 。

backup-usermap ホ ス ト ID

リ モ ー ト ホ ス ト 上 の usermap フ ァ イ ル を 、 標 準 出 力 へ 出 力 し ま す 。

restore-backend-db ホ ス ト ID

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

restore-gfmd-conf ホ ス ト ID

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

restore-gfsd-conf ホ ス ト ID

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

restore-usermap ホ ス ト ID

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

config-gfarm ホ ス ト ID

リ モ ー ト ホ ス ト 上 で config-gfarm コ マ ン ド を 実 行 し ま す 。 こ の と き 、 設 定 フ ァ イ ル で 変 数 「 gfmd n _CONFIG_GFARM_OPTIONS」 が 宣 言 さ れ て い れ ば 、 そ の 値 が config-gfarm に オ プ シ ョ ン と し て 付 与 さ れ ま す 。 レ プ リ ケ ー シ ョ ン 機 能 を 有 効 に す る と き は 、 こ の サ ブ コ マ ン ド は 使 用 せ ず 、 代 わ り に config-gfarm-master な い し config-gfarm-slave を 使 っ て 下 さ い 。 -k オ プ シ ョ ン が 指 定 さ れ て い る 場 合 、 gfservice は gfkey コ マ ン ド を 用 い て gfmd ホ ス ト 上 に 共 有 秘 密 鍵 フ ァ イ ル を 作 成 し ま す 。

config-gfarm-master ホ ス ト ID

こ の サ ブ コ マ ン ド は config-gfarm と 基 本 的 に 同 じ で す が 、 gfmd の レ プ リ ケ ー シ ョ ン が 自 動 的 に 有 効 に な り ま す 。

config-gfarm-slave ホ ス ト ID マ ス タ ー ホ ス ト ID

サ ブ コ マ ン ド config-gfarm と 基 本 的 に 同 じ で す が 、 レ プ リ ケ ー シ ョ ン 機 能 が 自 動 的 に 有 効 に な り 、 「 マ ス タ ー ホ ス ト ID 」 上 で 動 作 す る gfmd の ス レ ー ブ と し て 動 作 し ま す 。 gfservice は gfmdhost コ マ ン ド を 用 い て こ の ス レ ー ブ ホ ス ト を サ ー バ ー リ ス ト に 加 え ま す 。 ま た 、 マ ス タ ー gfmd ホ ス ト 上 の gfarm2.conf フ ァ イ ル を 更 新 し て 、 metadb_server_list に こ の ス レ ー ブ ホ ス ト を 加 え 、 設 定 フ ァ イ ル で 定 義 さ れ て い る す べ て の ホ ス ト に 配 布 し ま す 。 変 数 「 gfmd n _PRIVATE_MODE」 の 値 が 「 true」 に セ ッ ト さ れ て い る 場 合 は 、 同 様 に gfsd.conf フ ァ イ ル を 更 新 し 、 す べ て の gfmd ホ ス ト と gfsd ホ ス ト に 配 布 し ま す 。 変 数 「 gfmd n _AUTH_TYPE」 の 値 が 「 sharedsecret」 の 場 合 、 共 有 秘 密 鍵 フ ァ イ ル を マ ス タ ー gfmd ホ ス ト か ら こ の ス レ ー ブ gfmd ホ ス ト へ コ ピ ー し ま す 。

unconfig-gfarm ホ ス ト ID

サ ブ コ マ ン ド stop-gfsd を 実 行 し て 、 そ の 後 gfmd や バ ッ ク エ ン ド デ ー タ ベ ー ス が 作 成 し た フ ァ イ ル や デ ィ レ ク ト リ を す べ て 削 除 し ま す 。 ス レ ー ブ gfmd を 廃 止 す る 場 合 は 、 代 わ り に サ ブ コ マ ン ド unconfig-gfarm-slave を 使 用 し て 下 さ い 。

unconfig-gfarm-master ホ ス ト ID

サ ブ コ マ ン ド unconfig-gfarm の 別 名 で す 。

unconfig-gfarm-slave ホ ス ト ID マ ス タ ー ホ ス ト ID

サ ブ コ マ ン ド unonfig-gfarm と 基 本 的 に 同 じ で す が 、 以 下 の 追 加 処 理 を 行 い ま す 。 gfmdhost コ マ ン ド を 用 い て サ ー バ ー リ ス ト か ら 、 そ の ス レ ー ブ ホ ス ト を 削 除 し ま す 。 ま た 、 設 定 フ ァ イ ル で 定 義 さ れ て い る す べ て の ホ ス ト の gfarm2.conf を 更 新 し 、 metadb_server_list に 設 定 さ れ た サ ー バ ー リ ス ト か ら 、 そ の ス レ ー ブ ホ ス ト を 削 除 し ま す 。 変 数 「 gfmd n _PRIVATE_MODE」 の 値 が 「 true」 に セ ッ ト さ れ て い る 場 合 は 、 同 様 に gfsd.conf フ ァ イ ル を 更 新 し 、 す べ て の gfmd ホ ス ト と gfsd ホ ス ト に 配 布 し ま す 。

SUB-COMMANDS FOR GFSD

以 下 に 挙 げ て い る の は 、 gfsd を 操 作 す る サ ブ コ マ ン ド で す 。 コ マ ン ド 行 に 与 え る ホ ス ト ID は 、 「 gfsd n 」 (gfsd1, gfsd2, ...) で な く て は な り ま せ ん 。 そ れ 以 外 の 場 合 、 gfservice は エ ラ ー を 通 知 し て た だ ち に 終 了 し ま す 。

gfsd-status ホ ス ト ID

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

start-gfsd ホ ス ト ID

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

stop-gfsd ホ ス ト ID

gfsd が 実 行 中 な ら 、 実 行 を 停 止 し ま す 。

restart-gfsd ホ ス ト ID

サ ブ コ マ ン ド stop-gfsd と start-gfsd を 続 け て 実 行 し ま す 。

set-gfsd-conf ホ ス ト ID 設 定 名 称 値

gfmd 用 の set-gfsd-conf サ ブ コ マ ン ド と 同 じ で す 。

unset-gfsd-conf ホ ス ト ID 設 定 名 称

gfmd 用 の unset-gfsd-conf サ ブ コ マ ン ド と 同 じ で す 。

backup-gfsd-conf ホ ス ト ID

gfmd 用 の backup-gfsd-conf サ ブ コ マ ン ド と 同 じ で す 。

backup-usermap ホ ス ト ID

gfmd 用 の backup-usermap サ ブ コ マ ン ド と 同 じ で す 。

restore-gfsd-conf ホ ス ト ID

gfmd 用 の restore-gfsd-conf サ ブ コ マ ン ド と 同 じ で す 。

restore-usermap ホ ス ト ID

gfmd 用 の restore-usermap サ ブ コ マ ン ド と 同 じ で す 。

config-gfsd ホ ス ト ID

リ モ ー ト ホ ス ト 上 で config-gfsd コ マ ン ド を 実 行 し ま す 。 こ の と き 、 設 定 フ ァ イ ル で 変 数 「 gfsd n _CONFIG_GFARM_OPTIONS」 が 宣 言 さ れ て い れ ば 、 そ の 値 が config-gfsd に オ プ シ ョ ン と し て 付 与 さ れ ま す 。 ま た 、 gfservice は gfhost コ マ ン ド を 用 い て 、 リ モ ー ト ホ ス ト を フ ァ イ ル シ ス テ ム ノ ー ド と し て 登 録 し ま す 。 変 数 「 gfsd n _AUTH_TYPE」 の 値 が 「 sharedsecret」 の 場 合 、 共 有 秘 密 鍵 フ ァ イ ル を gfmd1 か ら gfsd ホ ス ト へ コ ピ ー し ま す 。

unconfig-gfsd ホ ス ト ID

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

SUB-COMMANDS FOR CLIENT

以 下 に 挙 げ て い る の は 、 ク ラ イ ア ン ト を 操 作 す る サ ブ コ マ ン ド で す 。 コ マ ン ド 行 に 与 え る ホ ス ト ID は 、 「 gfmd n 」 (gfmd1, gfmd2, ...)、 「 gfsd n 」 (gfsd1, gfsd2, ...)、 「 client n 」 (client1, client2, ...) の い ず れ か で な く て は な り ま せ ん 。 そ れ 以 外 の 場 合 、 gfservice は エ ラ ー を 通 知 し て た だ ち に 終 了 し ま す 。

mount ホ ス ト ID デ ィ レ ク ト リ オ プ シ ョ ン ...

リ モ ー ト ホ ス ト 上 の 「 デ ィ レ ク ト リ 」 に 、 Gfarm2 フ ァ イ ル シ ス テ ム を マ ウ ン ト し ま す 。 引 数 「 オ プ シ ョ ン 」 は gfarm2fs コ マ ン ド へ の 引 数 と み な さ れ ま す 。

unmount ホ ス ト ID デ ィ レ ク ト リ

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

umount ホ ス ト ID デ ィ レ ク ト リ

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

set-gfarm-conf ホ ス ト ID 設 定 名 称 値

リ モ ー ト ホ ス ト 上 の gfarm2.conf フ ァ イ ル に

設 定 名 称 値

と い う 行 を 加 え ま す 。 既 に gfarm2.conf に 「 設 定 名 称 」 と い う 行 が 存 在 し て い る 場 合 、 gfservice は そ れ を 削 除 し て か ら 、 新 た に 行 を 追 加 し ま す 。

unset-gfarm-conf ホ ス ト ID 設 定 名 称

リ モ ー ト ホ ス ト 上 の gfarm2.conf フ ァ イ ル か ら 「 設 定 名 称 」 行 を 削 除 し ま す 。 gfarm2.conf フ ァ イ ル に 「 設 定 名 称 」 行 が な い 場 合 、 フ ァ イ ル は 更 新 さ れ ま せ ん 。

backup-gfarm-conf ホ ス ト ID

リ モ ー ト ホ ス ト 上 の gfarm2.conf フ ァ イ ル を 、 標 準 出 力 へ 出 力 し ま す 。

backup-shared-key ホ ス ト ID

リ モ ー ト ホ ス ト 上 の 共 有 秘 密 鍵 フ ァ イ ル を 、 標 準 出 力 へ 出 力 し ま す 。

restore-gfarm-conf ホ ス ト ID

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

restore-shared-key ホ ス ト ID

リ モ ー ト ホ ス ト 上 の 共 有 秘 密 鍵 フ ァ イ ル を 復 旧 し ま す 。 gfservice は 、 共 有 秘 密 鍵 の バ ッ ク ア ッ プ デ ー タ を 標 準 入 力 か ら 読 み 込 み ま す 。

config-client ホ ス ト ID

変 数 「 client n _AUTH_TYPE」 の 値 が 「 sharedsecret」 の 場 合 、 共 有 秘 密 鍵 フ ァ イ ル を gfmd1 か ら ク ラ イ ア ン ト ホ ス ト へ コ ピ ー し ま す 。

unconfig-client ホ ス ト ID

リ モ ー ト ホ ス ト 上 の gfarm2.conf フ ァ イ ル お よ び 共 有 秘 密 鍵 フ ァ イ ル を 削 除 し ま す 。

gfcmd ホ ス ト ID コ マ ン ド 名 コ マ ン ド 引 数 ...

リ モ ー ト ホ ス ト 上 で Gfarm コ マ ン ド を 実 行 し ま す 。

gfcmd-root ホ ス ト ID コ マ ン ド 名 コ マ ン ド 引 数 ...

リ モ ー ト ホ ス ト 上 に て 、 root 権 限 で Gfarm コ マ ン ド を 実 行 し ま す 。

grid-proxy-init host-id コ マ ン ド 引 数 ...

リ モ ー ト ホ ス ト 上 で grid-proxy-init コ マ ン ド を 実 行 し ま す 。

SUB-COMMANDS FOR MULTIPLE HOSTS

以 下 に 挙 げ て い る の は 、 複 数 の ホ ス ト を 操 作 す る サ ブ コ マ ン ド で す 。 コ マ ン ド 行 で 、 ホ ス ト ID を 指 定 す る こ と は で き ま せ ん 。

start-all

す べ て の バ ッ ク エ ン ド デ ー タ ベ ー ス 、 gfmd、 gfsd を 起 動 し ま す 。

stop-all

す べ て の gfsd、 gfmd、 バ ッ ク エ ン ド デ ー タ ベ ー ス を 停 止 し ま す 。

kill-gfmd-all

す べ て の gfmd を 強 制 停 止 (SIGKILL を 送 付 ) し ま す 。

restart-all

サ ブ コ マ ン ド stop-all と start-all を 続 け て 実 行 し ま す 。

config-all

gfmd1 に 対 し て " config-gfarm-master " を 実 行 し 、 そ れ 以 外 の す べ て の gfmd に 対 し て " config-gfarm-slave " を 実 行 し ま す 。 次 に す べ て の gfsd に 対 し て " config-gfsd " を 実 行 し ま す 。 最 後 に す べ て の ク ラ イ ア ン ト に 対 し て 、 " config-client " を 実 行 し ま す 。

unconfig-all

す べ て の ク ラ イ ア ン ト に 対 し て 、 " unconfig-client " を 実 行 し ま す 。 次 に す べ て の gfsd に 対 し て " unconfig-gfsd " を 実 行 し ま す 。 最 後 に す べ て の gfmd に 対 し て " unconfig-gfarm " を 実 行 し ま す 。

PLUG-IN SYSTEM

gfservice は ユ ー ザ が 新 し く サ ブ コ マ ン ド が 追 加 で き る よ う に 、 プ ラ グ イ ン シ ス テ ム を 採 用 し て い ま す 。 指 定 さ れ た サ ブ コ マ ン ド を gfservice が 提 供 し て い な い 場 合 、 gfservice コ マ ン ド は %%DATADIR%%/gfarm/gfservice 以 下 の サ ブ コ マ ン ド 名 の フ ァ イ ル を 参 照 し ま す 。

サ ブ コ マ ン ド の フ ァ イ ル は Bourneシ ェ ル ス ク リ プ ト で 書 き ま す 。 サ ブ コ マ ン ド " name " の サ ブ コ マ ン ド フ ァ イ ル は 、 gfservice か ら 実 行 さ れ る " subcmd_ name "と い う 名 前 の シ ェ ル 関 数 、 gfservice-agent か ら 実 行 さ れ る " subcmd_ name _agent " と い う 名 前 の シ ェ ル 関 数 が 実 装 さ れ て い る 必 要 が あ り ま す 。

サ ブ コ マ ン ド が ユ ー ザ が 追 加 し た 別 の サ ブ コ マ ン ド に 依 存 し て い る 時 の た め に 、 サ ブ コ マ ン ド " name " の サ ブ コ マ ン ド フ ァ イ ル は 、 " name _depends " と い う 名 前 の シ ェ ル 関 数 で 、 そ の サ ブ コ マ ン ド が 依 存 し て い る 他 の サ ブ コ マ ン ド の リ ス ト を 返 す 必 要 が あ り ま す ． サ ブ コ マ ン ド の リ ス ト は ス ペ ー ス で 区 切 ら れ た サ ブ コ マ ン ド の 文 字 列 で す ． 依 存 し て い る 他 の サ ブ コ マ ン ド が な い 場 合 は 空 文 字 列 を 返 し て 下 さ い 。 同 様 に 、 サ ブ コ マ ン ド フ ァ イ ル は " name _agent_depends " と い う 名 前 の シ ェ ル 関 数 で 、 そ の サ ブ コ マ ン ド の エ ー ジ ェ ン ト が 依 存 し て い る 他 の サ ブ コ マ ン ド の リ ス ト を 返 す 必 要 が あ り ま す 。

---