Man page - config-gfarm-update(8)

Packages contains this manual

Package:  gfmd
apt-get install gfmd

Manuals in package:
• gfjournaladmin(1)
• gfmd(8)
• gfarm2.conf(5)
• config-gfarm(8)
• gfdump.postgresql(8)
• config-gfarm-update(8)
• gfjournal(1)
Documentations in package:
• gfmd

Available languages:

en ja

Manual

CONFIG-GFARM-UPDAT

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
SEE ALSO

---

NAME

config-gfarm-update - Gfarmメ タ デ ー タ の 更 新

SYNOPSIS

	config-gfarm-update [ オ プ シ ョ ン ]
	config-gfarm-update --update [ オ プ シ ョ ン ]

DESCRIPTION

config-gfarm-update は 、 メ タ デ ー タ サ ー バ に お け る バ ッ ク エ ン ド DBを ア ッ プ グ レ ー ド /ア ッ プ デ ー ト す る コ マ ン ド で す 。 メ タ デ ー タ サ ー バ が プ ラ イ ベ ー ト モ ー ド で 設 定 さ れ て い る 場 合 を 除 き 、 こ の コ マ ン ド を 実 行 す る た め に は root権 限 が 必 要 で す 。 バ ッ ク エ ン ド DBに 接 続 す る た め の 情 報 を 得 る た め 、 起 動 時 に gfmd の 設 定 フ ァ イ ル (gfmd.conf)を 読 み 込 み ま す 。

config-gfarm-update は 、 以 下 に 示 す バ ッ ク エ ン ド DBの 機 能 を 有 効 に す る こ と が で き ま す 。

• XML Path言 語 (XPath)の サ ポ ー ト [-X]

• メ タ デ ー タ サ ー バ 内 で メ タ デ ー タ の 複 製 [-r]

• チ ェ ッ ク サ ム 計 算 [-d]

バ ッ ク エ ン ド DBが こ れ ら の 機 能 を サ ポ ー ト す る か ど う か は 、 config-gfarm に よ っ て 初 期 設 定 が 行 わ れ た と き に 決 定 さ れ ま す 。 初 期 設 定 後 に 機 能 を 有 効 に し た い 場 合 は 、 config-gfarm-update --update に 上 記 の 一 覧 中 の [ ] で 囲 ま れ た オ プ シ ョ ン を つ け て 実 行 し て く だ さ い 。

config-gfarm-update は 、 バ ッ ク エ ン ド DBの ア ッ プ グ レ ー ド に も 使 用 さ れ ま す 。 こ の コ マ ン ド を 実 行 す る こ と に よ り 、 デ ー タ ベ ー ス 内 の テ ー ブ ル ス キ ー マ や デ ー タ が 編 集 さ れ ま す 。 Gfarmは 古 い リ リ ー ス に 対 し て 互 換 性 が な い 可 能 性 が あ る た め 、 ア ッ プ グ レ ー ド の 必 要 が あ る 場 合 は 、 --update オ プ シ ョ ン を 付 け て config-gfarm-update を 実 行 し て く だ さ い 。

メ タ デ ー タ サ ー バ を ア ッ プ デ ー ト や ア ッ プ グ レ ー ド す る 際 、 gfmd を 停 止 し て か ら 実 行 し な け れ ば い け ま せ ん 。 ま た 、 フ ァ イ ル シ ス テ ム 内 に メ タ ー デ ー タ サ ー バ が 複 数 存 在 す る 場 合 は 、 全 て の メ タ デ ー タ サ ー バ 上 で config-gfarm-update を 実 行 し て く だ さ い 。 メ タ デ ー タ サ ー バ の ア ッ プ デ ー ト や ア ッ プ グ レ ー ド 後 、 ホ ス ト 上 の メ タ デ ー タ サ ー バ は 、 こ の コ マ ン ド に よ り 起 動 さ れ ま す 。

config-gfarm と 同 様 に 、 config-gfarm-update に は 、 全 て の 設 定 パ ラ メ ー タ の 値 を 表 示 す る -t オ プ シ ョ ン が 存 在 し ま す 。 こ の コ マ ン ド の 実 行 例 は 以 下 の 通 り で す 。

$ config-gfarm-update -t
prefix [--prefix]:
metadata backend [-b]: postgresql
metadata directory [-l]: /var/gfarm-pgsql
postgresql admin user [-U]: postgres
postgresql admin password [-W]: (auto generated)
postgresql user [-u]: gfarm
postgresql password [-w]: (auto generated)
postgresql prefix [-P]: /usr
postgresql version [-V]: 8.4
postgresql XML supported [-X]: no
postgresql data checksum support
[-E]: no
portmaster port [-p]: 10602
metadata replication [-r]: yes
metadata journal directory [-j]: /var/gfarm-metadata/journal
digest type [-d]: md5

ア ッ プ デ ー ト や ア ッ プ グ レ ー ド を 行 う 前 に 、 config-gfarm-update -t を 実 行 す る こ と を 推 奨 し ま す 。

バ ッ ク エ ン ド DBが PostgreSQLで あ る 場 合 、 か つ config-gfarm-update が --update オ プ シ ョ ン 無 し で 処 理 さ れ た 場 合 は 、 psql コ マ ン ド が 実 行 さ れ ま す 。 こ の コ マ ン ド は 、 バ ッ ク エ ン ド DBへ の フ ロ ン ト エ ン ド タ ー ミ ナ ル で あ り 、 対 話 的 に ク エ リ を 入 力 す る こ と が で き ま す 。 psql は PostgreSQLへ 自 動 的 に 接 続 を 行 う の で 便 利 で す 。

OPTIONS

