Man page - config-gfarm(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

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
SEE ALSO

---

NAME

config-gfarm - Gfarmの メ タ デ ー タ サ ー バ の セ ッ ト ア ッ プ

SYNOPSIS

config-gfarm [ オ プ シ ョ ン ]

DESCRIPTION

config-gfarm は 、 Gfarm フ ァ イ ル シ ス テ ム の メ タ サ ー バ を セ ッ ト ア ッ プ す る た め の ユ ー テ ィ リ テ ィ で す 。 メ タ デ ー タ サ ー バ の サ ー バ プ ロ グ ラ ム は 'gfmd'と 呼 ば れ て い ま す 。 Gfarmの 開 発 、 評 価 、 ま た は テ ス ト と い っ た 私 的 な 用 途 で フ ァ イ ル シ ス テ ム を 使 用 す る 場 合 を 除 き 、 config-gfarm を 実 行 す る た め に は 、 ル ー ト 権 限 が 必 要 で す 。

config-gfarm は 下 記 に 示 し た 順 に 処 理 を 実 行 し ま す 。

1. バ ッ ク エ ン ド DBを セ ッ ト ア ッ プ し ま す 。

2. Gfarmの 設 定 フ ァ イ ル %%SYSCONFDIR%%/gfarm2.confや %%SYSCONFDIR%%/gfsd.confを 生 成 し ま す 。

3. バ ッ ク エ ン ド DBや 、 gfmd と 呼 ば れ る Gfarmメ タ デ ー タ サ ー バ を 起 動 /停 止 す る た め の ス ク リ プ ト (ま た は 、 設 定 フ ァ イ ル )を 作 成 し ま す 。

大 抵 の OSに お い て 、 config-gfarm は 、 起 動 /停 止 ス ク リ プ ト gfmd と gfarm-pgsql を /etc/init.dま た は /etc/rc.d/init.dに 置 き ま す 。 (ど ち ら に 置 く の か は 、 OSに 依 存 し ま す 。 )

Red Hat Enterprise Linux 7 ま た は そ れ 以 降 の systemdで 動 作 す る Linuxに お い て 、 config-gfarm は 、 ユ ニ ッ ト 設 定 フ ァ イ ル で あ る gfmd.serviceや gfarm-pgsql.serviceを /etc/systemd/systemデ ィ レ ク ト リ に 置 き ま す 。 そ の 後 、 systemctl enable gfmd.service 、 systemctl enable gfarm-pgsql.service を 順 に 実 行 し ま す 。

4. バ ッ ク エ ン ド DBや 、 gfmd を 起 動 し ま す 。

5. unconfig-gfarm.sh と い う ス ク リ プ ト を %%SYSCONFDIR%% 上 に 作 成 し ま す 。 こ の ス ク リ プ ト は 、 メ タ デ ー タ サ ー バ の セ ッ ト ア ッ プ の 取 り 消 し を 行 い ま す 。 gfmd と バ ッ ク エ ン ド DBを 停 止 し 、 config-gfarm に よ っ て 作 成 さ れ た フ ァ イ ル ( unconfig-gfarm.sh ス ク リ プ ト 自 身 を 含 む ) を す べ て 消 去 し ま す 。

config-gfarm を 使 用 し て メ タ デ ー タ サ ー バ を セ ッ ト ア ッ プ す る 前 に 、 config-gfarm -t を 実 行 す る こ と を 推 奨 し ま す 。 -t オ プ シ ョ ン を 付 け て 実 行 す る こ と に よ り 、 セ ッ ト ア ッ プ す る 代 わ り に 全 て の 設 定 パ ラ メ ー タ を 表 示 し ま す 。

$ config-gfarm -t
prefix [--prefix]:
metadata backend [-b]: postgresql
(available backend: postgresql )
metadata directory [-l]: /var/gfarm-pgsql
metadata log directory [-L]: /var/gfarm-pgsql/pg_xlog
postgresql admin user [-U]: miles
postgresql admin password [-W]: (auto generated)
postgresql user [-u]: gfarm
postgresql password [-w]: (auto generated)
postgresql prefix [-P]: /usr
postgresql version [-V]: 9.2
postgresql XML supported [-X]: no
metadata replication [-r]: no
metaserver hostname [-h]: host1.example.org
matadata admin user [-A]: miles
matadata admin dn [-D]:
portmaster port [-p]: 10602
gfmd port [-m]: 601
auth type [-a]: sharedsecret
rc script for gfmd : /etc/init.d/gfmd
rc script for backend : /etc/init.d/gfarm-pgsql
gfmd conf file : /etc/gfmd.conf
gfarm client conf file : /etc/gfarm2.conf
gfmd pid file : /var/run/gfmd.pid
backend pid file : /var/run/postmaster.pid

[ ]で 囲 ま れ た オ プ シ ョ ン 名 は 、 オ プ シ ョ ン と し て 指 定 で き る こ と を 意 味 し て い ま す 。

OPTIONS

--prefix パ ス

こ の オ プ シ ョ ン を 与 え た 場 合 、 以 下 に 挙 げ た gfmd と バ ッ ク エ ン ド DBに 関 連 す る 複 数 の パ ス が 設 定 さ れ ま す 。 具 体 的 に は 、 以 下 の 通 り で す 。

• Gfarmの メ タ デ ー タ を 置 く た め の デ ィ レ ク ト リ 。 バ ッ ク エ ン ド DBが PostgreSQLで あ る 場 合 は 、 PREFIX/var/gfarm-pgsqlと な り ま す 。 ま た 、 こ の パ ス は -L オ プ シ ョ ン に よ っ て 変 更 可 能 で す 。 --prefix と -l オ プ シ ョ ン を 同 時 に 指 定 し た 場 合 、 -l オ プ シ ョ ン が 優 先 さ れ ま す 。

• Gfarmの メ タ デ ー タ に 対 す る ロ グ フ ァ イ ル を 置 く た め の デ ィ レ ク ト リ 。 バ ッ ク エ ン ド DBが PostgreSQLで あ る 場 合 は 、 PREFIX/var/gfarm-pgsql/pg_xlogと な り ま す 。 ま た 、 こ の パ ス は -L オ プ シ ョ ン に よ っ て 変 更 可 能 で す 。 --prefix と -L オ プ シ ョ ン を 同 時 に 指 定 し た 場 合 、 -L オ プ シ ョ ン が 優 先 さ れ ま す 。

• gfmd の ジ ャ ー ナ ル フ ァ イ ル を 置 く た め の デ ィ レ ク ト リ 。 こ れ は 、 PREFIX/var/gfarm-metadata/journalと な り ま す 。 ま た 、 こ の パ ス は -j オ プ シ ョ ン に よ っ て 変 更 可 能 で す 。 --prefix と -j オ プ シ ョ ン を 同 時 に 指 定 し た 場 合 、 -j オ プ シ ョ ン が 優 先 さ れ ま す 。

• gfmd と バ ッ ク エ ン ド DBの PIDフ ァ イ ル を 置 く た め の デ ィ レ ク ト リ 。 こ れ は 、 PREFIX/var/runと な り ま す 。

• 設 定 フ ァ イ ル を 置 く た め の デ ィ レ ク ト リ 。 こ れ は 、 PREFIX/etcと な り ま す 。

• gfmd と バ ッ ク エ ン ド DBの 起 動 /停 止 ス ク リ プ ト を 置 く た め の デ ィ レ ク ト リ 。 こ れ は 、 PREFIX/etc/init.d、 ま た は PREFIX/rc.d/init.d/etcと な り ま す 。 (ど ち ら に 置 く の か は 、 OSに 依 存 し ま す 。 )

• ホ ス ト 上 で systemdが 起 動 し て い る 場 合 に 、 特 殊 な 例 外 が 存 在 し ま す 。 そ の ホ ス ト 上 で --prefix オ プ シ ョ ン と し て 空 文 字 列 以 外 を 指 定 す る と 、 config-gfarm は systemdに ユ ニ ッ ト 設 定 フ ァ イ ル を 置 き ま せ ん 。 そ の 代 わ り に 、 PREFIX/etc/init.dに 旧 形 式 の 起 動 /停 止 ス ク リ プ ト を 置 き ま す 。

• セ ッ ト ア ッ プ の 取 り 消 し を 行 う ス ク リ プ ト unconfig-gfarm.sh 。 こ れ は 、 PREFIX/etc/unconfig-gfarm.sh と な り ま す 。

デ フ ォ ル ト で は ""(空 文 字 列 )で す 。

-b バ ッ ク エ ン ド DB

バ ッ ク エ ン ド DBを 指 定 す る こ と が で き ま す 。 現 在 、 "postgresql" (PostgreSQL) だ け が サ ポ ー ト さ れ て い ま す 。 "ldap" (LDAP) は 以 前 に サ ポ ー ト さ れ て い ま し た が 、 サ ポ ー ト は 継 続 さ れ て い ま せ ん 。 config-gfarm -t は 、 利 用 可 能 な バ ッ ク エ ン ド DBを リ ス ト 表 示 し ま す 。

"postgresql" が リ ス ト に 存 在 す る 場 合 、 PostgreSQLが デ フ ォ ル ト と し て 選 択 さ れ ま す 。 利 用 可 能 な バ ッ ク エ ン ド DBが ldapの み で あ る 場 合 、 LDAPが デ フ ォ ル ト と し て 選 択 さ れ て し ま い ま す 。 リ ス ト に な い バ ッ ク エ ン ド DBを Gfarmに サ ポ ー ト さ せ た い 場 合 、 Gfarmを 再 度 コ ン パ イ ル す る 必 要 が あ る た め 、 注 意 し て く だ さ い 。

-d ダ イ ジ ェ ス ト タ イ プ

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

-U Gfarmの 管 理 ユ ー ザ 名

Gfarmフ ァ イ ル シ ス テ ム の 管 理 ユ ー ザ 名 を 指 定 す る こ と が で き ま す 。 デ フ ォ ル ト 値 は OSに よ っ て 異 な る た め 、 config-gfarm -t を 実 行 し 、 ユ ー ザ 名 を 確 認 し て く だ さ い 。

-u ユ ー ザ 名

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 セ ッ ト ア ッ プ し た gfmd は 、 指 定 し た ユ ー ザ 名 で バ ッ ク エ ン ド DBに 接 続 し ま す 。 デ フ ォ ル ト は 、 "gfarm"で す 。

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

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

-V バ ー ジ ョ ン

config-gfarm に 対 す る バ ッ ク エ ン ド DBの バ ー ジ ョ ン を 表 示 す る こ と が で き ま す 。 多 く の 場 合 、 config-gfarm は 、 正 し い バ ー ジ ョ ン 番 号 を 検 出 す る こ と が で き ま す 。 そ の た め 、 config-gfarm が バ ー ジ ョ ン 番 号 の 検 出 に 失 敗 し た 場 合 に の み 、 こ の オ プ シ ョ ン を 使 用 す る こ と を お 勧 め し ま す 。

-l メ タ デ ー タ 用 デ ィ レ ク ト リ

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

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

-L ロ グ フ ァ イ ル 用 デ ィ レ ク ト リ

バ ッ ク エ ン ド DBが ロ グ フ ァ イ ル を 置 く デ ィ レ ク ト リ へ の パ ス を 指 定 す る こ と が で き ま す 。 バ ッ ク エ ン ド DBが PostgreSQLで あ る 場 合 、 デ フ ォ ル ト で は PREFIX/var/gfarm-pgsql/pg_xlog が 設 定 さ れ て お り 、 こ の PREFIXは --prefix オ プ シ ョ ン で 与 え ら れ た 値 と な り ま す 。

-h ホ ス ト 名

メ タ デ ー タ サ ー バ を 認 識 す る た め に 使 用 さ れ る ホ ス ト 名 を 指 定 す る こ と が で き ま す 。 デ フ ォ ル ト で は 、 DNS上 に お け る そ の ホ ス ト の 完 全 修 飾 ド メ イ ン 名 (FQDN)と な り ま す 。

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

gfmd が ジ ャ ー ナ ル フ ァ イ ル を 置 く デ ィ レ ク ト リ の パ ス を 指 定 す る こ と が で き ま す 。 こ の オ プ シ ョ ン は 、 -r オ プ シ ョ ン に よ り メ タ デ ー タ の 複 製 が 有 効 と な っ て い る 場 合 に の み 影 響 を 及 ぼ し ま す 。 デ フ ォ ル ト で は 、 PREFIX/var/gfarm-metadata/journal が 設 定 さ れ て お り 、 こ の PREFIXは --prefix オ プ シ ョ ン で 与 え ら れ た 値 と な り ま す 。

-A ユ ー ザ 名

Gfarmフ ァ イ ル シ ス テ ム の 管 理 者 を 指 定 す る こ と が で き ま す 。 こ の オ プ シ ョ ン を 省 略 し た 場 合 、 config-gfarm は who am i コ マ ン ド を 実 行 す る こ と に よ り ユ ー ザ 名 を 取 得 し ま す 。

-D サ ブ ジ ェ ク ト DN

グ ロ ー バ ル ユ ー ザ と し て の 管 理 者 の サ ブ ジ ェ ク ト DNを 指 定 す る こ と が で き ま す 。 GSI認 証 を 行 う 場 合 、 こ の オ プ シ ョ ン は 必 須 で す 。

-p バ ッ ク エ ン ド DB用 ポ ー ト 番 号

設 定 し た バ ッ ク エ ン ド DBが 待 ち 受 け る TCPポ ー ト 番 号 を 指 定 す る こ と が で き ま す 。 デ フ ォ ル ト で は 10602が 指 定 さ れ ま す 。

-m gfmd用 ポ ー ト 番 号

設 定 し た gfmd が 待 ち 受 け る TCPポ ー ト 番 号 を 指 定 す る こ と が で き ま す 。 デ フ ォ ル ト で は プ ラ イ ベ ー ト モ ー ド の 場 合 に 10601、 そ れ 以 外 で は 601が 指 定 さ れ ま す 。

-a 認 証 方 法

認 証 方 法 を 指 定 す る こ と が で き ま す 。 現 在 は 、 "sharedsecret" ま た は "gsi" を 使 用 す る こ と が で き 、 デ フ ォ ル ト は "sharedsecret"と な っ て い ま す 。

--help

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 config-gfarmの 使 用 法 を 表 示 し た 後 、 終 了 し ま す 。

-S

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 プ ラ イ ベ ー ト モ ー ド を 有 効 に し ま す 。 config-gfarm は 、 ル ー ト 権 限 な し で 実 行 可 能 な Gfarmフ ァ イ ル シ ス テ ム を セ ッ ト ア ッ プ し ま す 。 具 体 的 に は 、 以 下 の 通 り に 設 定 手 順 を 変 更 し ま す 。

• gfmd の デ フ ォ ル ト 待 ち 受 け ポ ー ト 番 号 ( -m オ プ シ ョ ン に 対 応 )は 、 601か ら 10601に 変 更 さ れ ま す 。

• ユ ー ザ マ ッ プ フ ァ イ ル %%SYSCONFDIR%%/usermapが 作 成 さ れ ま す 。 メ タ デ ー タ サ ー バ は 、 起 動 時 に こ の フ ァ イ ル を 読 み 込 み ま す 。 プ ラ イ ベ ー ト モ ー ド で な い 場 合 、 OS上 に ユ ー ザ ア カ ウ ン ト _gfarmmd と _gfarmfs が 作 成 さ れ て い な け れ ば い け ま せ ん 。 ユ ー ザ マ ッ プ フ ァ イ ル が あ れ ば 、 ユ ー ザ ア カ ウ ン ト の 作 成 は 必 要 あ り ま せ ん 。 こ の フ ァ イ ル は 、 実 際 の ユ ー ザ ア カ ウ ン ト に 対 す る Gfarmシ ス テ ム ユ ー ザ の マ ッ ピ ン グ を 定 義 し て い ま す 。

• gfsd設 定 フ ァ イ ル %%SYSCONFDIR%%/gfsd.conf が 作 成 さ れ ま す 。 プ ラ イ ベ ー ト モ ー ド で な い 場 合 、 gfsdは 、 メ タ デ ー タ サ ー バ と 接 続 す る 全 て の Gfarmプ ロ グ ラ ム が 読 み 込 む 前 に 、 gfarm設 定 フ ァ イ ル %%SYSCONFDIR%%/gfarm2.conf を 読 み 込 み ま す 。 %%SYSCONFDIR%%/gfsd.confは 、 プ ラ イ ベ ー ト モ ー ド で 起 動 す る gfsd向 け に カ ス タ マ イ ズ さ れ た 設 定 フ ァ イ ル で す 。

-S オ プ シ ョ ン は 、 起 動 /停 止 ス ク リ プ ト や 設 定 フ ァ イ ル の 位 置 を 決 し て 変 更 し ま せ ん 。 こ れ ら の フ ァ イ ル の デ フ ォ ル ト 位 置 は 通 常 で は 特 権 ユ ー ザ の 場 合 の み 書 き 込 み 可 能 で あ る た め 、 config-gfarm は こ れ ら の フ ァ イ ル の 生 成 に 失 敗 し て し ま い ま す 。 こ の 問 題 を 回 避 す る た め に は 、 --prefix オ プ シ ョ ン を 合 わ せ て 指 定 し て く だ さ い 。

-N

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 gfmd と バ ッ ク エ ン ド DBを 起 動 し ま せ ん 。

-f

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 強 制 的 に 存 在 し て い る セ ッ ト ア ッ プ を 上 書 き し ま す 。

-t

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

-T

-t オ プ シ ョ ン と 似 て い ま す が 、 設 定 値 を KEY=VALUE形 式 で 表 示 し ま す 。

-r

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 メ タ デ ー タ サ ー バ 同 士 で の メ タ デ ー タ の 複 製 を 有 効 に し ま す 。

-W バ ッ ク エ ン ド DB用 パ ス ワ ー ド

バ ッ ク エ ン ド DBの 管 理 者 パ ス ワ ー ド を 指 定 す る こ と が で き ま す 。 こ の オ プ シ ョ ン は 、 ユ ー ザ 名 を 指 定 す る -U オ プ シ ョ ン に 対 応 し ま す 。 デ フ ォ ル ト で 、 パ ス ワ ー ド は 自 動 的 に 生 成 さ れ ま す 。

-w バ ッ ク エ ン ド DBへ の 接 続 用 パ ス ワ ー ド

設 定 さ れ た gfmd は 、 指 定 さ れ た パ ス ワ ー ド を 使 用 し て バ ッ ク エ ン ド DBと 接 続 し ま す 。 こ の オ プ シ ョ ン は 、 ユ ー ザ 名 を 指 定 す る -u オ プ シ ョ ン に 対 応 し ま す 。 デ フ ォ ル ト で 、 パ ス ワ ー ド は 自 動 的 に 生 成 さ れ ま す 。

-X

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

-E

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 デ ー タ チ ェ ッ ク サ ム オ プ シ ョ ン を 付 け た PostgreSQLセ ッ ト ア ッ プ し ま す 。 config-gfarm は 、 --data-checksums オ プ シ ョ ン を PostgreSQLコ マ ン ド initdb に 渡 し ま す 。 こ の 機 能 を 使 用 す る に は 、 PostgreSQL 9.3ま た は そ れ 以 降 の バ ー ジ ョ ン が 必 要 で す 。 こ の オ プ シ ョ ン は 、 バ ッ ク エ ン ド DBが PostgreSQLで あ る と き の み 機 能 し ま す 。

FILES

%%SYSCONFDIR%%/gfarm2.conf

Gfarmの ク ラ イ ア ン ト が 参 照 す る 設 定 フ ァ イ ル

%%SYSCONFDIR%%/gfmd.conf

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

%%SYSCONFDIR%%/gfsd.conf

gfsd が 参 照 す る 設 定 フ ァ イ ル (プ ラ イ ベ ー ト モ ー ド の 場 合 の み 使 用 )

%%SYSCONFDIR%%/usermap

ユ ー ザ マ ッ ピ ン グ を 定 義 し て い る フ ァ イ ル (プ ラ イ ベ ー ト モ ー ド の 場 合 の み 使 用 )

/etc/init.d/gfarm-pgsql

Gfarmの バ ッ ク エ ン ド DBと し て 動 作 す る PostgreSQLの 起 動 /停 止 ス ク リ プ ト フ ァ イ ル

/etc/init.d/gfmd

gfmd が 参 照 す る 起 動 /停 止 ス ク リ プ ト フ ァ イ ル で す 。

/etc/systemd/system/gfarm-pgsql.service

systemdに よ り 読 み 込 ま れ 、 Gfarmの バ ッ ク エ ン ド DBと し て 動 作 す る PostgreSQLの ユ ニ ッ ト 設 定 フ ァ イ ル

/etc/systemd/system/gfmd.service

systemdに よ り 読 み 込 ま れ る 、 gfmd の ユ ニ ッ ト 設 定 フ ァ イ ル

SEE ALSO

gfarm2.conf (5), config-gfsd (8)

---