8.2.1　adminagent.properties（運用管理エージェントプロパティファイル）

adminagent.adapter.allowedHosts

サーバへのアクセスを許可するホスト名またはIPアドレスを指定します。

複数のアドレスを指定する場合はコンマ（,）で空白を入れずに区切ります。IPアドレスはメタキャラクタを用いた正規表現で指定できます。IPアドレスを正規表現で指定した場合，利用可能なローカルIPアドレスのうちマッチするIPアドレスが使用されます。複数のIPアドレスがマッチした場合は，マッチしたすべてのIPアドレスが許可されます。

なお，IPアドレスを正規表現で指定する場合は，コンマ（,）で複数の値を指定することはできません。

指定できる値を次に示します。

• ホスト名

• IPv4アドレス

なし

05-05

adminagent.adapter.bind_host

運用管理エージェントとの通信で使用するホスト名またはIPアドレスを指定します。複数の物理ネットワークインタフェースを持つホスト，または一つの物理ネットワークインタフェースに対して複数の論理IPアドレスを割り当てているホストで運用管理エージェントを利用するとき，任意のIPアドレスを選択できます。

不正な値を指定した場合は，運用管理エージェントがエラー終了します。

IPアドレスはメタキャラクタを用いた正規表現で指定できます。IPアドレスが正規表現で指定された場合，利用可能なローカルIPアドレスのうちマッチするIPアドレスを採用します。^※1

指定できる値を次に示します。

• ホスト名

• IPv4アドレス

なし

06-00

adminagent.adapter.port

サーバ機能の使用するポート番号を指定します。

1〜65535の整数で指定します。

20295

05-05

adminagent.cluster.localaddress.check

アプリケーションサーバの系切り替え実行時に，待機系を停止するかどうかを設定します。

アプリケーションサーバの系切り替え実行時，待機系の論理サーバや運用管理エージェントが停止しなかった場合に，論理サーバと運用管理エージェントを停止します。

trueを指定した場合：

アプリケーションサーバの系切り替え実行時に，停止しなかった待機系の論理サーバおよび運用管理エージェントを停止します。

ローカルアドレスをチェックし，クラスタIPアドレスが設定されていなければ論理サーバを停止して，運用管理エージェントを停止します。

falseを指定した場合：

アプリケーションサーバの系切り替え実行時に，停止しなかった待機系の論理サーバおよび運用管理エージェントを停止しません。

次のどちらかを指定します。

• true

• false

false

07-10

adminagent.finalization.stop_servers

運用管理エージェントの終了処理で論理サーバを停止するかどうかを指定します。

trueを指定した場合：

運用管理エージェントの終了処理で，論理サーバをすべて停止します。

falseを指定した場合：

運用管理エージェントの終了処理で論理サーバを停止しません。

次のどちらかを指定します。

• true

• false

false

06-50

adminagent.forcestop.threaddump

J2EEサーバの強制停止時にスレッドダンプを出力するかどうかを指定します。この設定が有効な論理サーバはJ2EEサーバだけです。

trueを指定した場合：

スレッドダンプを出力します。この場合，cjstopsvコマンドに-fdオプションを指定して実行した場合と同じ動作で強制停止します。^※2

falseを指定した場合：

スレッドダンプを出力しません。

次のどちらかを指定します。

• true

• false

false

06-50

adminagent.forcestop.threaddump.interval

J2EEサーバの強制停止時にスレッドダンプを出力する設定にした場合に，スレッドダンプ出力の完了を確認する間隔を，1〜2147483647の整数（単位：秒）で指定します。

1〜2147483647以外が指定された場合，デフォルト値が設定されます。

1〜2147483647の整数で指定します。

1

06-50

adminagent.forcestop.threaddump.timeout

J2EEサーバの起動／停止の設定で，「強制停止監視時間」を「監視しない」設定にしている場合の，スレッドダンプ/クラッシュダンプ/coreの出力待ち時間を-1〜2147483647の整数（単位：秒）で指定します。

