Houdini 20.0 HQueue

ジョブの管理

ファーム上のジョブを閲覧/管理する方法。

On this page

How to

ウェブブラウザからHQueueサーバー(http://hostname:5000/)に接続します。 ウェブインターフェースの右上コーナーにある Jobsアイコンをクリックして、Jobsページに進みます。

To...Do this

Houdiniからジョブを投入する

ジョブを投入する方法を参照してください。

XML/RPC APIを使ってジョブを投入する

このAPIを使えば、実行中のジョブに関する情報を照会したり、ジョブを管理するだけでなく、ジョブを作成することもできます。 詳細は、APIドキュメントを参照してください。

子ジョブを含むジョブの詳細を確認する

ジョブテーブル内のJob IDをクリックします。

失敗、放棄、キャンセルされたジョブのスケジュールを組み直す

Completed Jobs テーブル下にある Reschedule Failed Jobs をクリックします。

ジョブを停止、キャンセル、スケジュールを変更する

ジョブの“スケジュールを変更”すると、スケジュールキューに戻され、そこで利用可能なクライアントマシンを待ちます。ジョブのスケジュールを変更すると、親のジョブと失敗した子ジョブのスケジュールも変更します。

  1. Jobsページで、そのリストからスケジュールを変更したいジョブを探します。そのジョブの行の頭にあるチェックボックスにチェックを付けます。

    (複数のチェックボックスにチェックを付けることで、一度に複数のジョブに影響を与えることができます。)

  2. Completed Jobs テーブル下にある Reschedule ボタンをクリックします。

ジョブを停止または再開する

  1. Jobsページで、そのリストから停止したいジョブを探します。そのジョブの行の頭にあるチェックボックスにチェックを付けます。

    (複数のチェックボックスにチェックを付けることで、一度に複数のジョブを停止することができます。)

  2. Running Jobs テーブル下にある Pause ボタンをクリックします。

ジョブを停止すると、割り当てたクライアントマシンでジョブが停止します。 ジョブはスケジュールキューに残り、そこでユーザがジョブを再開またはキャンセルするのを待ちます。ジョブを停止すると、その子ジョブも停止されます。

停止したジョブを再開するには、その停止したジョブの隣にあるチェックボックスにチェックを付けてから、ジョブテーブル下にある Resume ボタンをクリックします。

ジョブをキャンセルする

  1. Jobsページで、そのリストからキャンセルしたいジョブを探します。そのジョブの行の頭にあるチェックボックスにチェックを付けます。

    (複数のチェックボックスにチェックを付けることで、一度に複数のジョブをキャンセルすることができます。)

  2. Running Jobs テーブル下にある Cancel ボタンをクリックします。

失敗、放棄、キャンセルされたジョブを削除する

ジョブテーブル下にある Delete Failed Jobs をクリックします。

任意のジョブを削除する

ジョブを削除すると、システムから 永久に削除 されます。 ジョブを削除すると、その子ジョブも削除されます。 まだ完了していないジョブを削除することはできません。

  1. Jobsページで、そのリストから削除したいジョブを探します。そのジョブの行の頭にあるチェックボックスにチェックを付けます。

    (複数のチェックボックスにチェックを付けることで、一度に複数のジョブを削除することができます。)

  2. Completed Jobs テーブル下にある Delete ボタンをクリックします。

ジョブテーブル

  • Jobsページの上部では、“Active”なジョブと“Running”のジョブがリストされます。“Active”なジョブは、実行中のジョブとその子ジョブを含みます。“Running”のジョブは、単なる子ジョブのラッパーでどのクライアントでも実行されないトップレベルのジョブを含みません。

  • ジョブは、Running JobsとCompleted Jobsの別々のテーブルで分類されます。

項目

説明

checkboxes

ジョブを選択することができます。 リストの下部にあるボタンを使って、選択したジョブ(s)にアクションを適用することができます。

Job Id

ジョブの固有ID。IDをクリックするとジョブの詳細が表示されます。

Name

ジョブの名前と説明。

Submitted By

ジョブを投入したユーザアカウント。

Priority

ジョブの優先度。高い優先度のジョブが低い優先度のジョブよりも先にクライアントに割り当てられます。0が一番低い優先度です。

Status

ジョブの状況。ジョブの状況を参照してください。

Progress

ジョブの進捗状況をパーセンテージで表示します。

Tasks

子ジョブの状況。この項目の1番目の数値は終了した子ジョブの数を表示し、2番目の数値は合計の子ジョブの数を表示します。失敗/キャンセル/中断した子ジョブがあれば、この項目の最後に“n failed”とメッセージを追加します。このnは失敗した子ジョブの数です。

Time

実行中のジョブの経過時間と完了したジョブの完了に費やした時間を表示します。

Elapsed time: 実行中のジョブの経過時間。

Time to Complete: ジョブの完了に費やした時間。

ETA

ジョブが完了するまでの残りの推定時間。

Submission Time

ジョブがファームに投入された時の時刻。

note icons

ジョブにノートが添付されているかどうか示します。

ノートが存在します。アイコンにマウスカーソルを当てるとノートが表示されます。アイコンをクリックするとノートがフルスレッドで表示されます。

ノートがありません。アイコンをクリックすればノートを添付することができます。

ジョブの詳細

ジョブテーブル内のJob IDをクリックすると、そのジョブの詳細が表示されます。

  • トップレベルのジョブページと同様に、ジョブテーブルインターフェースを使って子ジョブを管理することができます。

  • (Job Detailsヘッダの右側にある) Grid View リンクをクリックすると、その子ジョブテーブルがコンパクトビューに切り替わり、すべての子ジョブの状況と実行時間が表示されます。

    Table View をクリックすると、デフォルトのビューに戻ります。

フィールド

説明

Name

ジョブの名前と説明。

Submitted By

ジョブを投入したユーザアカウント。

Id

ジョブの固有ID。

Parent Job(s)

このジョブに依存しているジョブ。親のジョブのIDをクリックすると、その詳細が表示されます。ジョブに親がなければ、このフィールドは非表示になります。

Clients

ジョブを処理するために割り当てたクライアント。ジョブに割り当てたクライアントがなければ、このフィールドは非表示になります。

Status

ジョブの状況。ジョブの状況を参照してください。

Overall Progress

このジョブとその子ジョブの進捗状況をパーセンテージで表示します。

ETA

ジョブが完了するまでの残りの推定時間。

Properties

View リンクをクリックすると、そのジョブのプロパティのリストが表示されます。

Status Log

View リンクをクリックすると、状況の変化のログが表示されます。状況の変化がなければ、このフィールドは非表示になります。

Cleanup

ジョブが成功しても失敗しても関係なく、ジョブが終了した後に実行するスクリプト。ジョブに割り当てたスクリプトがなければ、このフィールドは非表示になります。

Command

ジョブがクライアントマシンに割り当てられた時に実行するコマンド。 ジョブにコマンドがない場合、または、ジョブにプラットフォーム固有の複数のコマンドセットが含まれている場合、このフィールドは非表示になります。

Output Log

ジョブのコマンドセットの実行で組み合わせたSTDOUTとSTDERRの出力。 ジョブにコマンドがなければ、このフィールドは非表示になります。

Download Output Log

クリックすると、ジョブの全出力ログをダウンロードすることができます。ジョブにコマンドがなければ、このボタンは非表示になります。

Download Diagnostics Information

クリックすると、ジョブの全診断結果の詳細をダウンロードすることができます。これは、失敗したジョブのデバッグに役立ちます。

ジョブのプロパティ

Job DetailsページのPropertiesの隣にある View リンクをクリックすると、それらのプロパティが表示されます。

詳細は、ジョブのプロパティを参照してください。

プロパティ

説明

Description

ジョブに付け足すオプションの説明。

Tries left

ジョブが失敗した場合のそのジョブの残りの試行回数。 この値が0より大きい場合、ジョブが失敗した後にHQueueは残りの試行回数を1つ減らして、自動的にそのジョブのスケジュールを組み直します。

Priority

ジョブの優先度。 優先度の高いジョブは、優先度の低いジョブよりも先にクライアントに割り当てられます。0が最も低い優先度です。

Min Hosts

ジョブの実行に必要なホストの最小数。

Max Hosts

ジョブの実行を許可するホストの最大数。

Tags

ジョブに付け足すオプションのタグ。 詳細は、ジョブのタグを参照してください。

Queue time

ジョブがサーバーキューに追加された時刻。

Runnable time

ジョブがクライアントマシンに割り当て可能になった時の時刻。

Command start time

ジョブがコマンドセットの実行を開始した時刻。ジョブにコマンドがなければ、このフィールドは空っぽになります。

Command end time

ジョブがコマンドセットの実行を終了した時刻。ジョブにコマンドがなければ、このフィールドは空っぽになります。

Start time

ジョブが割り当てられたクライアントマシンでジョブの実行を開始した時刻。

End time

ジョブが終了した時刻。

Time to complete

ジョブが完了した時間。

Time in queue

ジョブがクライアントマシンで実行を開始する前に費やした待ち時間。ジョブが開始していなければ、このフィールドは非表示になります。

Time to run command

ジョブが実行を終了するのに費やした時間。ジョブが終了していなければ、このフィールドは非表示になります。

Requirements

ある条件に相当する一行おきのクライアント条件のセット。クライアントマシンが、そのジョブを処理できるようになるには、その条件に一致しなければなりません。 詳細は、ジョブの条件を参照してください。 ジョブに条件がなければ、このフィールドは非表示になります。

Resources

ジョブを実行する前にそのジョブで必須となるグローバルファームリソースセット。 詳細は、リソースを参照してください。

Environment

クライアントの環境変数のセット。環境変数が設定されていなければ、このフィールドは非表示になります。

HQueue

はじめよう

  • HQueueについて

    HQueueは多目的なジョブスケジューリングシステムです。このシステムを利用することで、レンダリング、シミュレーション、他の処理をリモートクライアント上に分散させることができます。

  • インストール

    基本的なHQueueファームのセットアップ方法。

  • 設定

    HQueueサーバーとクライアントのオプションを設定する方法。

  • ジョブを投入する方法

    ファーム上にワークを配置する方法。

ファームの管理

  • ジョブの管理

    ファーム上のジョブを閲覧/管理する方法。

  • クライアントの管理

    ウェブインターフェースまたはローカルログインを使って、クライアントマシンを追加/削除/再起動/管理する方法。

  • クライアントグループの管理

    ウェブインターフェースまたはローカルログインを使って、クライアントマシンのグループを作成/管理する方法。

  • ネットワークフォルダ

    Network Folder管理ページの使い方。

  • リソース

    各クライアントで利用可能なリソース(例えば、ライセンス)を指定することができるので、そのジョブを実行可能なクライアントに対してそのジョブのスケジュールを組むことができます。

  • ノート

    各クライアントとジョブには、情報を記載したノートを添付することができます。

次のステップ

  • ログ

    HQueueサーバーはサーバーエラーとスケジュールイベントのログを別々に記録し、各クライアントもログを生成します。

  • アンインストールする方法

    HQueueサーバーまたはクライアントのソフトウェアをアンインストールする方法。

  • FAQs

    よくある質問の回答。

導師レベル

  • Remote API

    ネットワーク上のHQueueサーバーに接続して関数をコールすることで、ジョブや他の情報を制御したり照会することができます。

  • ジョブの仕様の詳細

    独自のジョブを投入したいユーザ向けに、ジョブの内部仕様に関する詳細を載せています。

  • 複数クライアント、単一マシン

    単一マシン上で複数のHQueueクライアントを走らせる方法を説明したガイド。