Job Arranger for Zabbix

ご連絡遅くなり申し訳ございません。

Loading CSS chunk 8897 failed
こちらが発生する既知事象はありますでしょうか。

また、HTTPのステータスが200で応答していても、レスポンス内容によりReact画面が白画面化する事例はありますでしょうか。

2. 閉域環境の既知事象
ケース#3782 で記載されている「リダイレクト前のAPI呼び出し」に関連し、閉域環境で発生する既知の制約事項等はありますでしょうか。

3. 白画面エラー
本事象と似たようなログイン直後にホーム画面が一瞬表示された後に白画面となる事例はありますでしょうか。

4. 本事象の解決方法

本事象を解決するための対処法をご教示いただきたいです。
また、追加で確認が必要な項目があれば、併せてご教示ください

■ 追加のご案内といたしまして
7.0.0から7.2.x へアップグレードする際には、データベーススキーマに構造的な変更が含まれているため、データベースの移行作業が必要となります。
詳細なデータベース移行手順につきましては、以下のリンクをご参照いただけますと幸いです。
https://www.jobarranger.info/jpn/jaz/6.manual/index.html?tgt=/0.upgrade/9987.ver_6.0.0-7.0.0-6.2.X,7.2.X.html

ご担当者様

いつもお世話になっております。
コミュニティサイトでは回答期限の指定はお受けできません。
期限の設定をご希望の場合は、有償サポートをご利用ください。

よろしくお願いいたします。

ご担当者様
いつもお世話になっております。

質問1～7への回答を以下に記載いたします。

質問①

 
mysql -u DBユーザ -p < MySQL_JA_CREATE_DATABASE.sql
は Job Arranger専用DB（jobarranger）作成用の手順であり、既存の zabbix DB（zabbix） を継続利用する構成では不要という理解でよろしいでしょうか。 

ご認識の通りです。

質問②

 
mysql -u DBユーザ -p zabbix < MySQL_JA_CREATE_TABLE.sql

mysql -u DBユーザ -p zabbix < JA_2_INSERT_TABLE.sql

obarranger DB ではなく既存の zabbix DB に対して実行する認識でよろしいでしょうか。 

ご認識の通りです。

質問③

 同一DB運用時のDB構成について認識確認をお願いいたします。下記の構成イメージに認識相違はございますでしょうか。

図に示されているデータベース構造は正しいものです。

質問④

ja_* table ⇒ ja_2_* table
テーブル移行（テーブル構造移行）と理解してよろしいでしょうか。

ご認識のとおりです。
同一の zabbix データベースを継続利用する場合、「データベース移行」とは、同一データベース内で Job Arranger のデータを ja_* テーブルから ja_2_* テーブルへ移行することを指します。

 それとも「データベース移行」という表現には別の意味がございますでしょうか。 

別の意味はございません。

質問⑤

 弊社環境の6.1.0⇒7.2.2へのアップグレードについても7.0.0を経由せずに直接アップグレードが可能という理解でよろしいでしょうか。 

ご認識のとおりです。

 アップグレードパスでは、以下を含む移行手順や確認事項に際はありますでしょうか。

移行手順と確認事項に差異はありません。

質問⑥

 「一定期間」とはどの程度を想定されていますでしょうか。（数日、1週間程度、月次運用確認後など） 

古いテーブルには、特に保持期間の制限はありません。アップグレード後、Job Arrangerが正しく機能していること（以前のジョブがエラーなく実行できること）を確認できたら、古いテーブルを安全に削除できます。

 「新しいJAZテーブルが正常に機能していること」の確認観点として、以下のような理解でよろしいでしょうか。
その他、推奨される確認項目がございましたらご教示ください 

ご認識のとおりです。 「ジョブ実行確認」とは、アップグレード後に既存のジョブが正常に実行できることを確認することを指すのであれば、ご提示いただいた確認項目で問題ありません。

 この古いテーブル保持期間の考え方は、Job Arranger 7.0.0 RPM を rpm -e にてアンインストールした後も必要な手順となるのでしょうか。

