oarsub-クラウドのオンライン

プログラム：

NAME

oarsub-OARバッチスケジューラジョブ送信コマンド。

SYNOPSIS

オールサブ [オプション]

オールサブ [オプション]

オールサブ [オプション] " 「」

オールサブ [オプション] -I

オールサブ [オプション] -C

DESCRIPTION

XNUMXつの用途 オールサブ に仕事を提出する オール バッチ スケジューラ のリソースの管理 (HPC)
クラスタ。 ジョブは、実行に必要な一連のリソースの説明によって定義されます。
タスク、および実行するスクリプトまたは実行可能ファイル。 ジョブはインタラクティブに実行することもできます。
また、oarsubを使用して、以前に送信されたジョブに接続します。

スケジューラーは、oarsubに一致するリソースのセットを提供することを担当します
リクエスト。 スケジュールされて起動されると、ジョブは最初に実行されるXNUMXつのプロセスで構成されます
関連付けられたリソースのノードで、環境変数のセットが設定されています。
仕事を説明します。 つまり、ジョブの実行可能ファイルはそれらを接続する責任があります
リソースとそれらの間のディスパッチング作業。

OPTIONS

-私、 - 相互の作用
インタラクティブなジョブをリクエストします。 代わりに、ジョブの最初のノードでログインシェルを開きます
スクリプトの実行。

-C、 - 接続
実行中のジョブに接続します。

-l、 - 資源
ジョブに要求されたリソースを設定します。 パラメータは、で定義されているリソースプロパティです。
OARデータベース、および前のジョブの最大期間を指定する「ウォールタイム」
その終了（ジョブプロセスは早期に終了できます）。 ウォールタイムフォーマットは
[hour:mn:sec|hour:mn|hour]. Ex: nodes=4/cpu=1,walltime=2:00:00

同じ行に複数の-lオプションを指定できます。 それは成形可能な仕事を定義します：仕事
さまざまな形をとることができます。 たとえば、非常に柔軟なアプリケーションの場合、
次のジョブ送信を実行できます。

oarsub -l cpu = 2、walltime = 20：00：00 -l cpu = 4、walltime = 10：00：00 -l cpu = 8、walltime = 5：00：00 ./script.sh

OARは、提案されたXNUMXつのリソース定義のXNUMXつを、
クラスターの負荷、および可能な限り早い開始のクラスターを優先します。

たとえば、次のようなさまざまなリソースグループをリクエストすることもできます。

oarsub -l "{mem> 64} / host = 1 + {mem <48} / host = 3"、walltime = 1：00：00 -I

スケジューラジョブには、プロパティ「mem」> 1のホストが64つ、プロパティが3つのホストがあります。
"mem" <48。中括弧{...}の間の構文は、 "-p"に使用される構文と同じです。
オプションを選択します。

- 配列
「NUMBER」サブジョブを含む配列ジョブを送信します。 すべてのサブジョブは同じものを共有します
array_idですが、各サブジョブは独立しており、独自のjob_idを持っています。 すべてのサブジョブには
同じ特性（スクリプト、要件）であり、
環境変数$ OAR_ARRAY_INDEX。

配列ジョブは、対話型（-I）でも予約型（-r）でもありません。

--array-param-file
パラメトリックアレイジョブを送信します。 「FILE」の空でない各行は、パラメーターを定義します
サブジョブの場合。 すべてのサブジョブは同じ特性（スクリプト、要件）を持ち、
環境変数$ OAR_ARRAY_INDEXで識別できます。 「＃」はコメントです
符号。

パラメトリックアレイジョブは、インタラクティブ（-I）でも予約（-r）でもできません。

-NS、 --スキャンスクリプト
バッチモードのみ：指定されたスクリプトでOARディレクティブをスキャンするようにoarsubに依頼します（#OAR -l ...）

-NS、 - 列
ジョブを送信するキューを設定します。

-NS、 - 財産 「」 「」
ジョブのリソースプロパティに対する制約のリストを追加します。 のフォーマット
contraintは、SQL構文を使用するWHERE句のXNUMXつです。

-NS、 - 予約
指定された時間にジョブを開始するように要求します。 このオプションを使用したジョブの作成は次のとおりです。
と呼ばれる . 予約 （とは反対に 提出).

-チェックポイント
ジョブのチェックポイントメカニズムを有効にします。 信号はDELAY秒で送信されます
ジョブの最初のプロセスへのウォールタイムの前（ジョブの最初のノード上）
資力）。