-1を指定した場合，スレッドダンプ/クラッシュダンプ/coreの出力が終了するまで待機します。

-1〜2147483647以外を指定した場合，省略値が設定されます。

指定した時間が経過してもスレッドダンプ/クラッシュダンプ/coreの出力が終了しない場合は，J2EEサーバおよびSFOサーバは強制停止します。^※2

-1〜2147483647の整数で指定します。

45

06-50

adminagent.hws.group

HTTP Serverを使用する場合に，HTTP Serverを起動するユーザが所属するグループ名を指定します。

省略した場合は，運用管理エージェントのグループ名で起動します。

このキーはUNIX用です。^※3

グループ名

なし

08-00

adminagent.hws.owner

HTTP Serverを使用する場合に，HTTP Serverを起動するユーザ名を指定します。

省略した場合は，運用管理エージェントのユーザ名で起動します。

なお，このキーはUNIX用です。^※3

ユーザ名

なし

08-00

adminagent.hws.sys_cmd.abnormal_end.traceinfo

障害検知時コマンドの実行の際にWebサーバの内部トレースを採取するかどうかを指定します。

trueを指定した場合：

内部トレースを採取します。

falseを指定した場合：

内部トレースを採取しません。

次のどちらかを指定します。

• true

• false

true

07-00

adminagent.hws.watch.method

adminagent.hws.watch.levelで2を指定したときのHTTP Serverの動作確認用HTTPメソッドを指定します。指定可能なメソッドは"HEAD"または"OPTIONS"のどちらかです。^※4

"HEAD"を指定した場合：

adminagent.hws.watch.urlで指定されたURLにアクセスして応答が返ることを確認します。

"OPTIONS"を指定した場合：

WebサーバがHTTPメソッドを受け付け可能な状態であることを確認します。

ProxyPassディレクティブのパス名に"/"を指定した場合，すべてのURLはJ2EEサーバのWebコンテナにリダイレクトされてしまいます。したがって，ProxyPassディレクティブのパス名に"/"を指定する場合は，"OPTIONS"を指定し，URLアクセスを行わないことを推奨します。

次のどちらかを指定します。

• HEAD

• OPTIONS

HEAD^※5

06-50

adminagent.hws.watch.url

adminagent.hws.watch.methodで"HEAD"を指定したときの，HTTP Serverの動作確認用URLを指定します。指定されたURLにアクセスし，レスポンスが返るかどうかで判定するため，実際にアクセスできるURLを指定してください。なお，URLは"http"で始まる絶対パス，またはルートコンテキストからの相対パスで指定します。同一のホストに複数のWebサーバを構築する場合は相対パスで指定してください。

（指定例）

http://HostA:80/index.htmlを指定する場合

adminagent.hws.watch.url=http://HostA:80/index.html

http://localhost:<ポート番号>/index.htmlを指定する場合（複数Webサーバ対応）

adminagent.hws.watch.url=index.html

URL

ルートコンテキスト（http://localhost:<ポート番号>/）

06-00

adminagent.j2ee.process.console_event.enabled

J2EEサーバのコンソール出力情報をManagementServerを使用するEclipseプラグインで表示するかどうかを指定します。

trueを指定した場合：

コンソール出力情報をManagementServerを使用するEclipseプラグインに出力します。

falseを指定した場合：

コンソール出力情報をManagementServerを使用するEclipseプラグインに出力しません。

adminagent.process.consolelog.enabledをtrueに設定する必要があります。

リソースを消費するため，ManagementServerを使用するEclipseプラグインを使用しない運用ではfalseに設定することを推奨します。

次のどちらかを指定します。

• true

• false

false

07-10

adminagent.j2ee.process.console_log.enabled

J2EEサーバのコンソール出力情報をコンソールログに出力するかどうかを指定します。

trueを指定した場合：

コンソール出力情報をコンソールログに出力します。

