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

Cosminexus アプリケーションサーバ V8　リファレンス定義編(サーバ定義)

[目次]

[索引]

[前へ]

[次へ]

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

＜この節の構成＞: (1)　形式; (2)　ファイルの格納先; (3)　機能; (4)　指定できるキー; (5)　add.jvm.argで指定できるJavaVMオプション; (6)　記述例; (7)　注意事項

(1)　形式

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

　
<キー名称> = <値>

指定方法

改行までが値になります。
#で始まる行はコメントとみなされます。
値が存在しない行を定義した場合，その行は無視されます。
値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。

（例）　<キー名称> = <値> #<コメント>

実行時の文字エンコーディングと異なる文字エンコーディングでは記述できません。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusのインストールディレクトリ>\CC\server\usrconf\ejb\<サーバ名称>\
UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

(3)　機能

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

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

(4)　指定できるキー

指定できるキーとデフォルト値を次の表に示します。「VR」とは，パラメタが導入・変更されたアプリケーションサーバのバージョンです。

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

キー名称	内容	デフォルト	VR
add.jvm.arg	指定されたオプションを使ってJavaVMを起動します。なお，システムプロパティを指定したい場合は，"-D"を利用しないで，usrconf.propertiesファイルに指定します。複数のオプションを指定する場合，同じキー名称を使用して，次のように複数回指定してください。（指定例） add.jvm.arg= -Xms256m add.jvm.arg= -Xmx512m なお，次のように複数のオプションを指定できません。指定をした場合，JavaVMの初期化に失敗します。（指定例） add.jvm.arg=-Xms256m -Xmx512m add.jvm.argで指定できるJavaVMのオプションについては，「2.3(5)(a)　J2EEサーバのadd.jvm.argで指定できるJavaVMオプション」を参照してください。	デフォルト値については「2.3(5)(b)　J2EEサーバでのJavaVMオプションのデフォルト値」を参照してください。	－
add.class.path	コンテナ拡張ライブラリ用のJARを指定します。なお，スペースを含むパスを指定する場合，パスをダブルクォーテーション（"）で囲む必要はありません。また，ダブルクォーテーションでの指定は有効となりません。	なし	－
add.library.path^※1	JNI用の共有ライブラリを指定します。コンテナ拡張ライブラリがJNIを利用する場合だけ指定します。	なし	－
cpp.library.version	プロセス内で使用するlibstdc++ライブラリのバージョンを指定します。なお，このキーは，Linux用です。指定できる文字列を次に示します。 5： libstdc++.so.5ライブラリを使用します。 6： libstdc++.so.6ライブラリを使用します。 Red Hat Enterprise Linux 4，またはRed Hat Enterprise Linux 5の場合，x64ネイティブ版を使用するときは「6」を，それ以外のときは「5」か「6」を設定できます。 Red Hat Enterprise Linux 6の場合，設定できるのは「6」だけです。 Red Hat Enterprise Linux以外のプラットフォームで設定しても無効です。	x64ネイティブ版を使用する場合 6 それ以外を使用する場合 5	－
ejb.public.directory	指定されたディレクトリをJ2EEサーバの作業ディレクトリとしてJ2EEサーバを開始します。J2EEサーバのカレントディレクトリを次に示します。 Windowsの場合 <Cosminexus作業ディレクトリ>\ejb\<サーバ名称> UNIXの場合 <Cosminexus作業ディレクトリ>/ejb/<サーバ名称> ディレクトリ名称は絶対パスで指定してください。指定できる文字は，半角英数字，アンダースコア「_」，またはハイフン「-」です。パス長は，アプリケーションサーバの作業ディレクトリの見積もり式で算出した範囲内で指定できます。J2EEサーバの作業ディレクトリについては，マニュアル「Cosminexus アプリケーションサーバシステム構築・運用ガイド」の「7.10　J2EEサーバの作業ディレクトリ」を参照してください。	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	指定されているディレクトリをログファイル^※2の出力先として使用します。パス長は，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互換モードに変更した場合，保守用のログファイルを各モードの出力先に移動しません。ログファイルの出力モードを変更したあと，出力先変更前の保守用のログファイルは必要に応じて削除してください。^※2	7	－
ejb.server.log.stdout.filesize	cjstdout.logファイルのサイズの上限値を指定します。	1048576	－
ejb.server.log.stderr.filesize	cjstderr.logファイルのサイズの上限値を指定します。	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	－

（凡例）

－：08-00より前のバージョンを示します。

注※1: cjstartsvコマンドまたはcjstartwebコマンドの実行時にadd.library.pathとOSの環境変数（LIBPATHなど）が両方設定されていた場合，add.library.pathの設定が優先されます。

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

