添付

説明

デバッグの目的で、または一般的な接続のために、指定されたジョブの実行ホストまたは Docker コンテナーに直接接続 (アタッチ) するには、 battach コマンドを使用します。 接続すると、対話式コマンド行からシェル・コマンドを実行できます。

battach は、デフォルトで対話式 /bin/sh シェルを実行ホスト上のジョブ実行依頼ユーザーとして実行し、ユーザーとジョブ実行ホストの間の入出力を管理します。 代替シェルを指定するには、 -L オプションを使用します。 LSF は、 battach が開始するシェル・プロセスを実行ホスト上のジョブ cgroup に入れます。 シェル・プロセス所有者は、ジョブ実行依頼ユーザーです。

Docker 以外の順次ジョブの場合、 battach コマンドはジョブ実行ホストに接続します。 非Docker パラレル・ジョブの場合、 battach コマンドは、最初の実行ホストに接続するか、 battach -m コマンド・オプションを使用して、指定された実行ホストに接続します。

Docker 順次ジョブの場合、実行ホスト上に 1 つのジョブ・コンテナーがあります。 battach は、 docker exec job_container_id コマンドを実行してジョブ・コンテナーにジョブ実行依頼ユーザーとして接続し、ユーザーとジョブ実行ホストの間の入出力を管理します。 LSF は、 battach が開始するシェル・プロセスを実行ホスト上のジョブ cgroup に入れます。 プロセス所有者は、対応するアプリケーション・プロファイルに定義されているスターター・ユーザーまたはコンテキスト・ユーザーです。

Docker パラレル・ジョブの場合、実行ホスト上のコンテナーには、単一ジョブ・コンテナーとマルチタスク・コンテナーの 2 つのタイプがあります。 デフォルトでは、 battach は docker exec job_container_id コマンドも実行して、ジョブ・サブミット・ユーザーとしてジョブ・コンテナーに接続し、ユーザーとジョブ実行ホストの間の入出力を管理します。 タスク・コンテナーに接続するには、 -m オプションを指定します。 battach は、 docker exec task_container_id コマンドを実行し、ログイン・ユーザーとしてジョブ実行依頼ユーザーを使用してユーザーとジョブ実行ホストの間の入出力を管理することにより、最小のタスク ID でタスク・コンテナーに接続します。 LSF は、 battach が開始するシェル・プロセスを、実行ホスト上のタスク cgroup に入れます。 プロセス所有者は、対応するアプリケーション・プロファイルに定義されているスターター・ユーザーまたはコンテキスト・ユーザーです。

オプション

--m"実行ホスト"

パラレル・ジョブの場合、 battach が接続するジョブ実行ホスト (非Docker ジョブの場合) またはジョブ実行ホスト上のジョブ・コンテナー ( Docker ジョブの場合) を指定します。 指定するホストは、パラレル・ジョブのジョブ実行ホストの 1 つでなければなりません。

--L"shell_path"

battach がジョブ実行ホストまたはコンテナーで起動するシェルを指定します。 指定するパスは、絶対ファイル・パスでなければなりません。 相対ファイル・パスが無効です。 シェルの代わりにバイナリー・ファイルを指定すると、 battach は指定されたバイナリー・ファイルを実行して終了します。

デフォルトでは、これは /bin/sh シェルです。 LSB_BATTACH_DEFAULT_SHELL 環境変数が定義されている場合、 LSB_BATTACH_DEFAULT_SHELL はこのデフォルト値をオーバーライドし、 battach -L コマンド・オプションは LSB_BATTACH_DEFAULT_SHELL 環境変数の値をオーバーライドします。

ジョブID | ジョブID [ ジョブインデックス ]

このジョブ ID またはジョブ配列エレメントのジョブ実行ホストまたはコンテナーに接続します。 ジョブ配列を指定することも、実行中でないジョブを指定することもできません。

-h

コマンドの使用法を stderr に出力して終了します。

-V

製品リリース・バージョンを stderr に出力して終了します。