falseを指定した場合：

コンソール出力情報をコンソールログに出力しません。

adminagent.process.consolelog.enabledをtrueに設定する必要があります。

次のどちらかを指定します。

• true

• false

false

07-10

adminagent.j2ee.sys_cmd.abnormal_end.javatrace

障害検知時コマンドの実行の際にJ2EEサーバのスタックトレースを取得するかどうかを指定します。

trueを指定した場合：

スタックトレースを取得します。

falseを指定した場合：

スタックトレースを取得しません。

次のどちらかを指定します。

• true

• false

true

07-00

adminagent.j2ee.sys_cmd.abnormal_end.threaddump

障害検知時コマンド実行の際にJ2EEサーバのスレッドダンプを収集するかどうかを指定します。

trueを指定した場合：

J2EEサーバのスレッドダンプを収集します。

falseを指定した場合：

J2EEサーバのスレッドダンプを収集しません。

次のどちらかを指定します。

• true

• false

true

06-50

adminagent.jp1event.event_server_name

使用するJP1/Baseのイベントサービスのイベントサーバ設定ファイル（conf）に指定した，portsキーのアドレスと同じ値を指定します。portsキーに複数のアドレスを指定している場合は，指定したアドレスのうちのどれか一つを指定します。なお，portsキーのアドレスに「0.0.0.0」（デフォルト値）を指定したイベントサービスを使用する場合は，このキーを省略するか，自マシンのホスト名またはlocalhostを指定します。

ホスト名またはIPv4ドット記法

localhost

06-70

adminagent.jp1event_enabled

運用管理エージェントからJP1イベントを発行するかどうかを指定します。

trueを指定した場合：

JP1イベントを発行します。

falseを指定した場合：

JP1イベントを発行しません。

次のどちらかを指定します。

• true

• false

false

06-70

adminagent.log.filenum

ログファイル面数を1〜16の整数で指定します。

1〜16の整数で指定します。

4

05-05

adminagent.log.filesize

ログファイル一つ当たりの上限サイズ（単位：バイト）を，65536〜2147483647の数値で指定します。

65536〜2147483647の整数で指定します。

65536

05-05

adminagent.log.level

ログ出力レベルを-1〜1000の整数で指定します。

• -1：出力しません。

• 0：通常運用：通常運用。

• 10：通常運用（verbose）：通常運用に近い形態での再現待ち。

• 20：再現テスト：システム環境構築時やテストフェーズでの，デバッグレベルの情報の取得。

• 30：障害調査：原因究明困難な障害発生時，より詳細な障害情報の取得。

-1〜1000の整数で指定します。

0

05-05

adminagent.lsinfo_dir

論理サーバ情報ファイルの出力先ディレクトリを指定します。指定したディレクトリが存在しない場合は作成します。

運用管理エージェント再起動後に，停止前に管理していた論理サーバを再び管理下に置き，操作できるようにするための情報です。論理サーバの起動中に作成され，論理サーバの停止後に削除されます。

ディレクトリ名(絶対パス)

<Managerインストールディレクトリ>/spool/lsinfo

06-50

adminagent.maintenance.log.filenum

保守ログのファイル面数を1〜16の整数で指定します。

1〜16の整数で指定します。

4

06-70

adminagent.maintenance.log.filesize

保守ログのファイル一つ当たりの上限サイズ（単位：バイト）を，65536〜2147483647の整数で指定します。

65536〜2147483647の整数で指定します。

16777216

06-70

adminagent.prftrace_dir

性能解析トレースファイルが一時的に出力されるディレクトリパス名を，文字列で指定します。指定したディレクトリがない場合，指定したディレクトリが作成されます。

注意事項

性能解析トレースファイルは次の場合，一時的に出力されます。

• 論理サーバの異常停止によってシステム障害検知コマンドが実行される場合

• Management Serverの運用管理コマンド（mngsvrutil）のサブコマンド「collect」を指定してsnapshotログを収集する場合