ログの種類	内容	ログ取得ディレクトリおよびログファイル名
メッセージログ	稼働ログ	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
イベントログ	JavaVMの明示管理ヒープ機能イベントログ	Windowsの場合 <ejb.server.log.directoryキーの値>\ehjavalog??.log UNIXの場合 <ejb.server.log.directoryキーの値>/ehjavalog??.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)　add.jvm.argで指定できるJavaVMオプション

add.jvm.argで指定できるJavaVMのオプションおよびJ2EEサーバでのデフォルト値について説明します。

(a)　J2EEサーバのadd.jvm.argで指定できるJavaVMオプション

J2EEサーバのadd.jvm.argで指定できるJavaVMのオプションについて説明します。JavaVMのオプションには標準で指定できるオプションと，日立固有のJavaVM拡張オプションがあります。また，JavaVMのオプションは使用するサーバによってデフォルト値が異なります。日立固有のJavaVM拡張オプションの詳細については，「19.1　日立固有のJavaVM拡張オプションの一覧」を参照してください。Java HotSpot VMのオプションの詳細については「19.5　Cosminexusで指定できるJava HotSpot VMのオプション」を参照してください。

J2EEサーバのadd.jvm.argで指定できるJava HotSpot VMのオプションを次に示します。

-agentlib:<libname>[=<options>]
-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>
-Xrunhndlwrap
-agentlib:hndlwrap2

(b)　J2EEサーバでのJavaVMオプションのデフォルト値

J2EEサーバでのJavaVMオプションのデフォルト値を示します。

-Xms256m
-Xmx512m
-XX:PermSize=128m
-XX:MaxPermSize=128m
-XX:NewRatio=2
-XX:SurvivorRatio=8
-XX:HitachiJavaLog:<ejb.server.log.directory>
-XX:HitachiJavaLogFileSize=4m
-XX:+HitachiOutOfMemoryStackTrace
-XX:-HitachiThreadDumpToStdout
-XX:+HitachiOutOfMemoryAbort
-XX:+HitachiJavaClassLibTrace
-XX:HitachiJavaClassLibTraceLineSize =1024
-XX:+HitachiLocalsSimpleFormat
-XX:+HitachiTrueTypeInLocals
-XX:+HitachiLocalsInStackTrace
-XX:+HitachiVerboseGC
-XX:+HitachiVerboseGCPrintCause
-XX:+HitachiOutputMilliTime
-XX:+HitachiUseExplicitMemory
-XX:HitachiExplicitHeapMaxSize=64m
-XX:HitachiExplicitMemoryLogLevel:normal
-XX:HitachiExplicitMemoryJavaLog:<ejb.server.log.directory>
-XX:HitachiExplicitMemoryJavaLogFileSize=4m
-XX:-HitachiAutoExplicitMemory
-XX:+HitachiExplicitMemoryAutoReclaim
-XX:-HitachiExplicitMemoryCompatibleToV8
-XX:+HitachiOutOfMemoryHandling

(6)　記述例

Windowsの場合

# java vm options 
add.jvm.arg=-Xms256m 
add.jvm.arg=-Xmx512m 
add.jvm.arg=-XX:PermSize=128m
add.jvm.arg=-XX:MaxPermSize=128m
add.jvm.arg=-XX:+HitachiVerboseGC
add.jvm.arg=-XX:HitachiVerboseGCIntervalTime=600
　
# ejb public directory 
ejb.public.directory=c:\workdir
　
# ejb.server.log.directory
ejb.server.log.directory=c:\logdir\servername

UNIXの場合

# java vm options 
add.jvm.arg=-Xms256m 
add.jvm.arg=-Xmx512m 
add.jvm.arg=-XX:PermSize=128m
add.jvm.arg=-XX:MaxPermSize=128m
add.jvm.arg=-XX:+HitachiVerboseGC
add.jvm.arg=-XX:HitachiVerboseGCIntervalTime=600
　
# ejb public directory 
ejb.public.directory=/opt/workdir
　
# ejb.server.log.directory
ejb.server.log.directory=/CClogs/server/servername
　
# ejb.server.corefilenum
ejb.server.corefilenum=3

(7)　注意事項

コマンドプロンプトで設定されているCLASSPATH環境変数は，J2EEサーバには渡りませんが，そのほかの環境変数（PATHなど）は渡ります。
OSのロケールと異なる文字エンコーディングで記述しないでください。また，OSのロケールにUTF-8を使用する場合，BOM付きUTF-8では記述しないでください。
usrconf.propertiesとusrconf.cfgのadd.jvm.argの-Dに同じキーが指定されている場合は，usrconf.propertiesの値が優先されます。
usrconf.cfgで設定されていないJavaVMのオプションはJavaVMのデフォルト値になります。
次に示すプロパティは"-D"で指定できません。
- java.endorsed.dirs
- java.security.policy
- java.class.path
- java.library.path

All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.