Man page - config-gfsd(8)

Packages contains this manual

Available languages:

en ja

Manual

CONFIG-GFSD

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
SEE ALSO

NAME

config-gfsd - Gfarmの フ ァ イ ル ス プ ー ル ノ ー ド の セ ッ ト ア ッ プ

SYNOPSIS

config-gfsd [ オ プ シ ョ ン ]

DESCRIPTION

config-gfsd は 、 Gfarmフ ァ イ ル シ ス テ ム の フ ァ イ ル ス プ ー ル ノ ー ド を セ ッ ト ア ッ プ す る た め の ユ ー テ ィ リ テ ィ で す 。 な お 、 こ の フ ァ イ ル ス プ ー ル ノ ー ド に 対 す る サ ー バ プ ロ グ ラ ム は 、 gfsd と 名 づ け ら れ て い ま す 。 Gfarmの 開 発 、 評 価 、 ま た は テ ス ト と い っ た 私 的 な 用 途 で フ ァ イ ル シ ス テ ム を 使 用 す る 場 合 を 除 き 、 config-gfsd を 実 行 す る た め に は 、 ル ー ト 権 限 が 必 要 で す 。

config-gfsd は 、 設 定 フ ァ イ ル %%SYSCONFDIR%%/gfarm2.conf (プ ラ イ ベ ー ト モ ー ド の 場 合 は 、 %%SYSCONFDIR%%/gfsd.conf) が ホ ス ト 上 に 存 在 す る こ と を 前 提 と し て い ま す 。 存 在 し な い 場 合 は 、 メ タ デ ー タ サ ー バ か ら 設 定 フ ァ イ ル を コ ピ ー し て く だ さ い 。

config-gfsd は 下 記 に 示 し た 順 に 実 行 し ま す 。

1. ス プ ー ル デ ィ レ ク ト リ を 作 成 し ま す 。

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

3. gfsd を 起 動 /停 止 す る た め の ス ク リ プ ト (ま た は 、 設 定 フ ァ イ ル )を 作 成 し ま す 。

大 抵 の OSに お い て 、 config-gfsd は 、 起 動 /停 止 ス ク リ プ ト gfsd(プ ラ イ ベ ー ト モ ー ド の 場 合 は 、 gfsd-ADDRESS)を /etc/init.dま た は /etc/rc.d/init.dに 置 き ま す 。 (ど ち ら に 置 く か は OSに 依 存 し ま す 。 )

Red Hat Enterprise Linux 7 ま た は そ れ 以 降 の systemdで 動 作 す る Linuxに お い て 、 config-gfsd は 、 ユ ニ ッ ト 設 定 フ ァ イ ル で あ る gfsd.service (プ ラ イ ベ ー ト モ ー ド の 場 合 は 、 gfsd-ADDRESS.service)を /etc/systemd/systemデ ィ レ ク ト リ に 置 き ま す 。 そ の 後 、 systemctl enable gfsd.service (ま た は systemctl enable gfsd-ADDRESS.service ) を 実 行 し ま す 。

4. プ ラ イ ベ ー ト モ ー ド の 場 合 、 config-gfsd は 、 gfhost -c を 実 行 す る こ と に よ り 、 メ タ デ ー タ サ ー バ に フ ァ イ ル ス プ ー ル ノ ー ド で あ る ホ ス ト を 登 録 し ま す 。 プ ラ イ ベ ー ト モ ー ド で は な い 場 合 、 config-gfsd は 、 メ タ デ ー タ サ ー バ に フ ァ イ ル ス プ ー ル ノ ー ド で あ る ホ ス ト の 登 録 方 法 を 以 下 に 示 す 例 の よ う に 表 示 し ま す 。

Please ask admin_user to register your host by the following command:

/usr/bin/gfhost -c -a x86_64-centos7.0-linux -p 600 -n 2 ext540

5. プ ラ イ ベ ー ト モ ー ド の 場 合 、 config-gfsd は gfsd を 起 動 し ま す 。 プ ラ イ ベ ー ト モ ー ド で は な い 場 合 、 config-gfsd は gfsd の 起 動 方 法 を 以 下 の よ う に 表 示 し ま す 。

After that, start gfsd by the following command as a root:

systemctl start gfsd.service

6. unconfig-gfsd.sh と い う ス ク リ プ ト を %%SYSCONFDIR%% 上 に 作 成 し ま す 。 こ の ス ク リ プ ト は 、 gfsd の セ ッ ト ア ッ プ の 取 り 消 し を 行 い ま す 。 gfsd を 停 止 し 、 config-gfsd に よ っ て 作 成 さ れ た フ ァ イ ル ( unconfig-gfsd.sh ス ク リ プ ト 自 身 を 含 む ) を す べ て 消 去 し ま す 。

config-gfsd を 使 用 し て フ ァ イ ル ス プ ー ル ノ ー ド を セ ッ ト ア ッ プ す る 前 に 、 config-gfsd -t を 実 行 す る こ と を 推 奨 し ま す 。 -t オ プ シ ョ ン を 付 け て 実 行 す る こ と に よ り 、 セ ッ ト ア ッ プ す る 代 わ り に 全 て の 設 定 パ ラ メ ー タ を 表 示 し ま す 。

$ config-gfsd -t

