pegasus-kickstart - クラウドでオンライン

プログラム：

NAME

pegasus-kickstart - リモートジョブラッパー

SYNOPSIS

ペガサスキックスタート [-n tr] [-N dv] [-H] [-R ウェブサイト] [-W | -w DIR]
[-L ポンド -T イソ] [-s p | @fn] [-S p | @fn] [-i fn]
[-o fn] [-e fn] [-X] [-l fn sz] [-F】（-I fn | アプリ [アプリフラグ])
ペガサスキックスタート -V

DESCRIPTION

ペガサスキックスタート 上のジョブの実行を管理および監視するラッパー プログラムです。
リモート リソース。

リモートスケジューラとアプリケーションプロセスの間に座って、次のことが可能です
ペガサスキックスタート プロセスの実行時の動作に関する追加情報を収集する
ジョブの終了ステータスを含む、リソースの使用状況。 この情報は重要です
Pegasus 呼び出しの追跡と、Globus GRAM ジョブの失敗の検出。

ペガサスキックスタート メインの前後にオプションでジョブを実行できます
メイン アプリケーション ジョブとの連鎖実行で実行されるアプリケーション ジョブ。 セクションを参照
サブジョブ この機能の詳細については、

また、stdin、stdout、および stderr を特定のファイルとの間でリダイレクトすることもできます。

アプリケーションへの相対パス指定を持つすべてのジョブは、相対検索の一部です
現在の作業ディレクトリに (はい、これは安全ではありません)、各コンポーネントを先頭に追加することによって
パス 環境変数。 最初の一致が使用されます。 アブソリュートを使用するジョブ
スラッシュで始まるパス名は除外されます。 実行可能ファイルへの絶対パスを使用することは
安全で推奨されるオプション。

ペガサスキックスタート 任意のジョブ (pre、post、main) のコマンド ラインを変数で書き換えます。
Unix 環境変数からの置換。 セクションを参照 変数 書き換え 以下で
この機能の詳細。

OPTIONS

-n tr
ジョブの最小限のパフォーマンス情報を関連付けるために、
呼び出しレコード、ジョブが実行する必要があるもの を担当しました
それを生産しています。 形式は、完全修飾定義名のテキスト表記です。
namespace::name:version のように、名前の部分のみが必須です。

デフォルトはありません。 値が指定されていない場合、「null」が報告されます。

-N dv
ジョブは、変換のどのインスタンス化が原因であったかを運ぶことができます
それを生産しています。 形式は、完全修飾定義名のテキスト表記です。
namespace::name:version のように、名前の部分のみが必須です。

デフォルトはありません。 値が指定されていない場合、「null」が報告されます。

-H
このオプションは、必要な場合、pegasus-kickstart が XML プリアンブル (エンティティ) を書き込むことを回避します。
複数の pegasus-kickstart レコードを XNUMX つのドキュメントに結合します。

さらに、指定された場合、環境およびリソース使用セグメントは変更されません。
連結されたレコードバージョンで、最初の実行が
それらの設定をキャプチャしました。

-R ウェブサイト
全体像を提供するために、pegasus-kickstart はサイト ハンドルを反映できます。
(リソース識別子) をその出力に追加します。

デフォルトはありません。 値が指定されていない場合、属性は生成されません。

-L ポンド, -T イソ
これらのオプションの引数は、(DAX からの) ワークフロー ラベルとワークフローの最後の
変更時間 (DAX から)。 ラベル ポンド 32 までの適切な文字列にすることができます
ただし、C 識別子文字を使用する必要があります。 タイムスタンプ イソ ISOでなければなりません
8601 準拠のタイムスタンプ。

-S l=p
ファイルの統計情報が必要な場合 すべてのジョブが開始されました。
stat への物理ファイルのマッピングは、 -S オプション。 LFN と PFN は、
等号 (=) 記号で連結されます。 LFN はオプションです。等号が見つからない場合、
引数は、LFN を使用しない単独の PFN 指定と見なされます。