- 信号 <#SIG>
チェックポイントをトリガーするために使用する信号を指定します。 信号番号を使用します（killを参照）
-l）、デフォルトは 12 （SIGUSR2）。

-NS、 - タイプ
特定のタイプを指定します（最大限の努力, 時間を共有する, べき等, コシステム, 展開します, ヌープ,
コンテナ, 内側の, トークン：xxx = yy、...）

注意：
-との仕事 最大限の努力 タイプは最も低い優先度でスケジュールされ、
「通常の」ジョブがそのリソースを必要とする場合、強制終了されます。
-との仕事 べき等 タイプは、その終了コードがあれば自動的に再送信されます
は99で、持続時間は60秒を超えます。
-との仕事 べき等 　 最大限の努力 タイプは自動的に再送信されます
最善を尽くさないジョブを実行するために、通常の終了前にOARによって強制終了されたときはいつでも。
-との仕事 ヌープ typeは、リソースを予約する以外は何もしません。 終了しました
ウォールタイムの終了時、またはoardelコマンドを使用する場合。

-NS、 - ディレクトリ
コマンドを起動するディレクトリを指定します（デフォルトは現在のディレクトリです）

- 事業
ジョブが属するプロジェクトの名前を指定します。

-NS、 - 名前
ジョブには任意の名前を指定してください。

-a、 -前部
新しいジョブの実行が依存する必要がある以前に送信されたジョブ。 新しい仕事は
前のものの終わりからのみ開始します。

-通知する
通知方法（実行するメールまたはコマンド）を指定します。 元：
-通知 "メール：name@domain.com"
-「exec：/ path / to / scriptargs」に通知します

引数はjob_id、job_name、TAG、commentです

TAGは次のようになります。
-実行中：ジョブが開始されたとき
--END：ジョブが正常に終了したとき
-エラー：ジョブが異常終了した場合
-INFO：ジョブでoardelが呼び出されたときに使用されます
--SUSPENDED：ジョブが一時停止されたとき
-再開：ジョブが再開されたとき

デフォルトでは、すべてのTAGがトリガーされます。 どのTAGが必要かを指定することが可能です
引き金になった。 元：
-通知 "[END、ERROR] mail：name@domain.com"
-通知 "[実行中]メール：name@domain.com"
-「[RUNNING、END、ERROR] exec：/ path / to / scriptargs」に通知します

-再送信
指定されたジョブを新しいジョブとして再送信します。

-k、 --ジョブキーを使用
ジョブキーメカニズムをアクティブにします。 ジョブキーが生成され、接続できるようになります
OARによって管理されるリソースのセットの外部からのジョブ。 ジョブキーメカニズムは次のようになります。
OAR環境ではデフォルトでアクティブ化されています。 この場合、このオプションは役に立ちません。

-私、 --ファイルからジョブキーをインポート
代わりに、既存のファイル（公開鍵ファイルと秘密鍵ファイル）から使用するジョブキーをインポートします
新しいものを生成するのです。 OAR_JOB_KEY_FILE環境変数を使用することもできます。

--インポート ジョブ キー インライン
新しいものを生成する代わりに、インライン（テキスト）を使用するためにジョブキーをインポートします。

-e、 --ジョブキーをファイルにエクスポート
ジョブキーをファイルにエクスポートします。 警告：ファイルがすでに上書きされている場合
存在します。 （％jobid％パターンは自動的に置き換えられます）

-O
ジョブの標準出力ストリームを保存するファイルを指定します。 ％jobid％
および％jobname％パターンは自動的に置き換えられます。

-E
ジョブの標準エラーストリームを保存するファイルを指定します。 ％jobid％と
％jobname％パターンは自動的に置き換えられます。

- 所有
ジョブの状態を待機ではなく保留に設定して、次の期間中はスケジュールされないようにします。
再開されません（ 再開する コマンドを使用すると、待機状態に戻すことができます）。

-NS、 -ダンパー
コマンドの結果をPerlのData :: Dumper形式で出力します。

-NS、 --xml
コマンドの結果をXML形式で出力します。

-Y、 --yaml
コマンドの結果をYAML形式で出力します。

-NS、 --json
コマンドの結果をJSON形式で出力します。

-NS、 - 助けて
このヘルプメッセージを印刷します。

-V、 - バージョン
OARのバージョンを印刷します。

ENVIRONMENT

