ブランチ

一連のホスト上で並列タスクを起動します。

概要

blaunch [-n] [-u host_file | -z host_name ... | host_name] [-use-login-shell | -no-shell] コマンド [argument ...]
blaunch [-h | -V]

説明

重要: コマンド・ラインから blaunch を直接実行することはできません。
制約事項: コマンド blaunch は、ユーザー・アカウント・マッピングでは機能しません。 ユーザー・アカウント・マッピング・ホストで blaunch を実行しないでください。

ほとんどの MPI 実装および多くの分散アプリケーションは、タスク起動メカニズムとして rsh コマンドおよび ssh コマンドを使用します。 blaunch コマンドは、 LSF内で並列アプリケーションを起動する透過的な方法として、 rsh コマンドおよび ssh コマンドのドロップイン置換を提供します。

blaunch コマンドは、 rsh および sshとして以下のコア・コマンド行オプションをサポートします。

  • rsh host_name command
  • ssh host_name command

他のすべての rsh および ssh コマンド・オプションは、通知なしに無視されます。

blaunch コマンドは、リモート・ホスト上の RES デーモンおよび sbatchd デーモンに透過的に直接接続します。 リモート・タスクが作成されて追跡され、 LSF への接続が維持されます。 pam コマンドや taskstarter コマンド、またはその他のラッパーを挿入する必要はありません。

blaunch コマンドは、 LSFの下でのみ機能します。 これは、ジョブ割り振りの一部であるリモート・ホスト上のタスクを起動するためにのみ使用できます。 スタンドアロン・コマンドとして使用することはできません。

ホスト名が指定されていない場合、 LSF は、割り振られたすべてのホスト上でタスクを実行します (ジョブ・スロットごとに 1 つのリモート・タスク)。

Windows では、 blaunch コマンドは Windows 2000 以降でサポートされますが、以下の例外があります。
  • 次のシグナルのみがサポートされます: SIGKILL、 SIGSTOP、 SIGCONT。
  • -n オプションはサポートされません。
  • CMD.EXE /C <user_command_line> コマンドは、 -no-shell オプションが指定されていない場合に、中間コマンド・シェルとして使用されます。
  • -no-shell オプションが指定されている場合、 CMD.EXE /C コマンドは使用されません。
  • ジョブを実行するには、Windows ユーザー・アカウント制御が正しく構成されている必要があります。
  • LSF の外部で (例えば、 taskkill コマンドを使用して) 強制終了されたタスクは、通常の出口を持つものと想定されます。

blaunch コマンドを使用して起動されたパラレル・ジョブの場合、 lsb.queues ファイルの JOB_CONTROLS パラメーターで定義されたジョブ制御アクションは、最初の実行ホストでのみ有効になります。 キューに定義されているジョブ制御アクションは、他のホストで実行されているタスクには影響しません。 JOB_CONTROLS パラメーターが定義されている場合、 LSF のデフォルトのジョブ制御シグナル (SUSPEND,RESUME,TERMINATE) 各実行ホスト上の各タスクに到達しません。

blaunch コマンドを使用して起動されるパラレル・ジョブの場合、自動ジョブ・サイズ変更はシグナル・メカニズムにすぎません。 blaunch コマンドで起動される元のジョブの範囲は拡張されません。 サイズ変更通知スクリプトは、シグナル・リスニング・スクリプトとともに必要です。 シグナル・リスニング・スクリプトは、通知に対して追加の blaunch コマンドを実行して、ジョブ・タスクで使用できるようにサイズ変更されたリソースを割り振ります。 シグナル listen および通知スクリプトの作成については、 IBM サポートにお問い合わせください。

オプション

-n
標準入力は /dev/nullから取得されます。 Windows ではサポートされません。
--u host_file
host_file ファイルにリストされているすべてのホストでタスクを実行します。

ホスト名のリストを含むファイルへのパスを指定します。 各ホスト名は、ホスト・リスト・ファイル内の別々の行にリストする必要があります。

このオプションは、 -z オプションと同時に指定することはできません。

host_name
リモート・タスクが起動されるホストの名前です。
--z ホスト名...
指定されたすべてのホストでタスクを実行します。

rsh および ssh のホスト名の値は、通常は単一のホスト名ですが、 -z オプションを使用して、タスクが並行して開始されるホストのリストをスペースで区切って指定することができます。

タスクを実行するホストのリストを指定します。 複数のホスト名を指定する場合は、ホスト名を引用符 (" または ') で囲み、空白文字で区切る必要があります。

このオプションは、 -u オプションと同時に指定することはできません。

-use-login-シェル
ユーザーのログイン・シェルを介してコマンドを起動します。

UNIX および Linux ホストにのみ適用されます。

-シェルなし
中間シェルなしでコマンドを起動します。
コマンド [argument ...]
実行するコマンドを指定します。 コマンドは、コマンド行の最後の引数でなければなりません。
-h
コマンドの使用法を stderr に出力して終了します。
-V
LSF リリース・バージョンを stderr に出力して終了します。

診断

すべてのコマンドが正しく実行されると、終了状況は 0 になります。

関連資料

lsb_getalloc、 lsb_launch API