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)　指定できるキー

指定できるキーとその内容および指定を省略した場合のデフォルト値を次に示します。

ページの先頭へ

(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アクションが実行されます。

  1. Managementイベントを発行したJ2EEサーバ

  2. Managementイベントを発行したJ2EEサーバを含むJ2EEサーバクラスタ

  3. Managementイベントを発行したJ2EEサーバを含むサービスユニット

  4. 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では取得しません。そのため，コマンドの標準出力／標準エラー出力を取得する場合は，コマンドの中でファイルに出力する必要があります。

ページの先頭へ