8.11.1 明示管理ヒープ機能を利用するための共通の設定(JavaVMオプションの設定)

ここでは,明示管理ヒープ機能を利用するための共通の設定について説明します。明示管理ヒープ機能を使用するための共通の設定は,JavaVMのオプションに設定します。

<この項の構成>
(1) 設定する内容
(2) 定義例

(1) 設定する内容

JavaVMのオプションは,設定対象になるサーバまたはコマンドによって設定方法が異なります。

J2EEサーバまたはバッチサーバの場合は,簡易構築定義ファイルで実施します。明示管理ヒープ機能の定義は,簡易構築定義ファイルの論理J2EEサーバ(j2ee-server)の<configuration>タグ内に指定します。cjclstartapコマンドで動作させるJavaアプリケーションの場合は,Javaアプリケーション用オプション定義ファイル(usrconf.cfg)で定義します。

明示管理ヒープ機能のJavaVMオプションの定義について次の表に示します。

表8-14 明示管理ヒープ機能のJavaVMオプションの定義

JavaVMオプション設定内容デフォルト値
-XX:[+|-]HitachiUseExplicitMemory明示管理ヒープ機能を使用するかどうかを設定します。サーバまたはコマンドによって異なります。表8-15を参照してください。
-XX:[+|-]HitachiAutoExplicitMemory明示管理ヒープ機能の自動配置機能を使用するかどうかを設定します。-XX:-HitachiAutoExplicitMemory
-XX:HitachiAutoExplicitMemoryFile: <文字列>明示管理ヒープの自動配置機能を使用する場合に利用する,自動配置設定ファイルのパスを指定します。空文字
-XX:[+|-]HitachiExplicitMemoryAutoReclaim明示管理ヒープ機能の自動解放機能を使用するかどうかを指定します。-XX:+HitachiExplicitMemoryAutoReclaim
-XX:[+|-]HitachiExplicitMemoryCompatibleToV8Explicitメモリブロックを確保する方法を,08-00と同様にするかどうか指定します。08-50以降の新機能を利用しないで,08-00で動作するアプリケーションをそのまま08-50で動作させる場合,このオプションを有効にします。-XX:-HitachiExplicitMemoryCompatibleToV8
-XX:HitachiExplicitHeapMaxSizeExplicitヒープ領域の最大サイズを設定します。(単位:バイト)-XX:HitachiExplicitHeapMaxSize =64m
-XX:HitachiExplicitMemoryLogLevel:<文字列><文字列>に明示管理ヒープ機能で出力するイベントログのログレベルを設定します。
次のどれかを指定します。
  • none
  • normal
  • verbose
  • debug
-XX:HitachiExplicitMemoryLogLevel:normal
-XX:HitachiExplicitMemoryJavaLog:<文字列><文字列>に明示管理ヒープ機能で出力するイベントログの出力先パス名を指定します。Windowsの場合
-XX:HitachiExplicitMemoryJavaLog:<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名>¥logs
UNIXの場合
-XX:HitachiExplicitMemoryJavaLog:/opt/Cosminexus/CC/server/public/ejb/<サーバ名>/logs
-XX:HitachiExplicitMemoryJavaLogFileSize=<整数値><整数値>にイベントログのファイルサイズを指定します。(単位:バイト)-XX:HitachiExplicitMemoryJavaLogFileSize =4m
注※
見積もりについては,マニュアル「Cosminexus アプリケーションサーバ システム設計ガイド」の「7.10 Explicitヒープのチューニング」を参照してください。

サーバまたはコマンドごとの-XX:[+|-]HitachiUseExplicitMemoryオプションのデフォルト値を次の表に示します。

表8-15 -XX:[+|-]HitachiUseExplicitMemoryオプションのデフォルト値

サーバまたはコマンドの種類デフォルトの設定
新規インストール時バージョンアップ時
J2EEサーバ有効無効
バッチサーバ無効無効
Webコンテナサーバ
SFOサーバ
cjclstartapコマンド無効無効
(凡例)
有効:明示管理ヒープ機能がデフォルトで有効になっています。
無効:明示管理ヒープ機能がデフォルトで無効になっています。
-:明示管理ヒープ機能は使用できません。
注※
SFOサーバでは,明示管理ヒープ機能を有効にしても意味がありません。新規インストールの場合も,Smart Composer機能,セットアップウィザードまたは運用管理ポータルを使用して構築した場合は,無効になります。サーバ管理コマンドを使用して構築する場合は,無効にすることを推奨します。

指定するJavaVMオプション,および簡易構築定義ファイルで指定するタグの詳細は,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(2) 定義例

J2EEサーバまたはバッチサーバの場合,簡易構築定義ファイルまたは構成変更定義ファイルで定義します。論理J2EEサーバのJ2EEサーバ用オプション定義を設定するパラメタに設定してください。

簡易構築定義ファイルでの定義例を次に示します。

簡易構築定義ファイルでの定義例

<param-name>add.jvm.arg</param-name>
<param-value>-Xms512m</param-value>
<param-value>-Xmx512m</param-value>
<param-value>-XX:+HitachiUseExplicitMemory</param-value>
<param-value>-XX:HitachiExplicitHeapMaxSize=64m</param-value>

cjclstartapコマンドで動作させるJavaアプリケーションの場合は,Javaアプリケーション用オプション定義ファイル(usrconf.cfg)で定義します。

Javaアプリケーション用オプション定義ファイル(usrconf.cfg)での定義例を次に示します。

オプション定義ファイル(usrconf.cfg)での定義例

add.jvm.arg=-Xms512m
add.jvm.arg=-Xmx512m

add.jvm.arg=-XX:+HitachiUseExplicitMemory
add.jvm.arg=-XX:HitachiExplicitHeapMaxSize=64m

簡易構築定義ファイルについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6 簡易構築定義ファイル」を参照してください。Javaアプリケーション用オプション定義ファイル(usrconf.cfg)については,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「15.2 usrconf.cfg(Javaアプリケーション用オプション定義ファイル)」を参照してください。