--prefix パ ス

config-gfarm-update は 、 gfmd の 設 定 フ ァ イ ル PREFIX/etc/gfmd.confを 読 み 込 み ま す 。 デ フ ォ ル ト で は 、 %%SYSCONFDIR%%/etc/gfmd.conf が 読 み 込 ま れ ま す 。

-P イ ン ス ト ー ル 先 の デ ィ レ ク ト リ

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 バ ッ ク エ ン ド DBに 対 す る イ ン ス ト ー ル 先 の デ ィ レ ク ト リ (例 え ば 、 /usr/local)を 指 定 す る こ と が で き ま す 。 config-gfarm-update が psql な ど の PostgreSQLコ マ ン ド を 実 行 す る 際 、 指 定 し た デ ィ レ ク ト リ の 下 に こ の コ マ ン ド が イ ン ス ト ー ル さ れ て い る こ と を 前 提 と し て い ま す 。 こ の オ プ シ ョ ン を 省 略 し た 場 合 、 config-gfarm-update は 、 環 境 変 数 PATH の リ ス ト か ら そ の コ マ ン ド へ の デ ィ レ ク ト リ を 探 し 出 し ま す 。

-l パ ス

バ ッ ク エ ン ド DBが Gfarmの メ タ デ ー タ を 記 録 し た フ ァ イ ル を 置 く デ ィ レ ク ト リ へ の パ ス を 指 定 す る こ と が で き ま す 。

バ ッ ク エ ン ド DBが PostgreSQLで あ る 場 合 、 指 定 し た デ ィ レ ク ト リ は 一 般 に PGDATAと 呼 ば れ て い ま す 。 デ フ ォ ル ト で は PREFIX/var/gfarm-pgsql が 設 定 さ れ て お り 、 こ の PREFIXは --prefix オ プ シ ョ ン で 与 え ら れ た 値 と な り ま す 。

-f コ マ ン ド フ ァ イ ル

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 config-gfarm-update が PostgreSQLへ の フ ロ ン ト エ ン ド タ ー ミ ナ ル と し て psql を 実 行 す る 際 、 config-gfarm-update は -f オ プ シ ョ ン と 与 え ら れ た フ ァ イ ル 引 数 を psql に 渡 し ま す 。 そ し て 、 psql は 、 対 話 的 に コ マ ン ド を 読 み 込 む の で は な く 、 こ の フ ァ イ ル 内 に 書 き 込 ま れ た コ マ ン ド を 解 釈 し ま す 。 た だ し 、 --update オ プ シ ョ ン が 指 定 さ れ て い る 場 合 、 こ の オ プ シ ョ ン は 無 視 さ れ ま す 。

-o オ プ シ ョ ン

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 config-gfarm-update が PostgreSQLへ の フ ロ ン ト エ ン ド タ ー ミ ナ ル と し て psql を 実 行 す る 際 、 config-gfarm-update は 与 え ら れ た オ プ シ ョ ン を psql に 渡 し ま す 。 た だ し 、 --update オ プ シ ョ ン が 指 定 さ れ て い る 場 合 、 こ の オ プ シ ョ ン は 無 視 さ れ ま す 。

-j ジ ャ ー ナ ル フ ァ イ ル 用 デ ィ レ ク ト リ

gfmd に よ り ジ ャ ー ナ ル フ ァ イ ル が 置 か れ る デ ィ レ ク ト リ の パ ス を 指 定 す る こ と が で き ま す 。 デ フ ォ ル ト で は 、 PREFIX/var/gfarm-metadata/journal が 設 定 さ れ て お り 、 こ の PREFIXは --prefix オ プ シ ョ ン で 与 え ら れ た 値 と な り ま す 。

--help

こ の コ マ ン ド の 使 用 法 を 表 示 し て 、 終 了 し ま す 。

-t

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 人 間 が 読 み や す い 形 式 で 全 て の 設 定 パ ラ メ ー タ の 値 を 表 示 し た 後 、 す ぐ に 終 了 し ま す 。

-N

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 ア ッ プ デ ー ト や ア ッ プ グ レ ー ド を 実 行 し た 後 、 gfmd を 起 動 /停 止 し ま せ ん 。 こ の オ プ シ ョ ン は --update オ プ シ ョ ン 指 定 時 の み 有 効 と な り ま す 。

-r

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 メ タ デ ー タ サ ー バ 内 で メ タ デ ー タ の 複 製 を 有 効 に し ま す 。 こ の オ プ シ ョ ン は --update オ プ シ ョ ン 指 定 時 の み 有 効 と な り ま す 。

-d ダ イ ジ ェ ス ト タ イ プ

チ ェ ッ ク サ ム 計 算 を 有 効 に し 、 チ ェ ッ ク サ ム の ダ イ ジ ェ ス ト タ イ プ を 指 定 し ま す 。 引 数 ダ イ ジ ェ ス ト タ イ プ に は 、 そ の ホ ス ト 上 に イ ン ス ト ー ル さ れ た OpenSSL ラ イ ブ ラ リ が 対 応 し て い る タ イ プ 名 を 小 文 字 (た と え ば "md5") で 指 定 し ま す 。

-X

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 拡 張 フ ァ イ ル 属 性 を ク エ リ す る た め の XML Path言 語 (XPath) の サ ポ ー ト を 有 効 に し ま す 。 こ の オ プ シ ョ ン は --update オ プ シ ョ ン 指 定 時 の み 有 効 と な り ま す 。

FILES

%%SYSCONFDIR%%/gfmd.conf

gfmd が 参 照 す る 設 定 フ ァ イ ル

SEE ALSO

config-gfarm (8), gfmd (8), psql (1)

---