旧バージョンの Job Arranger RPM パッケージをアンインストールした後も、質問6-2の確認項目が完了するまでは、バックアップ目的で旧 ja_* テーブルを保持してください。確認完了後は、旧テーブルを削除して問題ありません。

質問⑦

 同一DB（zabbix）構成の場合、以下の作業順序で問題ないかご確認をお願いいたします。順序が異なる場合やその他必要な手順がございましたらご教示ください。

ご認識のとおりです。 同一の zabbix データベースを継続利用する構成の場合、ご提示いただいた作業手順の順序で問題ありません。

2点ご連絡いたします。

1点目として、JAZ 1 の設定ファイルと JAZ 2 の設定ファイルは完全に異なります。そのため、バックアップした設定ファイルをそのまま再利用することはできません。新しい RPM パッケージをインストール後、新しい設定ファイルが作成されますので、そちらを使用して必要な値を設定してください。

2点目として、手順⑫「動作確認」の前に Job Arranger サービスの再起動が必要です。

ご不明な点がございましたらお気軽にお問い合わせください。
何卒よろしくお願いいたします。

ご担当者様

お世話になっております。
お問い合わせいただいた件につきまして、以下の通り回答申し上げます。

質問⑧

7.2.2へのアップグレード後、
① jasender.sh
② jasender_monitor.sh
③ Job Monitor
は停止・削除して問題ないでしょうか。

・ジョブ異常終了
・ジョブ警告
・ジョブネット未投入
・ジョブネット未起動

については、7.2.2ではどのテンプレート、アイテム、トリガーへ置き換わるのかご教示ください。

その他の以下のステータスを監視する場合は、JobArranger Notification テンプレートと Job Arranger Notice Info アイテムをご利用ください。
・ジョブ異常終了
・ジョブ警告
Job Arranger Notice Info アイテムは、JobArranger Server のログメッセージ通知機能によって送信されたログメッセージを受信し、これらのジョブステータスを監視するためのアイテムです。
JobArranger Notification テンプレートの設定方法につきましては、以下のマニュアルをご参照ください。
https://www.jobarranger.info/jpn/jaz/6.manual/index.html?tgt=/7.2/1.Install/5.JobArrangerMonitoring/06.notification.html

JobArranger Notification テンプレートを使用して Zabbix に通知を送信するためには、以下のファイルにおいて、対象となるログメッセージの通知フラグを有効に設定する必要があります。

/etc/jobarranger/locale/server_logmessage_64BIT.txt

ジョブ異常終了 に該当するログメッセージは以下となります。

JAICONRESULTNORMAL000001,0,0, In %s(), job execution err. inner_job_id: %d status is RUNERR jobnet_id: %s, job_id: %s, user_name: %s, job_exit_cd: %s, icon_status: %d

ジョブ警告 につきましては、ジョブアイコン上に表示されるタイムアウト警告を指しているものと認識しております。そのため、ジョブタイムアウト警告に該当するログメッセージをご案内いたします。
なお、ジョブ警告 がタイムアウト警告とは異なる種類の警告を指している場合は、対象となる警告の詳細をご提供いただけますでしょうか。内容を確認のうえ、該当するログメッセージをご案内いたします。
ジョブ警告 に該当するログメッセージは以下となります。

JAICONRESULTTIMEOUT300001,3,0, In %s(), timeout occurrence. inner_job_id: %d, timeout: %s, start_time: %s, jobnet_id: %s, job_id: %s, user_name: %s

■ 注意事項

第2列には、ログレベルが設定されています。
（0 = INFO、1 = CRITICAL、2 = ERROR、3 = WARNING）
第3列には、ログメッセージを Zabbix へ送信するかどうかの設定が指定されています。
（0 = 無効、1 = 有効）

・Job Arranger Monitor の後継が「Job Arranger Server Jobnet Monitor」という認識でよいか

・従来の jasender.sh による通知とJobArranger Notification テンプレートとの関係

についても併せてご教示いただけますと幸いです。

質問⑨

「ターゲットDBがクリーンな初期状態」

とは、同一DB(zabbix)運用の場合、ja_2_* テーブルに対してジョブ実行やデータ登録が行われていない状態と理解してよろしいでしょうか。