• 運用管理ポータルでsnapshotログを収集する場合

そのため，次の算出式を基に出力先の空き容量を確保してください。指定先に出力されるファイル容量（最大値）= PRFトレースのサイズ（PrfTraceFileSize指定値）× PRFトレースの面数（PrfTraceCount指定値）

なお，同一ホスト上にPRFが複数存在する場合は，すべてのPRFトレースファイルサイズの総和となります。

ディレクトリ名(絶対パス)

<Application Serverのインストールディレクトリ>/manager/tmp/

09-50

adminagent.process.consolelog.enabled

運用管理エージェントが起動したプロセスのコンソール出力情報を取得するかどうかを指定します。ただし，ManagementServerを使用するEclipseプラグインを使用する場合はtrueを指定する必要があります。

trueを指定した場合：

コンソール出力情報を取得します。

falseを指定した場合：

コンソール出力情報を取得しません。

次のどちらかを指定します。

• true

• false

true

07-00

adminagent.process.consolelog.event.queue_size

運用管理エージェントが起動したプロセスのコンソール出力情報を，Management Serverにイベント通知する際の，イベントキューのサイズを設定します。

キューがいっぱいになった場合は，古いイベントから破棄されます。

このプロパティは，デフォルト値が推奨のため，設定を変更しないでください。

1024〜2147483647の整数で指定します。

1024

07-00

adminagent.process.consolelog.filenum

運用管理エージェントが起動したプロセスのコンソール出力情報を出力するログファイル面数を，1〜16の整数で指定します。

sinaviagent.log.styleキーでシフトモードを設定した場合は，バックアップファイルの面数になります。

1〜16の整数で指定します。

4

07-00

adminagent.process.consolelog.filesize

運用管理エージェントが起動したプロセスのコンソール出力情報を出力するログファイル一つ当たりの上限サイズ（単位：バイト）を，65536〜2147483647の整数で指定します。

65536〜2147483647の整数で指定します。

65536

07-00

adminagent.process.consolelog.time

運用管理エージェントが起動したプロセスのコンソール出力情報を出力するログファイルをローテーションする時刻を，000000〜235959のHHMMSS形式で指定します。ただし，このプロパティで設定した時刻に達する前に，ログファイルのサイズが上限に達した場合，その時点でログファイルをローテーションします。

指定がない場合は，ログサイズだけでローションします。

000000〜235959のHHMMSS形式で指定します。

なし

09-00

adminagent.process.consolelog.style

運用管理エージェントが起動したプロセスのコンソール出力情報を出力するログファイルのローテーション方式を指定します。

SHIFTを指定した場合：

シフトモードでローテーションします。

WRAPを指定した場合：

ラップアラウンドモードでローテーションします。

次のどちらかを指定します。

• SHIFT

• WRAP

WRAP

09-00

adminagent.rmi.log.filenum

運用管理エージェントが行うRMI処理での保守ログのファイル面数を数値で指定します。

1〜16の整数で指定します。

8

07-60

adminagent.rmi.log.filesize

運用管理エージェントが行うRMI処理での保守ログのファイル一つ当たりの上限サイズを数値で指定します。

65536〜2147483647の整数で指定します。

16777216

07-60

adminagent.rmi.log.level

運用管理エージェントが行うRMI処理での保守ログの出力レベルを文字列で指定します。

＜OFF＞

出力しません。

＜SEVERE＞，＜WARNING＞，＜INFO＞，＜CONFIG＞，＜FINE＞，＜FINER＞，＜FINEST＞

SEVEREは深刻な問題だけを出力します。ここに示した順番でより詳細なログが出力されるようになります。

次のどれかを指定します。

• OFF

• SEVERE

• WARNING

• INFO

• CONFIG

• FINE

• FINER

• FINEST

FINER

07-60

adminagent.snapshotlog.listfile.2.num_snapshots

