Cosminexus アプリケーションサーバ V8 機能解説 拡張編

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

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:[+|-]HitachiExplicitMemoryCompatibleToV8 Explicitメモリブロックを確保する方法を,08-00と同様にするかどうか指定します。08-50以降の新機能を利用しないで,08-00で動作するアプリケーションをそのまま08-50で動作させる場合,このオプションを有効にします。 -XX:-HitachiExplicitMemoryCompatibleToV8
-XX:HitachiExplicitHeapMaxSize Explicitヒープ領域の最大サイズを設定します。(単位:バイト) -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アプリケーション用オプション定義ファイル)」を参照してください。