既存の zabbix テーブルおよびja_* テーブルにデータが存在することは問題ない認識でよろしいでしょうか。

質問⑩

以下についてご教示いただけますでしょうか。

① MysqlDBRetryCodes の推奨設定値 ※一般的にどのようなパラメータを設定するのかがイメージつきませんでした

② 複数指定する場合の記載方法
　（カンマ区切り等）

③ 未設定の場合の動作

④ 新規インストール時のデフォルト設定値が存在する場合、その値をそのまま利用して問題ないか

⑤ 7.0.0 から 7.2.2 への移行時に新たに追加された必須パラメータのうち、特に設定内容を検討する必要がある項目があればご教示ください。

②について:
デフォルトの設定例のとおり、値はカンマ（,）区切りで複数指定することが可能です。

③について:
JobArranger Server 7.2.2 をインストールすると、JobArranger Server の設定ファイルには MysqlDBRetryCodes のデフォルト値があらかじめ設定されています。
MysqlDBRetryCodes のデフォルト値を削除し、パラメータが設定されていない場合、データベースとの接続が失われ、データベースからリトライ対象のエラーコードが返された場合でも、JobArranger Server はデータベースへの再接続を試行しません。
その結果、データベース接続エラーにより、ジョブまたはジョブネットが異常終了する場合があります。

④について:
新規インストールの場合は、デフォルト設定のままご利用いただくことが可能です。

⑤について:
JobArranger 7.0.0 から 7.2.2 への移行時に新たに追加された必須パラメータの一覧はございません。
そのため、JobArranger Server の設定項目について、7.0.0 と 7.2.2 の設定内容を比較していただき、以下のドキュメントをご参照のうえ、新たに必要となる設定を反映していただくことを推奨いたします。

JobArranger Server 7.0.0 設定
https://www.jobarranger.info/jpn/jaz/6.manual/index.html?tgt=/7.0/1.Install/1.JobArrangerServer/04.Configuration.html

JobArranger Server 7.2.2 設定
https://www.jobarranger.info/jpn/jaz/6.manual/index.html?tgt=/7.2/1.Install/1.JobArrangerServer/04.Configuration.html

ご不明な点がございましたら、お気軽にお問い合わせください。
何卒よろしくお願いいたします。

ご担当者様

度々申し訳ございません。

本日検証用のサーバで7.2.2へのアップグレード検証を行いました。
RPMインストール、DBマイグレーション（migrate.php）、JobArranger Server起動までは成功しておりますが、Jobmanagerからのジョブ実行およびマイグレーション結果確認についていくつか確認させてください。

※各種設定ファイルの情報も連携いたします

===
質問⑪ MySQLライブラリについて
JobManagerからジョブを実行すると、ジョブが起動されず画面上で処理中のままとなります。

Job Serverログには以下のエラーが繰り返し出力されています。

Database connect failed, retrying..

plugin.Open("/usr/local/bin/jobarranger/mysql_database.so"):
libmysqlclient.so.24:
cannot open shared object file:
No such file or directory

調査のため以下を確認しました。

・JobArranger同梱ライブラリ

/usr/local/bin/jobarranger/mysql_database.so
/usr/local/bin/jobarranger/mysql_database_v21.1.26.so

・mysql_database.so

readelf -d /usr/local/bin/jobarranger/mysql_database.so | grep NEEDED

⇒結果、libmysqlclient.so.24と表示

・RHEL8標準のmysql-libs

repoquery -l mysql-libs | grep libmysqlclient

結果：/usr/lib64/mysql/libmysqlclient.so.21

RHEL8.6(8.0.30)、RHEL8.10(8.0.45/8.0.46) の mysql-libs を確認しましたが、いずれも libmysqlclient.so.21 を提供しておりました。

＜確認事項＞
・JobArranger 7.2.2 を RHEL8標準MySQL環境で利用する場合、「mysql_database_v21.1.26.so」を使用する想定でしょうか