OAR_FILE_NODES or OAR_NODE_FILE or OAR_NODEFILE
ジョブに起因するノードのリストを含むファイルへのパス名。

OAR_JOB_NAME
を使用して指定されたジョブの名前 -n オプションを選択します。

OAR_JOB_ID or OAR_JOBID
仕事のID。 各ジョブは一意のジョブ識別子を取得します。 この識別子は次の目的で使用できます
を使用してジョブに関する情報を取得する オールスタット、またはを使用して実行中のジョブに接続するには
オールサブ -C or オールシュ 例えば。

OAR_ARRAY_ID or OAR_ARRAYID
ジョブの配列ID。 すべての配列ジョブは、によって共有される一意の配列識別子を取得します
配列ジョブのすべてのサブジョブ。 この識別子は、
同じ配列ジョブに関連する異なるサブジョブ。 配列IDを使用して処理することもできます
特定の配列のすべてのサブジョブを一度に使用します（の--arrayオプションを使用）
oarstat、oarhold、oarresume、oardelの場合）。 注意：通常のジョブは、
サブジョブはXNUMXつだけです。

OAR_JOB_INDEX or OAR_JOBINDEX
ジョブの配列インデックス：配列ジョブ内で、各サブジョブは一意になります（特定のサブジョブに対して）
配列）0から始まるインデックス。サブジョブを識別するために使用できます。

OAR_JOB_WALLTIME 　 OAR_JOB_WALLTIME_SECONDS
hh：mm：ss形式および秒単位のジョブのウォールタイム。

OAR_RESOURCE_PROPERTIES_FILE
ジョブのすべてのリソース属性のリストを含むファイルへのパス名、および
それらの価値。 見る オールプリント また。

OAR_PROJECT_NAME
ジョブが含まれているプロジェクトの名前。 - 事業 オプションを選択します。

OAR_STDOUT 　 OAR_STDERR
ジョブの標準出力と標準エラーを保存するファイルへのパス名
インタラクティブモードで実行されていない場合は実行可能ファイル。

OAR_WORKING_DIRECTORY 別名 OAR_WORKDIR 別名 OAR_O_WORKDIR
ジョブの作業ディレクトリ。 ジョブ実行可能ファイルは、そのディレクトリで実行されます。
ジョブに割り当てられた最初のノード。

OAR_JOB_KEY_FILE
提出に使用するキーファイル（または オールシュ）ジョブキーメカニズム（-kまたは
--use-job-keyオプション）。 -iまたはを使用してインポートするジョブキーを提供できます。
--import-job-key-from-fileオプションも同様です。

SCRIPT

スクリプトシェルを使用してジョブを送信する場合、そのスクリプトにはいくつかのOARオプションを含めることができます。
で始まる行 ＃オール 上記と同じオプション構文を使用します。

例

Job 提出 　 引数
oarsub -l / nodes = 4 -I

oarsub -q default -l / nodes = 10 / cpu = 3、walltime = 50：30：00 -p "switch = 'sw1'" / home / username / path / to / my / prog

oarsub -r "2009-04-27 11:00:00" -l / nodes = 12 / cpu = 2

オールサブ-C 154

配列 ジョブ 提出 　 10 同一の サブジョブ
oarsub -l / nodes = 4 / home / usename / path / to / my / prog --array 10

パラメトリック 配列 ジョブ 提出
oarsub / home / users / toto / prog --array-param-file /home/username/path/to/params.txt

たとえば、/ home / username / path / to /param.txtには次のものが含まれます。

＃私のパラメータファイル
＃単一のパラメーターを持つサブジョブ
p100
＃パラメータのないサブジョブ
""
＃パラメータとしてXNUMXつの文字列を持つサブジョブ
"arg1a arg1b arg1c" "arg2a arg2b"

Job 提出 　 a ジョブ スクリプト
oarsub -S /home/ユーザー名/パス/to/my/script.sh

/home/username/path/to/my/script.shには、たとえば次のものが含まれています。

#!/bin/bash
#OAR -l /nodes=4/cpu=1,walltime=3:15:00
#OAR -p switch = 'sw3'またはswitch = 'sw5'
#OAR -t ベストエフォート
#OAR -t タイプ 2
#OAR -k
#OAR -e / path / to / job / key
#OAR --stdout stdoutfile.log
/ home / username / path / to / my / prog

onworks.netサービスを使用してオンラインでoarsubを使用する