【HinemosWorld2014】B2-3_Hinemos徹底解剖～ジョブ編～

Copyright © 2014 NTT DATA Corporation
Hinemos徹底解剖～ジョブ編～
2014年12月5日
株式会社ＮＴＴデータ基盤システム事業本部
眞野将徳

ＩＮＤＥＸ
1. はじめに
2. ジョブ実行の流れ
3. 応用編1: 影響が出ない再起動のタイミングは？
4. 応用編2: ジョブトラブルシューティング
5. まとめ
Copyright © 2014 NTT DATA Corporation 2

はじめに

はじめに
 本セッションではHinemos4.1におけるジョブ実行時の制御にフォーカスして、
Hinemosの内部動作をご説明します。
• ジョブ実行時の通信の流れ
• Hinemosマネージャ、Hinemosエージェントで行われる処理
 応用としてジョブ運用時のよくある疑問を解決します。
• ジョブ実行に影響を与えない再起動タイミング
• ジョブでよくあるトラブルと解決方法

ジョブ実行の流れ

ジョブ実行時の通信
ジョブの実行時には以下の順序でマネージャ・エージェント間で通信が行われます。
マネージャエージェント
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ開始
②起動指示
① : ジョブが開始し、ジョブセッションを作成
② : エージェントへのジョブ起動指示を作成
③ : ジョブ起動指示の取得
④ : コマンド開始を送信
⑤ : 起動指示に基づくコマンドの実行
⑥ : ジョブ実行結果の送信
⑤コマンド実行
では、順番に詳細をみていきましょう

① : ジョブが起動し、ジョブセッションを作成
• ジョブが起動(クライアントで実行ボタン押下、スケジュール等)すると、
ジョブセッションが作成されます。
• ジョブセッション作成時には、登録されているジョブ定義から、実行するジョブの
情報のコピーを作成し、マネージャの内部DBに蓄積されます。
• つまり、ジョブ実行後(ジョブセッション作成後)に、ジョブの設定を変更しても、
実行中のジョブの動作(実行するコマンド等)には影響を与えません。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
内部DB
登録されているジョブ定義コピー
登録
ジョブ実行時の情報

②エージェントへのジョブ起動指示を配置
• 内部DBから、実行中のジョブセッションの情報を取得して、エージェントに対する
ジョブ起動指示を作成します。
• この時点では、まだエージェントではジョブを実行していません。
• ジョブ[ノード詳細]ビューのメッセージに「エージェント応答待ち」と表示されます。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
開始・再実行日時が
空欄
メッセージが
エージェント応答待ち

③ : 起動指示の取得
• エージェントは以下のタイミングでマネージャに接続し、自身に対するジョブ起動
指示が存在しないかチェックします。
• 一定間隔(デフォルト30秒)
• 即時反映用ポート(デフォルトUDP24005)にパケットを受信した場合
• 起動指示作成時に、マネージャはエージェントの即時反映用ポートにパケットを
送信するので、すぐその情報を取得できます。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
UDP24005
定期的に
情報取得
すぐに情報取得

④ : コマンド開始を送信
• エージェントは、ジョブ起動指示を受信すると、実行前にマネージャと通信し、
ジョブを開始することを連絡します。
• マネージャはその時刻をもとに、ジョブ[ノード詳細]ビューの開始日時を設定、
メッセージを「エージェント応答待ち」から「コマンド終了待ち」に変更します。
• この通信が成功すると、エージェントでコマンドの実行が開始されます。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
開始・再実行日時が
設定される
メッセージが
コマンド終了待ち

⑤ : 起動指示に基づくコマンドの実行
• 起動指示に含まれるコマンドをエージェントが実行します。
• 実行したコマンドはエージェントの子プロセスとして実行されます。コマンド
実行中にエージェントを再起動すると、コマンドの終了を検知できなくなるので、
再起動は避けてください。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
コマンド
再起動

⑥ : ジョブ実行結果の送信
• 実行したコマンドが終了すると、エージェントはコマンド実行結果(戻り値、標準
出力、標準エラー出力)をマネージャに送信します。
• マネージャは、その時刻をもとに、ジョブ[ノード詳細]の終了日時を設定し、メッ
セージにコマンドの標準出力と標準エラー出力を表示させます。
• 以上でジョブの処理は終了です。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
終了・中断日時が
設定される
メッセージが
コマンドの標準出力
実行状態が終了
戻り値が設定される

Hinemosエージェントでジョブが実行されない場合は？
• エージェントの停止等で、ジョブが開始されない場合はどのような動作になるで
しょうか
• マネージャは毎分エージェントへの起動指示を行い、デフォルトでは10回起動指
示をおこなっても、ジョブが開始されない(④の通信がない)場合に、タイムアウ
トエラーで終了します。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
エージェント
停止
メッセージが
Agent Timeout Error

