14.4.2 障害監視の設定
ここでは,JP1/IMの統合コンソールまたは統合スコープから,Cosminexusシステムで発生した障害を監視するための設定について説明します。
まず,次の表に示すサーバおよびクライアントに,障害監視に必要なJP1の製品またはCosminexusの製品の構成ソフトウェアをインストール,セットアップしておいてください。なお,JP1/IMと連携する場合のシステム構成については,「14.3.1 システムの集中監視に必要なプログラム」を参照してください。
表14-6 障害監視に必要な製品または構成ソフトウェア
サーバ/クライアント | 製品/構成ソフトウェア |
---|
J2EEサーバ | - Cosminexus Component Container
- JP1/Base
|
Cosminexusの運用管理サーバ | |
JP1統合運用管理サーバ | |
運用管理クライアント | |
障害監視の設定手順を次に示します。
- Cosminexusの運用管理サーバで,次の作業を実施します。
- CosminexusのJP1イベント発行の設定((1)参照)
- JP1/Baseのイベントサーバ名の設定((2)参照)
- J2EEサーバで,次の作業を実施します。
- JP1/Baseのイベントサーバ名の設定((2)参照)
- JP1統合運用管理サーバで,次の作業を実施します。
- <この項の構成>
- (1) CosminexusのJP1イベント発行の設定
- (2) JP1/Baseのイベントサーバ名の設定
- (3) JP1/Baseの構成定義の作成
(1) CosminexusのJP1イベント発行の設定
Cosminexusシステムで発生するエラーやインフォメーション情報のうち,どのようなエラーやインフォメーション情報をJP1イベントとして発行するかを設定します。
- Management Server用JP1イベントの設定
- J2EEサーバ用JP1イベントの設定
- J2EEユーザ用JP1イベントの設定
それぞれの設定方法について説明します。また,ユーザJP1イベントの推奨設定についても説明します。簡易構築定義ファイルについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6 簡易構築定義ファイル」を参照してください。なお,SFOサーバでもシステムJP1イベントを発行できます。SFOサーバでシステムJP1イベントを発行させる場合の設定は,J2EEサーバでの設定と同じです。「(b) J2EEサーバ用JP1イベントの設定」の「J2EEサーバ」を「SFOサーバ」と読み替えてください。
(a) Management Server用JP1イベントの設定
Management Server用JP1イベントの設定手順を次に示します。
- システムJP1イベント発行の設定をします。
mserver.propertiesで,com.cosminexus.mngsvr.jp1event.enabledキーで,Management Serverが検知した障害や通知をJP1イベントとして発行するかどうかを指定します。また,JP1イベントの重大度ごとに,JP1イベントを発行するかどうかを指定します。mserver.propertiesについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.7 mserver.properties(Management Server環境設定ファイル)」を参照してください。
- メッセージマッピングファイルを設定します。
Management Serverが検知した障害や通知を,メッセージマッピングファイルで,メッセージごとにどの重大度のJP1イベントに変換するかを定義します。なお,マッピング定義がなくJP1イベントの重大度を割り当てられないメッセージは,JP1イベントとして発行されません。
ファイル名は「mserver.jp1event.system.mapping.properties」です。マッピング関係を定めた標準的なファイルを提供しているので,必要に応じて,テキストエディタなどで編集してください。ファイルの格納場所を次に示します。
- Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config
- UNIXの場合
/opt/Cosminexus/manager/config
Management Server用メッセージマッピングファイルについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.19.1 mserver.jp1event.system.mapping.properties(Management Server用メッセージマッピングファイル)」を参照してください。
- Management Serverを再起動します。
再起動後に,設定した情報が有効になります。
(b) J2EEサーバ用JP1イベントの設定
J2EEサーバ用JP1イベントの設定手順を次に示します。
- システムJP1イベント発行の設定をします。
簡易構築定義ファイルの論理J2EEサーバ(j2ee-server)または論理SFOサーバ(sfo-server)の<configuration>タグ内に,ejbserver.manager.agent.JP1EventAgent.enabledパラメタで「true」を指定します。デフォルトでは,「false」が指定されています。また,簡易構築定義ファイルの論理J2EEサーバ(j2ee-server)または論理SFOサーバ(sfo-server)の<configuration>タグ内に,次のパラメタでJP1イベントの重大度ごとに,JP1イベントを発行するかどうかを指定します。
- manager.jp1event.system.filtering.severity.emergency
- manager.jp1event.system.filtering.severity.alert
- manager.jp1event.system.filtering.severity.critical
- manager.jp1event.system.filtering.severity.error
- manager.jp1event.system.filtering.severity.warning
- manager.jp1event.system.filtering.severity.notice
- manager.jp1event.system.filtering.severity.information
- Management Serverおよび運用管理エージェントを再起動します。
再起動後に,設定した情報が有効になります。
- メッセージマッピングファイルを設定します。
J2EEサーバが検知した障害や通知を,メッセージマッピングファイルで,メッセージごとにどの重大度のJP1イベントに変換するかを定義します。なお,マッピング定義がなくJP1イベントの重大度を割り当てられないメッセージは,JP1イベントとして発行されません。メッセージマッピングファイルには,J2EEサーバ共通用とJ2EEサーバ個別用があります。
- J2EEサーバ共通用メッセージマッピングファイル
- マシン内のJ2EEサーバ共通用で,J2EEサーバが検知した障害や通知をJP1イベントに変換するときに使用するファイルです。ファイル名は「manager.jp1event.system.mapping.properties」です。マッピング関係を定めた標準的なファイルを提供しているので,必要に応じて,テキストエディタなどで編集してください。ファイルの格納場所を次に示します。
- Windowsの場合
- <Cosminexusのインストールディレクトリ>¥manager¥config
- UNIXの場合
- /opt/Cosminexus/manager/config
- J2EEサーバ個別用メッセージマッピングファイル
- J2EEサーバごとに,J2EEサーバが検知した障害や通知をJP1イベントに変換したいときに使用するファイルです。このファイルとJ2EEサーバ共通用メッセージマッピングファイルが作成されている場合は,このファイルでの指定が優先されます。
- ファイル名は「manager.<論理サーバ名>.jp1event.system.mapping.properties」です。このファイルは,テキストエディタなどを使用してユーザが作成してください。パラメタの記述形式は,J2EEサーバ共通用メッセージマッピングファイルと同じです。
メッセージマッピングファイルについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.19 JP1/IM連携用システムログメッセージマッピングファイル」を参照してください。
- J2EEサーバを再起動します。
再起動後に,設定した情報が有効になります。
(c) J2EEユーザ用JP1イベントの設定
J2EEユーザ用JP1イベントの設定手順を次に示します。
- ユーザJP1イベント発行の設定をします。
簡易構築定義ファイルの論理J2EEサーバ(j2ee-server)の<configuration>タグ内に,次のパラメタでJ2EEアプリケーションのユーザログをJP1イベントとして発行するかどうかを指定します。マッピングの設定で,ユーザログのログレベルにJP1イベントの重大度を割り当てたログがJP1イベントの発行対象になります。
- manager.jp1event.user.mapping.level.severe
- manager.jp1event.user.mapping.level.warning
- manager.jp1event.user.mapping.level.info
- manager.jp1event.user.mapping.level.config
- manager.jp1event.user.mapping.level.fine
- manager.jp1event.user.mapping.level.finer
- manager.jp1event.user.mapping.level.finest
また,出力するユーザログをメッセージIDなどでフィルタリングできます。フィルタリングは,簡易構築定義ファイルの論理J2EEサーバ(j2ee-server)の<configuration>タグ内に,次のパラメタで指定します。
- manager.jp1event.user.filtering.enabled
- manager.jp1event.user.filtering.filter
なお,ユーザJP1イベントの推奨設定については,「(d) ユーザJP1イベントの推奨設定」を参照してください。
- ロガーおよびハンドラを設定します。
簡易構築定義ファイルの論理J2EEサーバ(j2ee-server)の<configuration>タグ内に,次のパラメタでJ2EEアプリケーションのユーザログで使用するロガーおよびハンドラを指定します。ハンドラにはJP1イベント用のハンドラ(com.cosminexus.mngsvr.externals.jp1event.JP1EventHandler)を指定してください。
- ejbserver.application.userlog.loggers
- ejbserver.application.userlog.Logger.<ロガー名称>.level
- ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers
- ejbserver.application.userlog.Logger.<ロガー名称>.filter
- ejbserver.application.userlog.menu.handlers.
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter
- ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding
- ejbserver.application.userlog.Logger.<ロガー名称>.handlers
- Management Serverおよび運用管理エージェントを再起動します。
再起動後に,設定した情報が有効になります。
- J2EEサーバを再起動します。
再起動後に,設定した情報が有効になります。
(d) ユーザJP1イベントの推奨設定
「(c) J2EEユーザ用JP1イベントの設定」で設定するユーザJP1イベントの推奨設定について説明します。なお,J2EEアプリケーションのユーザログ出力の詳細については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 拡張編」の「12.8 J2EEアプリケーションのユーザログ出力の設定」を参照してください。
●ユーザJP1イベントのマッピングの設定
マッピングは次のように設定します。
ログレベル | JP1イベント重大度 |
---|
SEVERE | Error |
WARNING | Warning |
INFO | Information |
CONFIG | Notice |
FINE | なし |
FINER | なし |
FINEST | なし |
●ユーザJP1イベントのフィルタリングの設定
ログを取得するときにメッセージIDを付けて,「MESSAGE_ID」でフィルタリングします。JP1イベントを発行させたいメッセージIDに対して「MESSAGE_ID EQU <メッセージID>」をORで接続して記述します。
![[図データ]](figure/zu130600.gif)
また,J2EEアプリケーションごとにJP1イベントの発行をフィルタリングしたい場合は,ログを取得するときにJ2EEアプリケーション名を付けるか,デフォルトのJ2EEアプリケーション名を設定して,「APPLICATION」でフィルタリングします。
![[図データ]](figure/zu130700.gif)
(2) JP1/Baseのイベントサーバ名の設定
Microsoft Cluster ServiceまたはHAモニタを使用したクラスタ構成の場合で,論理ホストのJP1/Baseのイベントサーバを使用してJP1イベントを発行するとき,Cosminexusの運用管理サーバ,およびJ2EEサーバでイベントサーバ名を設定します。
(a) 運用管理サーバ用イベントサーバ名の設定
Cosminexusの運用管理サーバでイベントサーバ名を設定するには,Management Server環境設定ファイル(mserver.properties)のmngsvr.jp1event.event_server_nameキーに,論理ホスト名または論理IPアドレスを指定します。なお,設定した情報を有効にするために,設定後は,Management Serverを再起動してください。
Management Server環境設定ファイルについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.7 mserver.properties(Management Server環境設定ファイル)」を参照してください。
(b) J2EEサーバ用イベントサーバ名の設定
J2EEサーバでイベントサーバ名を設定する場合,簡易構築定義ファイルの論理J2EEサーバ(j2ee-server)の<configuration>タグ内に,ejbserver.manager.jp1event.event_server_nameパラメタで指定します。
(3) JP1/Baseの構成定義の作成
JP1/IMが管理するシステムの構成を定義するJP1/Baseの構成定義ファイルを作成します。また,JP1/Baseの構成定義ファイルに定義したホストへ,定義情報を配布します。
JP1/Baseの構成定義の作成手順を次に示します。なお,詳細については,マニュアル「JP1 Version 8 JP1/Integrated Management - Manager システム構築・運用ガイド」,またはマニュアル「JP1 Version 9 JP1/Integrated Management - Manager 構築ガイド」のシステムの構成定義情報の設定に関する説明を参照してください。
- JP1/Baseの構成定義ファイルを作成して,システムの構成を定義します。
構成定義ファイル(jbs_route.conf)は次の場所にインストールされています。
- Windowsの場合
<JP1/Baseのインストールディレクトリ>¥jp1base¥conf¥route¥jbs_route.conf
- UNIXの場合
/etc/opt/jp1base/conf/route/jbs_route.conf
構成定義ファイルの内容を次に示します。
- 構成定義ファイルの内容
- [JP1統合運用管理サーバマシンのホスト名]
- J2EEサーバマシンのホスト名
- Cosminexusの運用管理サーバマシンのホスト名
- jbsrt_distribコマンドを実行して,構成定義情報を配布します。