prefix [--prefix]:
hostname [-h]: host1.example.org
listen address [-l]: (all local IP addresses)
architecture [-a]: x86_64-centos6.5-linux
port [-p]: 600
ncpu [-n]: 8
spool directory : /var/gfarm-spool
rc script : /etc/init.d/gfsd
gfarm client conf file : /etc/gfarm2.conf
gfsd pid file : /var/run/gfsd.pid

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

OPTIONS

--prefix パ ス

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 以 下 に 挙 げ た gfsd に 関 連 す る 複 数 の パ ス が 設 定 さ れ ま す 。 具 体 的 に は 、 以 下 の 通 り で す 。

• gfsd の ス プ ー ル デ ィ レ ク ト リ : PREFIX/var/gfarm-spool

• gfsd の PIDフ ァ イ ル を 置 く た め の デ ィ レ ク ト リ : PREFIX/var/run

• 設 定 フ ァ イ ル が 置 か れ た デ ィ レ ク ト リ : PREFIX/etc

• gfsd の 起 動 /停 止 ス ク リ プ ト が 置 か れ た デ ィ レ ク ト リ : PREFIX/etc/init.d か 、 PREFIX/rc.d/init.d/etc こ れ は OSに 依 存 し ま す 。

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

• セ ッ ト ア ッ プ を 取 り 消 す ス ク リ プ ト unconfig-gfsd.sh : PREFIX/etc/unconfig-gfsd.sh

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

-a ア ー キ テ ク チ ャ

ホ ス ト の ア ー キ テ ク チ ャ を 指 定 し ま す 。 config-gfsd は 、 指 定 さ れ た ア ー キ テ ク チ ャ を gfhost -c コ マ ン ド に -a オ プ シ ョ ン の 引 数 と し て 渡 し ま す 。 デ フ ォ ル ト で 、 config-gfsd は ア ー キ テ ク チ ャ を 推 測 し そ れ を 使 用 し ま す 。

-p ポ ー ト 番 号

gfsd が 待 ち 受 け る TCPポ ー ト 番 号 を 指 定 し ま す 。 デ フ ォ ル ト で は プ ラ イ ベ ー ト モ ー ド の 場 合 に 10600、 そ れ 以 外 で は 600が 指 定 さ れ ま す 。

-h ホ ス ト 名

ホ ス ト 名 を 指 定 す る こ と が で き ま す 。 config-gfsd は 、 指 定 さ れ た ホ ス ト 名 を gfhost -c コ マ ン ド に 非 オ プ シ ョ ン の 引 数 と し て 渡 し ま す 。 デ フ ォ ル ト で は 、 DNS上 に お け る そ の ホ ス ト の 完 全 修 飾 ド メ イ ン 名 (FQDN)と な り ま す 。

-l IPア ド レ ス

gfsd の 待 ち 受 け る ア ド レ ス を 指 定 す る こ と が で き ま す 。 デ フ ォ ル ト で は 、 全 て の ロ ー カ ル IPア ド レ ス で 待 ち 受 け ま す 。 オ プ シ ョ ン が 指 定 さ れ た 場 合 、 以 下 に 挙 げ た 変 更 が 生 じ ま す 。

• config-gfsd が 起 動 /停 止 ス ク リ プ ト を 作 成 す る 際 、 そ の ス ク リ プ ト 名 は 、 gfsd か ら gfsd-ADDRESSに 変 更 さ れ ま す 。

• config-gfsd が systemdの 設 定 フ ァ イ ル を 作 成 す る 際 、 そ の フ ァ イ ル 名 は 、 gfsd.serviceか ら gfsd-ADDRESS.serviceに 変 更 さ れ ま す 。

• ス プ ー ル デ ィ レ ク ト リ は 、 PREFIX/var/gfarm-spoolか ら PREFIX/var/gfarm-spool-ADDRESS に 変 更 さ れ ま す 。 た だ し 、 PREFIXは --prefix で 指 定 さ れ た 接 頭 辞 で す 。

-n cpu数

ホ ス ト の CPU数 を 指 定 す る こ と が で き ま す 。 config-gfsd は 、 指 定 さ れ た CPU数 を gfhost -c コ マ ン ド に -n オ プ シ ョ ン の 引 数 と し て 渡 し ま す 。 デ フ ォ ル ト で は 、 config-gfsd は CPU数 を 推 測 し そ の 値 を 与 え ま す 。

--help

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

-S

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

• gfsd に お け る デ フ ォ ル ト の 待 ち 受 け ポ ー ト 番 号 ( -p に 対 応 )が 、 600か ら 10600に 変 更 さ れ ま す 。

• %%SYSCONFDIR%%/gfarm2.confの 代 わ り に 、 %%SYSCONFDIR%%/gfsd.conf設 定 フ ァ イ ル を 更 新 し ま す 。

• gfhost -cコ マ ン ド を 実 行 す る こ と に よ り 、 フ ァ イ ル ス プ ー ル ノ ー ド を 登 録 し ま す 。

• -N オ プ シ ョ ン が 付 与 さ れ て い る か に 関 わ ら ず 、 gfsd を 起 動 し ま す 。

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

-N

こ の オ プ シ ョ ン を 付 与 し た 場 合 、 gfsd を 起 動 し ま せ ん 。

-f

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

-t

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

-T

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

FILES

%%SYSCONFDIR%%/gfarm2.conf

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

%%SYSCONFDIR%%/gfsd.conf

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

/etc/init.d/gfsd

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

/etc/systemd/system/gfsd.service

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

SEE ALSO

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