DOKK / manpages / debian 12 / gfarm-client / gfprep.1.ja
GFPREP(1) Gfarm GFPREP(1)

gfprep - ファイルの複製を並列に作成する

gfprep [-nqvdpPBU] [-X regexp] [-S source-domainname] [-h source-hostfile] [-D destination-domainname] [-H destination-hostfile] [-j num-of-processes] [-J num-of-processes] [-M total-byte] [-z minimum-byte] [-Z maximum-byte] [-w way-of-scheduling] [-W kilobytes-for-threshold] [-s KB/s-to-simulate] [-F num-for-readahead] [-I sec-to-update] [-mx] [-N num-of-replicas] path

gfprep は、ファイルの複製を並列に作成します。

path がディレクトリの場合、 その下にあるすべてのファイルに対する複製を 作成します。

path には、 Gfarm URL または gfarm2fs 上のパスを指定できます。

作成先のホスト群を指定することにより、ファイルの複製を作成するホストを 指定することができます。ホスト群は、ドメイン名か、ホスト名を行ごとに記 述したホストファイルで指定します。ドメイン名とホストファイルを両方指定 した場合は、両方の条件に合うホスト群が選ばれます。また、作成元のホスト 群も指定可能です。その場合、そのホスト群に存在するファイルのみ複製が作 成されます。

gfprepは、なるべく複製を作成中ではないホストを選択してファイル複製を作 成します。作成元や作成先 1 ホストあたりの最大並列転送数は、ホストごと の CPU数です。 CPU 数については、gfhost コマンドのマニュアルを参照して ください。

gfprep は、ディレクトリを辿る際に、 ディレクトリエントリ情報も並列に取 得します。

以下は gfprep 専用のオプションです。

-N num-of-replicas

ファイル複製数を指定します。 作成先のホスト群に十分な数の複製が存 在する場合、複製作成も複製削除も、どちらもしません。

このオプションを指定しない場合は、-N 1 を指定したことになります。

-x

-N オプションで指定された数よりも多くのファイル複製が作成先のホス ト群に存在する場合は、余分なファイル複製を削除します。

-m

作成元から作成先にファイルの複製を移動します。 -mm のように 2 回指 定すると、作成元のファイルの複製を削除しません。

-S, -h, -D, -H のいずれかのオプションが必要です。

このオプションと -N オプションは、どちらか一方を使用できます。

gfpcopy には gfprep と共通のオプションがあります。 gfpcopy のマニュアル を参照してください。

ディレクトリ以下すべてのファイルの複製を作成します。

$ gfprep -N 3 gfarm:///dir

$ cd /mnt/gfarm2fs
$ gfprep -N 3 dir

足りなければ複製を増やし、余分な複製があれば削除します。

$ gfprep -N 3 -x gfarm:///dir/file

gfsd1.example.com にある複製を別のノードに移動します。

$ gfprep -m -S gfsd1.example.com gfarm:///

-L または -m オプションを使用しない場合は、指定した作成元の中から ファイルの複製、コピーが行われるとはとは限りません。

gfprep コマンドは、 gfmd と同じホストで実行するほうがよいです。 gfmdgfprep が距離的に離れている場合には、 gfprep の動作が遅くなります。 そのような場合には、-j または -J オプションに大きな値を指定すると、 性能が改善するかもしれません。

gfrep(1), gfpcopy(1), gfhost(1), gfarm2.conf(5)

14 Jan 2017 Gfarm