Cosminexus　リファレンス　定義編

[目次][索引][前へ][次へ]

2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）

＜この節の構成＞
(1)　形式
(2)　ファイルの格納先
(3)　機能
(4)　指定できるキー
(5)　記述例
(6)　注意事項

(1)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

　
<キー名称> = <値>
　

指定方法
  • 改行までが値になります。
  • #で始まる行はコメントとみなされます。
  • 値が存在しない行を定義した場合，その行は無視されます。
  • 値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。
（例）　<キー名称> = <値> #<コメント>
  • 実行時の文字エンコーディングと異なる文字エンコーディングでは記述できません。

(2)　ファイルの格納先

(3)　機能

J2EEサーバを実行するJavaVMの起動オプションを指定します。

J2EEサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は次にJ2EEサーバを起動したときに反映されます。

(4)　指定できるキー

指定できるキーとデフォルト値を次の表に示します。

表2-2　usrconf.cfgに指定できるキーとデフォルト値（J2EEサーバ）

キー名称 内容 デフォルト値
add.jvm.arg 指定されたオプションを使ってJavaVMを起動します。次のJavaVMのオプションを指定できます。
  • -D<property>
  • -verbose:[class|gc|jni]
  • -Xloggc:<file>
  • -Xms<size>
  • -Xmx<size>
  • -Xmn<size>
  • -Xss<size>
  • -Xprof
  • -Xrunhprof[:help]|[:<option>=<value>, ...]
  • -Xrun<libraryName>
  • -Xdebug
  • -XX:NewRatio=<value>
  • -XX:PermSize=<value>
  • -XX:MaxPermSize=<value>
  • -XX:SurvivorRatio=<value>
  • -XX:[+|-]PrintTenuringDistribution
  • -XX:TargetSurvivorRatio=<value>
  • -XX:MaxTenuringThreshold=<value>
  • -XX:HitachiJavaLog:[<name>]※1
  • -XX:HitachiJavaLogFileSize=<size>※1
  • -XX:[+|-]HitachiJavaLogNoMoreOutput※1
  • -XX:HitachiJavaLogNumberOfFile=<size>※1
  • -XX:[+|-]HitachiOutOfMemoryCause※1
  • -XX:[+|-]HitachiOutOfMemoryStackTrace※1
  • -XX:HitachiJavaClassLibTraceLineSize=<size>※1
  • -XX:[+|-]HitachiOutputMilliTime※1
  • -XX:[+|-]HitachiThreadDump※1
  • -XX:[+|-]HitachiVerboseGC※1※2
  • -XX:[+|-]HitachiCommaVerboseGC※1
  • -XX:[+|-]HitachiVerboseGCPrintCause※1
  • -XX:[+|-]HitachiVerboseGCPrintDate※1
  • -XX:[+|-]HitachiFullCore（UNIX用のオプション）※1
  • -XX:[+|-]HitachiThreadDumpToStdout※1
  • -XX:[+|-]HitachiOutOfMemorySize※1
  • -XX:[+|-]HitachiOutOfMemoryAbort※1
  • -XX:[+|-]HitachiOutOfMemoryAbortThreadDump※1
  • -XX:[+|-]HitachiJavaClassLibTrace※1
  • -XX:HitachiJavaClassLibTraceLineSize=<size>※1
  • -XX:[+|-]HitachiLocalsInThrowable※1※3
  • -XX:[+|-]HitachiLocalsSimpleFormat※1
  • -XX:HitachiCallToString=<適用範囲>※1
  • -XX:[+|-]HitachiTrueTypeInLocals※1
  • -XX:[+|-]HitachiLocalsInStackTrace※1
  • -XX:[+|-]HitachiReserveSwapSpace（UNIX用のオプション）※1
