8.2.4 adminagent.xml(運用管理エージェント設定ファイル)
(1) 形式
ファシリティ名(論理サーバの種類と起動/停止の動作種別を示す)の設定のあとに,環境変数名および環境変数の値を設定します。
- ファシリティ名の設定
<facility> <name>「ファシリティ名」</name> <class>com.cosminexus.mngsvr.adminagent.impl.CmdExecuter</class>
- 環境変数名および環境変数名の設定
-
上記ファシリティ名の設定のあとに,次の記述を追加します。
<init-param> <param-name>adminagent.facility.CmdExecuter.env.「環境変数名」</param-name> <param-value>「環境変数の値」</param-value> </init-param>
(2) ファイルの格納先
-
Windowsの場合
<Application Serverのインストールディレクトリ>\manager\config\
-
UNIXの場合
/opt/Cosminexus/manager/config/
(3) 機能
システム管理者の代わりに,論理サーバの起動,または設定ファイルの更新をします。
このファイルで初期設定されている環境変数の値を変更する必要がある場合,または環境変数を追加または削除する必要がある場合は,この設定ファイルを編集してください。
(4) ファシリティ名で指定できる論理サーバ種類
ファシリティ名で指定できる論理サーバ種類と,起動/停止の動作の種別を次の表に示します。
論理サーバ種類 |
起動/停止種別 |
ファシリティ名 |
備考 |
---|---|---|---|
パフォーマンストレーサ |
起動 |
prf-start |
− |
停止 |
prf-stop |
− |
|
スマートエージェント (Windowsの場合) |
起動 |
osagent-start |
− |
停止 |
osagent-stop |
− |
|
スマートエージェント (UNIXの場合) |
起動 |
osagent-start |
− |
ネーミングサービス |
起動 |
naming-service-start |
− |
CTMドメインマネジャ |
起動 |
ctm-dommng-start |
− |
停止 |
ctm-dommng-stop |
− |
|
CTM |
起動 |
ctm-start |
− |
停止 |
ctm-stop |
− |
|
J2EEサーバ |
起動 |
j2ee-server-start |
J2EEサーバでデータベースを利用する場合には,J2EEサーバ起動時の環境変数にデータベース固有の設定をする必要があります。 |
停止 |
j2ee-server-stop |
||
WEBサーバ (Windowsの場合) |
起動 |
web-server-start |
− |
停止 |
web-server-stop |
− |
|
WEBサーバ (UNIXの場合) |
起動 |
web-server-start |
− |
(5) 注意事項
-
adminagent.xmlを変更した場合は,運用管理エージェントを再起動してください。
-
各論理サーバの起動/停止時には,運用管理エージェントの起動時の環境変数を引き継ぎます。環境変数を引き継ぎたくない場合は,該当環境変数を空に設定してください。
-
adminagent.xmlで設定した環境変数は,該当ホストの運用管理エージェントから起動される論理サーバの種類ごとに有効になります。論理サーバのインスタンス単位に環境変数の設定はできません。
- (例1)
-
J2EEサーバ起動時に,環境変数NLS_LANGにJapanese_japan.ja16sjisを設定する場合
<facility>
<name>j2ee-server-start</name>
<class>com.cosminexus.mngsvr.adminagent.impl.CmdExecuter</class>
<init-param>
<param-name>adminagent.facility.CmdExecuter.env.NLS_LANG</param-name>
<param-value>Japanese_japan.ja16sjis</param-value>
</init-param>
…
…
- (例2)
-
運用管理エージェント起動時に設定された環境変数AIXTHREAD_SCOPEを引き継がない場合
<facility>
…
…
<init-param>
<param-name>adminagent.facility.CmdExecuter.env.AIXTHREAD_SCOPE</param-name>
<param-value></param-value>
</init-param>
…
…
-
「環境変数名」および「環境変数の値」に設定した値は,コマンドシェルのような環境変数の置換や演算子による処理がされません。このため,「環境変数名」および「環境変数の値」にシステム環境変数は使用できません。