HinemosエージェントからHinemosマネージャに接続できない場合は？
• エージェントからマネージャの通信ができない場合にはどのような動作になるで
しょうか。
• エージェントは、通信のリトライ機構を有しており、ジョブの場合、デフォルトで
7日間リトライを繰り返し、7日間たってもマネージャとの接続が復旧しない場合
には、ジョブ実行結果を破棄します。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
7日間マネージャに
再接続できない
・・・
ジョブ結果を
破棄
マネージャ
停止

応用編1: 影響が出ない再起動のタイミングは？

影響が出ない再起動のタイミングは？
• メンテナンスなどで運用中にHinemosマネージャ、Hinemosエージェントの再起動
が必要な場合があるかと思います。
• いつ再起動すればジョブ実行に影響を与えずに再起動できるのでしょうか
• ジョブの処理の流れを振り返って確認してみましょう

• Hinemosマネージャ
• ジョブ起動が完了したジョブは、いつマネージャを再起動しても実行に影響は
ありません。
• 起動済みのマネージャ側のジョブの情報は、内部DBに保持されているため、
再起動しても失われません。
• マネージャの停止中、エージェントが接続できなくても、通信のリトライ機構により、
7日間以内にマネージャが復旧すれば、ジョブの実行結果は失われません。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
いつ再起動しても
問題なし！！

• Hinemosエージェント
• エージェントでコマンド実行中は再起動は避けてください。
• コマンド実行中にエージェントを再起動すると、コマンドが終了しても実行結果がマ
ネージャに送られず、ジョブの実行状態が「終了」に遷移しません。
• もしコマンド実行中に再起動してしまったら、ジョブ[ノード詳細]の該当の履歴を右クリック
して「停止」を選び、手動で終了させる必要があります。
③情報取得
④ジョブ開始
⑥ジョブ終了
①ジョブ起動
②起動指示
このタイミングの
再起動はNG

(補足) Hinemosマネージャ停止中に過ぎたスケジュールの動作は？
• マネージャ停止中に、実行予定だったスケジュールは、実行予定時刻からの経
過時間が閾値以内の場合、マネージャ起動直後に実行されます。
• デフォルトでは1時間以内の場合
• つまり、短時間内での再起動であれば、スケジュールの実行漏れは発生しません。
Hinemosマネージャ停止中
• スケジュールBはマネージャ
起動直後に実行される
• スケジュールAは実行されない
時刻
スケジュール
1時間
スケジュール
A
B
スケジュール
B
マネージャ起動

応用編2: ジョブトラブルシューティング

ジョブがなかなか終了しない！
• ジョブ[ノード詳細]ビューのメッセージを確認しましょう。
• 「エージェント応答待ち」or 「コマンド終了待ち」
• エージェントが接続しないのでコマンドが実行されないのか、コマンドの実行に時
間がかかっているのか原因を切り分けることができます
• マネージャに接続しているエージェントは、リポジトリ[エージェント]ビューでも
チェックできます。
マネージャに接続している
エージェントの一覧と
起動時刻・最終接続時刻がわかる

エージェントでのジョブ起動開始が少し遅れる(1/2)
• エージェントでコマンドが実行されるのが遅れる場合、エージェントの即時反映用
ポートにパケットが届いていない可能性があります。
• 定期的な情報取得で、起動指示を取得するため動作には問題ありません。
• ファイアウォールでパケットを遮断していないか、ポート設定に誤りがないか確認
しましょう。

エージェントでのジョブ起動開始が少し遅れる(2/2)
• 即時反映用ポートは、リポジトリと設定ファイル(Agent.properties)で設定します。
…
…
awake.port = 24005
…
…
リポジトリ設定Agent.properties

まとめ

まとめ
 本セッションでは以下についてご紹介しました。
• Hinemosにおけるジョブ実行時の制御
• ジョブ実行中にHinemosマネージャ、Hinemosエージェントを再起動した際の挙動
• ジョブでよくあるトラブルと解決方法
 ぜひ運用の際に役立てて頂けますと幸いです。

【HinemosWorld2014】B2-3_Hinemos徹底解剖～ジョブ編～

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Viewers also liked

Viewers also liked (20)

Similar to 【HinemosWorld2014】B2-3_Hinemos徹底解剖～ジョブ編～

Similar to 【HinemosWorld2014】B2-3_Hinemos徹底解剖～ジョブ編～ (20)

More from Hinemos

More from Hinemos (20)

Recently uploaded

Recently uploaded (8)

【HinemosWorld2014】B2-3_Hinemos徹底解剖～ジョブ編～