二次資料として収集する，論理サーバごとのsnapshotログファイル数を，-2147483648〜2147483647の数値で指定します。指定されたファイル数を超えた場合，作成時刻の古い順にログファイルは削除されます。また，0以下の値を指定した場合，ログファイルは削除されません。

-2147483648〜2147483647の整数で指定します。

10

06-50

adminagent.snapshotlog.log_dir

snapshotログの出力先ディレクトリを，文字列で指定します。指定したディレクトリがない場合は作成します。

ディレクトリ名(絶対パス)

<manager.cfgのcom.cosminexus.manager.log.dir>/snapshot/

06-00

adminagent.snapshotlog.num_snapshots

一次資料として収集する，論理サーバごとのsnapshotログファイル数を，-2147483648〜2147483647の数値で指定します。指定されたファイル数を超えた場合，作成時刻の古い順にログファイルは削除されます。また，0以下の値を指定した場合，ログファイルは削除されません。

-2147483648〜2147483647の整数で指定します。

10

06-00

adminagent.sys_cmd.abnormal_end.prftrace

障害検知時コマンド実行の際に性能解析トレースファイルを収集するかどうかを指定します。

trueを指定した場合：

性能解析トレースファイルを収集します。

falseを指定した場合：

性能解析トレースファイルを収集しません。

次のどちらかを指定します。

• true

• false

true

06-50

adminagent.userserver.process.console_event.enabled

ユーザサーバのコンソール出力情報をManagementServerを使用するEclipseプラグインで表示するかどうかを指定します。

trueを指定した場合：

コンソール出力情報をManagementServerを使用するEclipseプラグインに出力します。

falseを指定した場合：

コンソール出力情報をManagementServerを使用するEclipseプラグインに出力しません。

adminagent.process.consolelog.enabledをtrueに設定する必要があります。

リソースを消費するため，ManagementServerを使用するEclipseプラグインを使用しない運用ではfalseに設定することを推奨します。

次のどちらかを指定します。

• true

• false

false

07-10

adminagent.userserver.process.console_log.enabled

ユーザ定義サーバのコンソール出力情報をコンソールログに出力するかどうかを指定します。

trueを指定した場合：

コンソール出力情報をコンソールログに出力します。

falseを指定した場合：

コンソール出力情報をコンソールログに出力しません。

adminagent.process.consolelog.enabledをtrueに設定する必要があります。

次のどちらかを指定します。

• true

• false

false

07-10

adminagent.watch.retry_timeout.enabled

論理サーバの動作確認で，タイムアウトの発生をリトライ対象とするかどうかを指定します。

trueを指定した場合：

リトライ対象とします。

falseを指定した場合：

リトライ対象としません。

次のどちらかを指定します。

• true

• false

• デフォルト：false

• 初期値：true

06-70

adminagent.<サーバ種別>^※6.usr_cmd.abnormal_end

障害検知時コマンドを絶対パスで指定します。ファイルセパレータは「/」を使用します。障害が発生した論理サーバの種別に応じてコマンドを変えることができます。<サーバ種別>^※6に指定できる値以外の値を指定した場合は，無効になります。

Windowsの場合：

障害検知時コマンドをバッチファイルで作成する場合，コマンド名の前に“%{ComSpec} /C ”を追加する必要があります。“%{ComSpec}”は，cmd.exeの絶対パスに置換されます。“%{ComSpec} /C”が指定されていない場合，コマンドが正常に動作しないことがあります。また，コマンドのパスに半角スペースを含む場合は，コマンドの絶対パスを必ずダブルクォーテーション（""）で囲みます。

（例）J2EEサーバ障害発生時に，d:/my bat/j2eeabnormalend.batを実行する場合

adminagent.j2ee.usr_cmd.abnormal_end=%{ComSpec} /c "d:/my bat/j2eeabnormalend.bat"

UNIXの場合：

