8.2.10 maction.properties(Managementアクション実行用プロパティファイル)
- 〈この項の構成〉
(1) 形式
J2SEのプロパティファイル形式です。
Management Serverのプロパティファイルです。
(2) ファイルの格納先
-
Windowsの場合
<Application Serverのインストールディレクトリ>\manager\config\
-
UNIXの場合
/opt/Cosminexus/manager/config/
(3) 機能
Managementイベントで通知されるメッセージIDに対応するManagementアクションを定義します。
(4) 指定できるキー
指定できるキーとその内容および指定を省略した場合のデフォルト値を次に示します。
キー名称 |
内容 |
分類 |
デフォルト値 |
---|---|---|---|
Managementアクションとして実行するコマンドを絶対パスで指定します。※1 |
Managementアクションの定義 |
なし |
|
実行するコマンドプロセスに対するタイムアウトを,0〜86400の整数(単位:秒)で指定します。 0を指定した場合は,タイムアウトしません。 |
Managementアクションの定義 |
10 |
|
タイムアウト発生時の,実行したコマンドプロセスに対する操作を指定します。
強制終了する場合,コマンドプロセスが作成したサブプロセスについては保証されません。 |
Managementアクションの定義 |
false |
|
Managementアクション実行開始後から,同一ManagementアクションIDのManagementアクションの実行を抑止する時間(単位:秒)を0〜86400の整数で指定します。 0を指定した場合,抑止しません。 |
Managementアクションの定義 |
0 |
|
同一ManagementアクションIDのManagementアクションの同時実行数の最大値を0〜1000の整数で指定します。 0を指定した場合,同時実行数を制限しません。 |
Managementアクションの定義 |
0 |
|
Managementイベントで通知するメッセージIDに対するManagementアクションIDを指定します。英数字と区切り文字としてのコンマ(,)が使用できます。※2 複数指定する場合はコンマ(,)で区切ります。 指定したManagementアクションに対してコマンドが設定されていない場合,Managementアクションは実行されません。 |
メッセージIDとManagementアクションのマッピング |
なし |
|
論理サーバに対応するManagementアクションIDを指定します。英数字と区切り文字としてのコンマ(,)が使用できます。※2 複数指定する場合はコンマ(,)で区切ります。 キー名称の<論理サーバ名>には,J2EEサーバ,J2EEサーバクラスタ,およびJ2EEサーバクラスタのメンバが指定できます。指定したManagementアクションに対してコマンドが設定されていない場合,Managementアクションは実行されません。 |
論理サーバとManagementアクションのマッピング |
なし |
|
物理ティアに対応するManagementアクションIDを指定します。英数字と区切り文字としてのコンマ(,)が使用できます。※2 複数指定する場合はコンマ(,)で区切ります。 指定したManagementアクションに対してコマンドが設定されていない場合,Managementアクションは実行されません。 |
論理サーバとManagementアクションのマッピング |
なし |
|
サービスユニットに対応するManagementアクションIDを指定します。英数字と区切り文字としてのコンマ(,)が使用できます。※2 複数指定する場合はコンマ(,)で区切ります。 指定したManagementアクションに対してコマンドが設定されていない場合,Managementアクションは実行されません。 |
論理サーバとManagementアクションのマッピング |
なし |
|
Managementイベントの受信情報を保持する最大数を,0〜2147483647の整数で指定します。0を指定した場合,Managementイベント受信情報を保持しません。Managementイベント受信情報を保持することで,ネットワークの高負荷や障害によるManagementアクションの二重実行を防止することができます。Managementイベント受信情報保持数が最大数を超えた場合,保持している受信情報のうち最も古い受信情報を削除します。Managementイベント受信情報は,次の場合に破棄されます。
|
Managementイベント受信時の設定 |
100 |
(5) 設定例
maction.propertiesファイルの内容を次に示します。
-
Windowsの場合
# Managementアクションの定義 maction.restart.command=c\:\\tmp\\command1.bat maction.restart.timeout=12 maction.restart.timeout.forced_stop=true maction.restart.exclusive_time=60 maction.restart.max_executable_actions=1 # メッセージIDとManagementアクションのマッピング maction.message.KDJE11111-E.mactions=restart maction.message.KDJE22222-E.mactions=restart # 論理サーバとManagementアクションのマッピング maction.server.j2ee1.mactions=restart maction.server.j2ee2.mactions=restart maction.server.j2eeClstr1.mactions=restart
-
UNIXの場合
# Managementアクションの定義 maction.restart.command=/tmp/command1.sh maction.restart.timeout=12 maction.restart.timeout.forced_stop=true maction.restart.exclusive_time=60 maction.restart.max_executable_actions=1 # メッセージIDとManagementアクションのマッピング maction.message.KDJE11111-E.mactions=restart maction.message.KDJE22222-E.mactions=restart # 論理サーバとManagementアクションのマッピング maction.server.j2ee1.mactions=restart maction.server.j2ee2.mactions=restart maction.server.j2eeClstr1.mactions=restart
(6) 注意事項
-
Managementアクション指定重複時の優先
次のプロパティキーについて,指定する論理サーバ,サービスユニットおよび物理ティアには
J2EEサーバ < J2EEサーバクラスタ < サービスユニット < 物理ティア
という包含関係が存在します。
-
maction.server.<論理サーバ名>.mactions
-
maction.unit.<Webシステム名>.<サービスユニット名>.mactions
-
maction.tier.<Webシステム名>.<物理ティア種別名>.mactions
そのため,包含関係を持つ論理サーバ(例えば,J2EEクラスタと,そのJ2EEクラスタの要素となるJ2EEサーバ)それぞれに対して別々のManagementアクションが指定された場合,次の優先順でどれか一つのManagementアクションが実行されます。
-
Managementイベントを発行したJ2EEサーバ
-
Managementイベントを発行したJ2EEサーバを含むJ2EEサーバクラスタ
-
Managementイベントを発行したJ2EEサーバを含むサービスユニット
-
Managementイベントを発行したJ2EEサーバを含む物理ティア
また,メッセージIDとManagementアクションのマッピング,論理サーバとManagementアクションのマッピングでManagementアクションの指定順序が異なる場合,メッセージIDとManagementアクションのマッピング(maction.message.<メッセージID>.mactionsキー)に指定されたManagementアクションIDの順番を優先します。
- (例)"act1"を優先する例
-
maction.message.KDJE99999-E.mactions=act1,act2
maction.server.J2EE01.mactions=act3,act2,act1
なお,この例では,「KDJE99999-E」がメッセージID,「J2EE01」が論理サーバです。
-
-
標準出力/標準エラー出力について
Managementアクションとして実行するコマンドから出力される標準出力/標準エラー出力についてはManagement Serverでは取得しません。そのため,コマンドの標準出力/標準エラー出力を取得する場合は,コマンドの中でファイルに出力する必要があります。