・システム要件に記載のmysql8.0-libs*rpmまたはmysql-libs*rpmについて、今回の環境で導入すべき推奨RPM名をご教示ください
システム要件を見落としており、現状どちらのライブラリも導入されていません。
検証環境からダウンロードがすぐに可能なmysql-libs*rpmに関して、上記の通り確認したかたちとなります。

・JobArranger 7.2.2 が想定するlibmysqlclient.so.24を提供するRPMがある場合、そのRPM名をご教示ください。

===
・質問⑫　マイグレーション結果について

php migrate.php実行時は、「All migrations finished successfully.」と表示されエラーなく完了しました。

また、php migrate_compare.phpも特にエラーメッセージが出ることなく完了していますが、出力されたCSVでは以下が確認されました。
※csvファイルを添付いたします。

ja_run_log_table　→　ja_2_run_log_table

ROW_MISSING

実際の件数は以下です。

SELECT COUNT(*) FROM ja_run_log_table;
→ 30件

SELECT COUNT(*) FROM ja_2_run_log_table;
→ 0件

また、migrate.php のログには、ja_run_log_table　→　ja_2_run_log_tableの移行処理自体が出力されておりませんでした。
さらに、移行前は ja_* テーブルが約63テーブル存在していましたが、移行後に作成された ja_2_* テーブルは57テーブルでした。

＜確認事項＞
・ja_run_log_table は移行対象外の仕様でしょうか。

・migrate_compare で ROW_MISSING が出力されることは想定される動作でしょうか。

・ja_* テーブル数と ja_2_* テーブル数が一致しないのは、テーブル統合等による仕様でしょうか。

・上記状態のままアップグレード後の運用を継続して問題ないでしょうか。

===

昨日から追加で質問が重なってしまい、申し訳ありません。
大変恐縮ですが、ご教示いただけますと幸いです。

何卒よろしくお願いいたします。

ご担当者様

いつもお世話になっております。
#note-17の内容につきましては、後ほど回答いたします。

⇒こちら言葉が足りておらず申し訳ありません。
　設定ファイルやjobarg-monitorサービスのことを指しており、総じて「Job Monitor」と表現していました。

Jobarrangerの監視について、認識齟齬無いかどうかもう少し確認させてください。

・「ジョブネット未投入」
・「ジョブネット未起動」
こちらについては、従来のJob Monitor＋jasender_monitor.sh
による監視から、Job Arranger Server Jobnet Monitorへ置き換わる旨理解しました。

一方で、

・「ジョブ異常終了」
・「ジョブ警告」
につきましては、従来の jasender.sh が廃止されたものの、

Job Arranger Manager の「全般設定 → Zabbix通知設定」に通知機能が統合されていることから、

従来同様に zabbix_sender を利用した通知運用を継続可能であり、必ずしも JobArranger Notification テンプレートへ移行する必要はない、という理解でよろしいでしょうか。

そのため、

・Jobnet未投入／未起動
　→ Job Arranger Server Jobnet Monitorへ移行

・ジョブ異常終了／警告
　→ 従来同様に通知機能を利用
※こちらで作成していた通知機能用の監視アイテムをそのまま使用する想定

という構成を想定しております。

認識に問題がないかご確認をお願いいたします。

「server_logmessage_64BIT.txt」ファイルに対して、通知フラグを有効に設定する必要があるのは、JobArranger Notification テンプレートを使用して Zabbix に通知を送信する場合のみといった理解でよろしいでしょうか。

・ジョブ異常終了／警告
　→ 従来同様に通知機能を利用
従来同様に通知機能を利用していく場合だとしても、通知フラグを有効にする必要があるかどうかが気になりました。
※現状、通知フラグを有効にして運用しているかが、不明のため

恐れ入りますが、「ジョブ警告」とは #note-13 に記載されている タイムアウト警告 を指しておりますでしょうか。
ご確認いただけますと幸いです。

■ 注記
既存のトリガーをご利用の場合は、新しいメッセージ形式に適切に対応できるよう、トリガーの条件式についてご確認いただき、必要に応じて見直しや修正をご検討ください。

ご不明な点がございましたらお気軽にお問い合わせください。
何卒よろしくお願いいたします。