障害検知時コマンドをシェルスクリプトで作成する場合，コマンド名の前に“/bin/sh”を追加する必要があります。“/bin/sh”が指定されていない場合，コマンドが正常に動作しないことがあります。

（例）J2EEサーバ障害発生時に，/home/user1/j2eeabnormalend.shを実行する場合

adminagent.j2ee.usr_cmd.abnormal_end=/bin/sh /home/user1/j2eeabnormalend.sh

コマンド名(絶対パス)

なし

06-50

adminagent.<サーバ種別>^※6.watch.interval

論理サーバの動作確認間隔（単位：秒）を1〜86400の整数で指定します。

不正な値が指定された場合は，デフォルト値が設定されます。

なお，サーバ種別がユーザサーバの場合，論理ユーザサーバ定義ファイルまたは簡易構築定義ファイルで指定したwatch-intervalの値が有効になります。論理サーバの停止機能で設定する停止・強制停止監視時間は，このプロパティに指定した値よりも大きい値を指定する必要があります。指定した値よりも小さい値を指定した場合は停止・強制停止に失敗するおそれがあります。

1〜86400の整数で指定します。

10

06-00

adminagent.<サーバ種別>^※6.watch.level

論理サーバの動作確認レベルを指定します。指定できる値は，1または2です。

1を指定した場合：

プロセスの存在確認で論理サーバの動作を確認します。

2を指定した場合：

プロセスの存在確認および論理サーバへのアクセスで論理サーバの動作を確認します。動作を確認できる論理サーバは，ネーミングサービス，J2EEサーバおよびWebサーバです。論理ユーザサーバの指定はできません。そのほかの論理サーバについては2を指定しても，プロセスの存在確認だけになります。

1または2を指定します。

• ネーミングサービス，J2EEサーバおよびWebサーバの場合：2

• 上記以外の論理サーバの場合：1

06-00

adminagent.<サーバ種別>^※6.watch.retry_count

論理サーバの動作確認で，動作確認処理に失敗した場合にリトライする回数を0〜86400の整数で指定します。リトライ回数を設定することで，一時的な動作確認の失敗を許容できます。

リトライする間隔は，adminagent.<サーバ種別>.watch.intervalで指定します。0を指定した場合，動作確認処理に失敗すると，リトライしないで異常発生とみなされます。

動作確認処理に失敗し，リトライする場合はKEOS21033-W，またはKEOS21034-Wが運用管理エージェントのログに出力されます。

動作確認処理に失敗し，リトライしない場合，またはリトライ回数が指定回数を超えた場合はKEOS20511-E，またはKEOS21035-Eが運用管理エージェントのログに出力され，Management Serverに異常が通知されます。

0〜86400の整数で指定します。

1

06-70

adminagent.<サーバ種別>^※6.watch.start_time

論理サーバの起動で，起動コマンドを実行してから動作確認を開始するまでの時間（単位：秒）を0〜86400の整数で指定します。

論理サーバを起動した際の論理サーバのログ（J2EEサーバの場合，cjmessage?.logのKDJE30028-I）から実際に起動に掛かる所要時間を求め，その時間から数秒短い時間をこのプロパティに指定しておくことで，起動前に出力される不要なログ出力を減らし，論理サーバの起動完了をManagement Serverに迅速に通知できます。

論理サーバの起動／停止機能で設定する起動監視時間は，このプロパティに指定した値よりも大きい値を指定する必要があります。指定した値よりも小さい値を指定した場合は起動に失敗します。

0〜86400の整数で指定します。

<サーバ種別>^※6によって次のように異なります。

• prf：0

• smartagent：3

• naming：10

• ctmdm：0

• ctm：0

• ots：0

• tcs：3

• sfo：45

• j2ee：45

• hws：0

• userserver：0

06-70

adminagent.<サーバ種別>^※6.watch.timeout

論理サーバの動作確認でタイムアウトするまでの時間を，1〜9223372036854775の整数（単位：秒）で指定します。

1〜9223372036854775の整数で指定します。

60

06-50