システムプロパティを指定したい場合は，"-D"を利用しないで，usrconf.propertiesファイルに指定します。
複数のオプションを指定する場合，同じキー名称を使用して，次のように複数回指定してください。
（指定例）
add.jvm.arg= -Xms256m
add.jvm.arg= -Xmx512m
なお，次のように複数のオプションを指定できません。指定をした場合，JavaVMの初期化に失敗します。
（指定例）
add.jvm.arg=-Xms256m -Xmx512m
  • -Xms256m
  • -Xmx512m
  • -XX:NewRatio=2
  • -XX:PermSize=128m
  • -XX:MaxPermSize=128m
  • -XX:+HitachiOutOfMemoryStackTrace
  • -XX:HitachiJavaLog:
    ・Windowsの場合
    <Cosminexusのインストールディレクトリ>\ejb\<サーバ名称>\logs
    ・UNIXの場合
    /opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/logs
  • -XX:HitachiJavaLogFileSize=4m
  • -XX:+HitachiVerboseGC
  • -XX:+HitachiVerboseGCPrintCause
  • -XX:+HitachiOutputMilliTime
  • -XX:-HitachiThreadDumpToStdout
  • -XX:+HitachiOutOfMemoryAbort
  • -XX:+HitachiJavaClassLibTrace
  • -XX:HitachiJavaClassLibTraceLineSize =1024
  • -XX:+HitachiLocalsSimpleFormat
  • -XX:+HitachiTrueTypeInLocals
  • -XX:+HitachiLocalsInStackTrace
  • -XX:+HitachiReserveSwapSpace
add.class.path コンテナ拡張ライブラリ用のJARを指定します。 なし
add.library.path JNI用の共有ライブラリを指定します。コンテナ拡張ライブラリがJNIを利用する場合だけ指定します。 なし
cpp.library.version プロセス内で使用するlibstdc++ライブラリのバージョンを指定します。なお，このキーは，Linux用です。
指定できる文字列を次に示します。

5：
libstdc++.so.5ライブラリを使用します。

6：
libstdc++.so.6ライブラリを使用します。
Red Hat Enterprise Linux 3の場合に設定できるのは「5」だけです。
Red Hat Enterprise Linux 4の場合，x64ネイティブ版を使用するときは「6」を，それ以外のときは「5」か「6」を設定できます。
Red Hat Enterprise Linux 3またはRed Hat Enterprise Linux 4以外のプラットホームで設定しても無効です。
  • x64ネイティブ版を使用する場合
    6
  • それ以外を使用する場合
    5
ejb.public.directory 指定されたディレクトリをJ2EEサーバの作業ディレクトリとしてJ2EEサーバを開始します。J2EEサーバのカレントディレクトリを次に示します。
  • Windowsの場合
    <Cosminexus作業ディレクトリ>\ejb\<サーバ名称>
  • UNIXの場合
    <Cosminexus作業ディレクトリ>/ejb/<サーバ名称>
ディレクトリ名称は絶対パスで指定してください。指定できる文字は，半角英数字，アンダースコア（_），またはハイフン（-）です。パス長は，Cosminexusの作業ディレクトリの見積もり式で算出した範囲内で指定できます。J2EEサーバの作業ディレクトリについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。
  • Windowsの場合
    <Cosminexusのインストールディレクトリ>\CC\server\public
  • UNIXの場合
    /opt/Cosminexus/CC/server/public
ejb.server.corefilenum（UNIX用） J2EEサーバ再起動時に残すcoreファイルの数を0〜16の整数で指定します。なお，このキーは，UNIX用です。
次の対象coreファイルのうち，作成日時が新しいのものから指定した数のファイルを残し，それ以外のファイルは削除されます。通常はJ2EEサーバダウン時に出力するcoreファイル数の1を指定します。

対象coreファイル
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/core*
  • 再起動時にすべてのcoreファイルを削除する場合は，0を指定します。
  • 手動による運用またはManagement Serverを使用する場合は，1以上を指定します。
対象coreファイルのうち，上書き，または削除される可能性のあるcoreファイルについては再起動時にリネームされます。