このオプションは複数回指定できます。 コマンドラインを減らして克服するには
長さの制限。引数の前にアットマーク (@) が付いている場合、その引数が使用されます
LFN から PFN へのマッピングのテキスト ファイルになります。 上記の任意性が適用されます。
file 引数内の各行は、stat するファイルの名前です。 コメント (#) と
空行は許可されます。

各 PFN には スタットコール 属性を持つレコード (要素) id 値に設定
初期。 オプションの ふん 属性は LFN stat'ed に設定されます。 ファイル名は
　 統計情報 内に記録します。

デフォルトはありません。

-s fn
ファイルの統計情報が必要な場合 After すべてのジョブが終了しました。論理的に
stat への物理ファイルのマッピングは、 -s オプション。 LFN と PFN は、
等号 (=) 記号で連結されます。 LFN はオプションです。等号が見つからない場合、
引数は、LFN を使用しない単独の PFN 指定と見なされます。

このオプションは複数回指定できます。 コマンドラインの長さを短縮して克服するには
制限、引数の前にアットマーク (@) が付いている場合、引数は
LFN から PFN へのマッピングのテキスト ファイル。 上記の任意性が適用されます。 各
file 引数内の行は、stat するファイルの名前です。 コメント (#) と空
行は許可されます。

各 PFN には スタットコール 属性を持つレコード (要素) id 値に設定 ファイナル.
オプション ふん 属性は LFN stat'ed に設定されます。 ファイル名は
統計情報 内に記録します。

デフォルトはありません。

-i fn
このオプションにより、 ペガサスキックスタート アプリケーションの stdin を再接続します。
始まるよ。 XNUMX つのハイフンを使用して共有します stdin に提供されたもので
ペガサスキックスタート.

デフォルトは接続することです stdin 〜へ / dev / null.

-o fn
このオプションにより、 ペガサスキックスタート 再接続するには (Linuxで言うところのstdout） そのアプリケーションの
始まるよ。 このモードは、アプリケーションがその上で意味のある結果を生成するたびに使用されます。
(Linuxで言うところのstdout） Pegasus で追跡する必要があります。 本当の (Linuxで言うところのstdout） Globus ジョブのステージング
GASS (GT2) または RFT (GT4) 経由。 本当の (Linuxで言うところのstdout） 呼び出しを伝播するために使用されます
送信サイトに記録します。 アプリケーションの
(Linuxで言うところのstdout） に提供されるもので ペガサスキックスタート. その場合、出力は
from ペガサスキックスタート アプリケーション出力とインターリーブします。 このため、そのような
モードは推奨されません。

未キャプチャを提供するために (Linuxで言うところのstdout） 結果の一部として、デフォルトで
接続します (Linuxで言うところのstdout） アプリケーションの一時ファイルへの。 この内容は
一時ファイルは、ペイロード データとして転送されます。 ペガサスキックスタート 結果。
コンテンツのサイズはペイロード制限の対象となります。 -B オプション。 コンテンツが増えれば
大きい場合、最後の部分のみがペイロードの一部になります。 一時ファイルの場合
大きくなりすぎると、ワーカー ノードの一時スペースがあふれてしまう可能性があります。 一時ファイル
後に削除されます ペガサスキックスタート 終わります。

ファイル名の先頭に感嘆符が付いている場合、ファイルは次の形式で開かれます。
上書きモードではなく追加モード。 エスケープする必要がある場合があることに注意してください
シェルからの感嘆符。

デフォルトは接続することです (Linuxで言うところのstdout） 一時ファイルに保存されます。

-e fn
このオプションにより、 ペガサスキックスタート 再接続するには stderr そのアプリケーションの
始まるよ。 このオプションは、アプリケーションが意味のある結果を生成するたびに使用されます。
stderr ペガサスによる追跡が必要です。 本当の stderr Globus ジョブのステージング
GASS (GT2) または RFT (GT4)。 両方から異常な動作を伝播するために使用されます。
ペガサスキックスタート およびそれが起動するアプリケーションですが、その主な用途は
アプリケーション依存のデータとハートビートを伝達します。 XNUMX つのハイフンを使用して共有します
stderr stderr に提供されるもの ペガサスキックスタート. これが後進です
互換性のある動作。

未キャプチャを提供するために stderr 結果の一部として、デフォルトで
stderr アプリケーションのファイルが一時ファイルに接続されます。 その内容は
でペイロード データとして転送されます。 ペガサスキックスタート 結果。 大きすぎる場合は、
最後の部分はペイロードの一部になります。 一時ファイルが大きくなりすぎると、
ワーカー ノードの一時スペースがあふれてしまう可能性があります。 一時ファイルは削除されます
After ペガサスキックスタート 終わります。

ファイル名の先頭に感嘆符が付いている場合、ファイルは次の形式で開かれます。
上書きモードではなく追加モード。 エスケープする必要がある場合があることに注意してください
シェルからの感嘆符。

デフォルトは接続することです stderr 一時ファイルに保存されます。

-l ログン
指定したファイルにパフォーマンス データを追加できます。 したがって、複数の XML
ドキュメントは、XML プリアンブルを含め、同じファイルになる可能性があります。 (Linuxで言うところのstdout） is
通常、結果をストリーミングするために使用されます。 通常、これは GASS ステージ ストリームです。 使う
で出力を生成する単一のハイフン (Linuxで言うところのstdout） に提供されたもの
ペガサスキックスタート、デフォルトの動作。

デフォルトでは、提供された (Linuxで言うところのstdout）.

-w DIR
pegasus-kickstart が実行されると、新しい作業ディレクトリの明示的な設定が許可されます。
始めました。 これは、選択した作業がリモート スケジューリング環境で役立つ場合に役立ちます。
ディレクトリは、ジョブを送信するホストでは表示されません。 ディレクトリが存在しない場合は、
ペガサスキックスタート 失敗します。 このオプションは、 -W DIR オプションを選択します。

デフォルトでは、アプリケーションが開始された作業ディレクトリが使用されます。これは
通常、リモート スケジューリング環境によって設定されます。

-W DIR
新しい作業ディレクトリの明示的な作成と設定を一度許可する
pegasus-kickstart が起動します。 これは、リモート スケジューリング環境で役立ちます。
選択した作業ディレクトリは、ジョブを送信するホストでは表示されません。 もし
ディレクトリが存在しません。 ペガサスキックスタート それを作成しようとし、次に変更します
それに。 作成とディレクトリの変更の両方が失敗する場合があります。 このオプションは相互に
と排他的 -w DIR オプションを選択します。

デフォルトでは、アプリケーションが開始された作業ディレクトリが使用されます。これは
通常、リモート スケジューリング環境によって設定されます。

-X
何があっても、アプリケーションを実行可能にします。 これは、
の弱点 グロバスの URL コピー ソースの権限を
行き先。 したがって、実行可能ファイルが GridFTP を使用してステージインされている場合、間違った
パーミッション。 指定する -X フラグは、モードを変更して、
アプリケーションを実行可能にするために必要な x (および r) ビット。

デフォルトでは、アプリケーションのモードは変更されません。 この機能は、
指定されたパスで chmod を呼び出そうとするため、ハッカーによって悪用されます。

-B sz
出力に含める stdout および stderr データの量を変更します。 最後 sz
プロセスの stdout と stderr のバイトがキックスタートの出力にコピーされます。
他のすべてのデータは破棄されます。 特別な価値 を すべてをキャプチャするために使用できます
プロセスの stdout/stderr。 デフォルトは 256KB です。

-F
このフラグは、明示的な fsync（） キックスタート自身で呼び出す (Linuxで言うところのstdout） ファイルにソフトウェアを指定する必要があります。
通常、このフラグは必要ありません。 ただし、特定の共有ファイル システムの状況では、
呼び出しレコードを書き込んだ後にフラッシュを追加すると改善されます。

デフォルトでは、ロックと
ロック解除 (Linuxで言うところのstdout）.

-I fn
このモードでは、アプリケーション名とアプリケーションへの引数が指定されます
ファイルの中身 fn. このファイルには、XNUMX 行に XNUMX つの引数が含まれています。 グローバスからの脱出、
コンドルとシェルのメタ文字は必要ありません。 このモードでは、最大
基礎となるオペレーティング システムの可能なコマンド ラインの長さ (Linux の場合は 128k など)。
使い方 -I モードは、それ以降のコマンドライン処理を停止します ペガサスキックスタート
コマンドライン。

デフォルトでは、 アプリ フラグ アプリケーションが明示的に指定されているモード
コマンドライン。

-f
このフラグにより​​、キックスタートは、環境を含む完全な情報を出力します。
ジョブが実行されたリソース制限、および有用な補助統計呼び出し。 もし
ジョブが失敗し、その後 -f 暗示されています。

-t
このフラグにより​​、キックスタートは子プロセスのトレースをスキップし、
エレメント。 このフラグは、キックスタートが Linux 用にコンパイルされている場合にのみ存在します。

-q
このフラグにより​​、キックスタートはの一部いつ記録するか
ジョブは正常に終了します。 これは、出力ログのサイズを減らすように設計されています。
大規模なワークフロー。

アプリ
アプリケーションへのパスは完全に指定する必要があります。 アプリケーションは、
必須オプション。

アプリフラグ
アプリケーションには、追加のフラグがある場合とない場合があります。

リターン VALUE

ペガサスキックスタート メインジョブの戻り値を返します。 さらに、エラー
コード 127 は exec の呼び出しが失敗したことを示し、126 は stdio の再接続が失敗したことを示します。
同じ終了コードで失敗したジョブは、 ペガサスキックスタート
失敗

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