'\" t .\" Title: gfarmbb .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 4 Oct 2019 .\" Manual: Gfarm .\" Source: Gfarm .\" Language: English .\" .TH "GFARMBB" "1" "4 Oct 2019" "Gfarm" "Gfarm" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" gfarmbb \- Gfarm/BB（Gfarm burst buffer）を構築・撤去する .SH "SYNOPSIS" .HP \w'\fBgfarmbb\fR\ 'u \fBgfarmbb\fR [\fIoptions\fR] \fImode\fR .SH "DESCRIPTION" .PP Gfarm/BBは計算ノードのローカルストレージを用いる、一時的なオンデマンド ユーザレベルファイルシステムです。 \fBgfarmbb\fRはGfarm/BBの構築、撤去を行い ます。\fImode\fRには、startかstopかstatusを指定します。modeがstartのとき、 Gfarm/BBを利用するための環境変数が表示されます。Gfarm/BBに対しGfarmコ マンドを用いるためには、次のように環境変数を評価します。 .PP % eval `gfarmbb start` .PP 原則的に、start, stop, statusについて同じオプションを指定して下さい。 .SH "OPTIONS" .PP \fB\-mpi\fR \fImpirun_cmd\fR .RS 4 Gfarm/BBをMPIを用いて構築します。 \fImpirun_cmd\fRはGfarm/BBの構築とgfsd の起動に用いられるMPIのコマンドラインを指定します。MPIのコマンドラ インではノード毎に1プロセス起動するようにします。本オプションは \-confオプションと共に用います。本オプションが指定された場合、\-eオプ ションと\-hオプションは無視されます。 .RE .PP \fB\-e\fR .RS 4 gfmdを別ノードで実行します。gfmdはgfarmbbを実行したホストで実行さ れますが、gfmdを起動したノードではgfsdを起動しません。本オプション は、N+1ホストが割り当てられ、ホストファイルの最後のノードでgfarmbb を起動することを想定しています。本オプションはstartの時だけ有効です。 .RE .PP \fB\-h\fR \fIhostfile\fR .RS 4 計算ノードのホスト名のリストを含む \fIhostfile\fRを指定します。 .RE .PP \fB\-scr\fR \fIscratch_dir\fR .RS 4 Gfarm/BBを構成するための各計算ノードのスクラッチディレクトリを指定 します。指定されたディレクトリが存在しない場合は作成されます。また このディレクトリ以下のファイルはgfarmbb stopで削除されます。 デフォルトは/tmp/gfarmbb\-scratchです。 .RE .PP \fB\-conf\fR \fIconf_dir\fR .RS 4 Gfarm/BBの設定ファイルを一時的に保持するためのディレクトリを指定し ます。本ディレクトリは全計算ノードからアクセスできる必要があります。 指定されたディレクトリが存在しない場合は作成されます。またこのディ レクトリ以下のファイルはgfarmbb stopで削除されます。 .RE .PP \fB\-l\fR .RS 4 ログインノードからGfarm/BBのアクセスを可能とします。このオプション をつけるとホームディレクトリにGfarm/BBの設定ファイルを作成します。 設定ファイルのパス名は$HOME/\&.gfarm2rc\-$IDとなります。IDは計算ノー ドのホスト名とプロセスIDで構成されます。Gfarm/BBをアクセスする場合 は、この設定ファイルをGFARM_CONFIG_FILE環境変数で指定します。 .RE .PP \fB\-L\fR \fIlog_dir\fR .RS 4 ログディレクトリを指定します。指定されたディレクトリが存在しない場 合は作成されます。gfmd, gfsdのログファイル名はそれぞれgfmd\-$ID\&.log, gfsd\-$ID\&.logです。デフォルトはスクラッチディレクトリ/logです。本オ プションはstartの時だけ有効です。 .RE .PP \fB\-m\fR \fImount_point\fR .RS 4 このオプションが指定されたとき、構築したGfarm/BBは指定されたマウン トポイントにマウントされます。mount\&.gfarm2fsが必要です。また、本オ プションはstartの時だけ有効です。 .RE .PP \fB\-p\fR \fIperiod\fR .RS 4 Gfarm/BBの共有鍵の有効期間を秒単位で指定します。有効時間はジョブ実 行時間より長くする必要があります。デフォルトは86400秒（1日）です。 本オプションはstartの時だけ有効です。 .RE .PP \fB\-c\fR .RS 4 Cシェルのコマンドを出力します。本オプションはstartの時だけ有効です。 .RE .PP \fB\-s\fR .RS 4 Bourneシェルのコマンドを出力します。本オプションはstartの時だけ有 効です。デフォルト設定です。 .RE