Linux（プロセスID付きの設定）の場合
core.<core生成プロセスID> → core.<core生成プロセスID>.<coreファイル作成日時>

上記以外の場合
core → core.<coreファイル作成日時>
<coreファイル作成日時>の形式は，yymmddHHMMSSです。
なお，coreファイルのリネーム，または削除に失敗した場合はメッセージKDJE40047-Eを出力し，J2EEサーバ起動処理を中止して異常終了します。
また，次のことに注意してください。
  • 対象coreファイルと同じ名称のファイルを作成した場合はユーザが作成したファイルが削除されます。
  • coreファイルの削除はJ2EEサーバ再起動時に処理されるため，再起動するまでは定義数以上のcoreファイルが出力されている場合があります。
  • 定義数+n分のcoreファイルが残るためディスク容量に注意してください（n:再起動されるまでにJ2EEサーバが出力するcoreファイル数）。
 1
ejb.server.log.directory 指定されているディレクトリをログファイル※4の出力先として使用します。パス長は，1〜200バイトで指定します。Windowsの場合，UNC名を含むパスは指定できません。UNIXの場合，nfsマウントされたディスク上へのパスは指定できません。
このキーを指定する場合，サーバ開始前にログ出力先ディレクトリを作成してください。存在しないディレクトリが指定された場合は，J2EEサーバ開始時にKDJE40024-Eのメッセージが出力され，異常終了します。
ほかのJ2EEサーバやWebコンテナサーバとログ出力先が，同じディレクトリにならないように注意してください。同じディレクトリを指定した場合，動作は保証されません。
なお，このキーを指定して，作業ディレクトリ以外にログを出力する場合，変更先ディレクトリ下のログファイルはサーバをアンセットアップする時に削除されません。ログファイルを削除したい場合には，手動で削除してください。
  • Windowsの場合
    <Cosminexus作業ディレクトリ>\ejb\<サーバ名称>\logs
  • UNIXの場合
    <Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs
ejb.server.log.mode ログファイルの出力形態を指定します。
指定できる文字列を次に示します。
  • 6
    Version 6互換モードにします。保守用のログファイルをVersion 6以前と同じディレクトリに出力します。
  • 7
    Version 7モードにします。
なお，Version 6互換モードからVersion 7モード，またはVersion 7モードからVersion 6互換モードに変更した場合，保守用のログファイルを各モードの出力先に移動しません。ログファイルの出力モードを変更したあと，出力先変更前の保守用のログファイルは必要に応じて削除してください。		 7
ejb.server.log.stdout.filesize cjstdout.logファイルのサイズの上限値を4096〜2147483647の範囲（単位：バイト）の整数で指定します。 1048576
ejb.server.log.stderr.filesize cjstderr.logファイルのサイズの上限値を4096〜2147483647の範囲（単位：バイト）の整数で指定します。 1048576
jvm.type 使用するJavaVMのタイプを指定します。指定できる値は次のどちらかです。
  • server
    Java HotSpot(TM) Server VMが使用されます。
  • client
    Java HotSpot(TM) Client VMが使用されます。
J2EEサーバ，またはJ2EEアプリケーションの開始および停止の頻度が高い開発環境などでは，”client”を指定することで性能が向上する場合があります。指定値に誤りがあった場合は，”server”→”client”の順でJavaVMを検索します。なお，このときKDJE40020-Wメッセージが出力されます。
AIXおよびSolarisの場合は，”server”を指定しても”client”になります。		 server

注※1
JavaVM拡張オプションについては，「16.　JavaVM起動オプション」を参照してください。なお，サポートされるCosminexus Developer's Kit for Javaのバージョンは，OSによって異なります。

注※2
JavaVMの情報およびガーベージコレクションのログに，拡張verbosegc情報を出力するかどうかを指定します。
拡張verbosegc情報を出力する場合，「-XX:+HitachiVerboseGC」を指定してください。拡張verbosegc情報を出力しない場合は，「-XX:-HitachiVerboseGC」を指定してください。なお，デフォルトでは拡張verbosegc情報は出力されます。
拡張verbosegc情報を出力する場合，ガーベージコレクションの内部領域（Eden領域，Survivor領域，Tenured領域，およびPerm領域）の種別ごとに情報を出力します。なお，拡張Verbosegc情報だけを出力したい場合は，クラスライブラリのスタックトレース出力オプションを一時的に出力しないに設定することを推奨します。
JavaVMの情報およびガーベージコレクションのログに出力される拡張verbosegc情報の詳細については，「16.　JavaVM起動オプション」を参照してください。

注※3
このオプションを有効にした場合，ログファイル（cjexception?.log，user_err?.log）およびデフォルトエラーページなどのスタックトレースにローカル変数名とその内容が出力されます。また，オンライン性能が劣化します。そのため，このオプションはデバッグ時に用いることを推奨します。

注※4
次に示すログファイルが変更の対象になります。

ログの種類 内容 ログ取得ディレクトリおよびログファイル名
メッセージログ 稼働ログ
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjmessage?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjmessage?.log
ログ稼働ログ
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjlogger.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjlogger.log
ユーザログ Webサーブレットログ
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\web_servlet?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/web_servlet?.log
ユーザ出力ログ
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\user_out?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/user_out?.log
ユーザエラーログ
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\user_err?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/user_err?.log
JavaVMの保守情報およびガーベージコレクションのログ
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\javalog??.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/javalog??.log
例外ログ 障害発生時の例外情報
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjexception?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjexception?.log
保守用ログ 保守情報

Version 6互換モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjmaintenance?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjmaintenance?.log

Version 7モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\CC\maintenance\cjmaintenance?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/CC/maintenance/cjmaintenance?.log
コンソールメッセージ

Version 6互換モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjconsole?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjconsole?.log

Version 7モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\CC\maintenance\cjconsole?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/CC/maintenance/cjconsole?.log
EJBコンテナの保守情報

Version 6互換モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjejbcontainer?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjejbcontainer?.log

Version 7モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\CC\maintenance\cjejbcontainer?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/CC/maintenance/cjejbcontainer?.log
Webコンテナの保守情報

Version 6互換モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjwebcontainer?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjwebcontainer?.log

Version 7モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\CC\maintenance\cjwebcontainer?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/CC/maintenance/cjwebcontainer?.log
起動プロセス標準出力情報

Version 6互換モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjstdout.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjstdout.log

Version 7モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\CC\maintenance\cjstdout.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/CC/maintenance/cjstdout.log
起動プロセス標準出力情報バックアップ

Version 6互換モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjstdout_save.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjstdout_save.log

Version 7モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\CC\maintenance\cjstdout_save.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/CC/maintenance/cjstdout_save.log
起動プロセス標準エラー情報

Version 6互換モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjstderr.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjstderr.log

Version 7モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\CC\maintenance\cjstderr.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/CC/maintenance/cjstderr.log
起動プロセス標準エラー情報バックアップ

Version 6互換モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cjstderr_save.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cjstderr_save.log

Version 7モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\CC\maintenance\cjstderr_save.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/CC/maintenance/cjstderr_save.log
終了プロセス情報

Version 6互換モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\cj_shutdown?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/cj_shutdown?.log

Version 7モード
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\CC\maintenance\cj_shutdown?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/CC/maintenance/cj_shutdown?.log
リソースアダプタの保守用ログ −
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\connectors\リソースアダプタの表示名?.log
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/connectors/リソースアダプタの表示名?.log
TPBrokerのトレース TPBrokerのトレース情報
  • Windowsの場合
    <ejb.server.log.directoryキーの値>\TPB 配下
  • UNIXの場合
    <ejb.server.log.directoryキーの値>/TPB 配下

（凡例）
−：該当しない。

(5)　記述例

(6)　注意事項

[目次][前へ][次へ]

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.