| |
JMSサーバー: 構成: 全般
構成オプション 詳細な構成オプション 関連タスク 関連トピック
JMSサーバーは、自身に割り当てられた、JMSモジュール内のキューおよびトピック用の管理コンテナとして機能します。JMSサーバーの最も重要な役割は、JMSサーバーの宛先が受信するすべての永続メッセージに使用される永続ストアに関する情報を管理し、また、JMSサーバーの宛先で作成される恒久サブスクライバの状態を管理することです。
このページでは、このJMSサーバーの全般的な構成パラメータを定義します。
構成オプション
名前 説明 名前 このJMSサーバーの名前。
MBean属性:
JMSServerMBean.Name永続ストア このJMSサーバーが永続メッセージを格納するファイルまたはデータベース。指定しない場合、JMSサーバーでは、ターゲットの各WebLogic Serverインスタンス上で構成されているデフォルトの永続ストアが使用されます。JMSサーバーでストアが構成されている場合、構成されたストアを使用して永続メッセージが格納されます。
指定するディスクベースのファイル・ストアまたはJDBCでアクセス可能なデータベース・ストアは、このJMSサーバーと同じサーバー、クラスタまたは移行可能なターゲット・インスタンスにターゲット指定する必要があります。複数のJMSサーバーを含む同じWebLogic Serverインスタンス上の複数サービスは、同じ永続ストアを共有できます。各サービスの永続的なデータは別々に保管されます。
PersistentStoreを指定する場合、非推奨のStoreフィールドは設定しないでください。PersistentStoreフィールドとStoreフィールドのいずれも設定しない場合、JMSサーバーは、ターゲットのWebLogic Serverインスタンスのデフォルト永続ストアを使用して永続的なメッセージングをサポートします。
値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
MBean属性:
JMSServerMBean.PersistentStoreページング・ディレクトリ JMSサーバーのメッセージ本文のサイズが、メッセージ・バッファ・サイズを超過した場合に、メッセージ本文が書き込まれる場所を指定します。
指定されていない場合、メッセージはドメインのルート・ディレクトリの
server-nameサブディレクトリ内にある、デフォルトのtmpディレクトリに書き込まれます。たとえば、domain-name/servers/server-name/tmpのようになります。ここで、domain-nameは使用しているドメインのルート・ディレクトリです。パフォーマンスを最高にするには、このディレクトリを、JMSサーバーの永続ストアが使用するディレクトリとは別のものにする必要があります。
値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
MBean属性:
JMSServerMBean.PagingDirectoryページング・ファイル・ロックの有効化 OSのファイル・ロックが使用されているかどうかを判断します。
ファイル・ロック保護が有効なとき、別のストア・インスタンスがすでにストア・ファイルを開いていると、ストアの起動に失敗します。複数のストア・インスタンスが同じファイルを開くことを防ぐ手順が揃っていないかぎり、この設定を無効にしないでください。ファイル・ロックは必須ではありませんが、同じディレクトリで2つの同名のファイル・ストア・インスタンスが動作したときに発生する破損を防ぐのに役立ちます。この設定は、プライマリ・ファイルおよびキャッシュ・ファイルの両方に適用されます。
値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
メッセージ・バッファ・サイズ このJMSサーバーが、メッセージ本文をディスクに書き込む前に格納するために使用可能なメモリー量(バイト単位)。メッセージ本文は、JMSサーバーによってディスクに書き込まれると、メモリーからクリアされます。
値 -1 (デフォルト)は、サーバーがJVMの最大ヒープ・サイズに基づいて自動的にサイズを決定することを示します。このデフォルトは、最大ヒープ・サイズの3分の1か、512MBのうち小さい方のサイズに設定されます。
バッファが大きくなるほど、多くのメッセージがキューまたはトピックに待機している際にJMSでより多くのメモリーが消費されます。このバッファ・サイズを超えると、JMSはメモリー使用量をバッファ・サイズ未満に抑えようとして、PagingDirectoryで指定したディレクトリに、メッセージ本文を書き込むことがあります。
バッファ・サイズを超えても、JMSサーバーは新しいメッセージを受信し続けます。そのため、メッセージ受信速度がディスクへの書込み速度を上回る場合は、メモリー不足に陥るおそれがあります。メッセージ負荷の大きいユーザーが、できるかぎり高い可用性をサポートするには、割り当てまたはしきい値を設定してフロー制御を有効にする必要があります。
ページングは、常にサポートされています。
MBean属性:
JMSServerMBean.MessageBufferSize最小値:
-1最大値:
9223372036854775807一時的な宛先をホスト このJMSサーバーを一時宛先のホストに使用できるかどうかを指定します。
このフィールドが有効化されており、「一時的なテンプレート名」が定義されていなければ、このJMSサーバー上に作成される一時的な宛先では、すべてデフォルトの宛先の値を使用します。このフィールドが有効になっている場合、一時宛先の作成に使用されるJMSテンプレートは「一時的なテンプレート名」フィールドによって指定されます。このフィールドが無効になっている場合、このJMSサーバーは一時宛先をホストしません。
一時的なテンプレートを含むモジュール このJMSサーバーが一時的な宛先の作成に使用できるテンプレートを含むJMSモジュールの名前。
JMSモジュール名を入力するには、一時的なテンプレートの名前を指定する必要があります。ただし、「一時的な宛先をホスト」フィールドが無効化されている場合、モジュール名は指定できません。
一時的なテンプレート名 このJMSサーバーが一時的な宛先の作成に使用する、構成されたJMSテンプレートの名前。
テンプレート名を入力するには、このテンプレートが格納されたJMSモジュールを指定する必要があります。ただし、「一時的な宛先をホスト」フィールドが無効化されている場合、テンプレート名は指定できません。
ノート:指定したJMSテンプレートに永続ストアの値がある場合、一時的宛先では永続的なメッセージングがサポートされていないので、それらの値は無視されます。
MBean属性:
JMSServerMBean.TemporaryTemplateName有効期限スキャン間隔 このJMSサーバーでローカルの宛先の期限切れメッセージをスキャンするサイクルの間隔(秒数)。値
0に設定すると、アクティブなスキャンが無効化されます。スキャンの間隔に非常に大きな値を設定すると、事実上アクティブなスキャンは無効化されます。スキャンが無効化されても、ユーザーは期限切れのメッセージを受け取れず、他のシステム・アクティビティによって発見された期限切れメッセージは削除されます。ただし、アイドル状態の宛先(アクティブでないキューまたは接続されていない恒久サブスクライバ)にある期限切れメッセージは削除されず、そのままシステム・リソースを消費しつづけます。
期限切れメッセージのスキャンのサイクルは次のようになります。
指定した待機期間がすぎると、JMSサーバーでは、そのローカルな宛先のすべてで期限切れのメッセージをスキャンするために、別個のスレッドを割り当てます。
スキャンが完了した後には、検出されたすべての期限切れメッセージが、宛先上の指定した「有効期限ポリシー」(「破棄」、「ログ」、または「リダイレクト」)に従って処理されます。
指定された待機時間が再びすぎた後にすべてのプロセスが繰り返されます。
ノート:現在のスキャンが終わり、指定された待機時間がすぎてからでないと、新しいスキャンは開始されないため、最大スキャン待機期間にスキャンの実行にかかる時間を足した期間の間、期限切れメッセージはシステムに残ります。
MBean属性:
JMSServerMBean.ExpirationScanInterval最小値:
0最大値:
2147483647詳細な構成オプション
名前 説明 メッセージ圧縮オプション 永続ストアおよびJMSページング・ストアに対してJMSメッセージ本文の圧縮が有効な場合に使用する、メッセージ圧縮のタイプを指定します。
JDK GZIP APIを使用した
DEFAULT_COMPRESSIONレベルのメッセージ圧縮を行う場合は、GZIP_DEFAULT_COMPRESSIONを使用します。JDK GZIP APIを使用した
BEST_COMPRESSIONレベルのメッセージ圧縮を行う場合は、GZIP_BEST_COMPRESSIONを使用します。JDK GZIP APIを使用した
BEST_SPEEDレベルのメッセージ圧縮を行う場合は、GZIP_BEST_SPEEDを使用します。オープン・ソースLZFを使用したメッセージ圧縮を行う場合は、
LZFを使用します。ストアのメッセージ圧縮の有効化 JMSストアでのメッセージ本文の圧縮を有効にします。
false(デフォルト値)に設定すると、圧縮は実行されません。ページングのメッセージ圧縮の有効化 JMSページング・ストアでのメッセージ本文の圧縮(永続メッセージと非永続メッセージ)を有効にします。
false(デフォルト値)に設定すると、圧縮は実行されません。ストアの有効化 このJMSサーバーでメッセージの永続性をサポートするかどうかを指定します。
trueに設定し、JMSサーバーに構成されているストアがない場合、永続的なメッセージの格納には、ターゲットのWebLogic Serverインスタンスのデフォルト・ストアが使用されます。JMSサーバーでストアが構成されている場合、構成されたストアを使用して永続メッセージが格納されます。
falseに設定した場合、このJMSサーバーでは永続メッセージがサポートされず、かわりに永続メッセージが非永続に格下げされます。デフォルト値は
trueです。このパラメータは
falseに設定しないことをお薦めします。このフラグは、下位互換性のために利用可能とされています。値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
MBean属性:
JMSServerMBean.StoreEnabled起動時に生成を休止 このJMSサーバーでターゲット指定されている宛先でサーバーの起動時に生成を休止するかどうかを指定します。休止中は、宛先ではどのような新しいメッセージも受け取れません。
この値が
trueに設定されている場合、ホスト・サーバーのインスタンスが再起動されたすぐ後に、このJMSサーバーとそのターゲット指定された宛先は「生成の休止」状態に変更され、それらの宛先でのメッセージ生成のアクティビティが抑制されます。通常の新しいメッセージ生成のアクティビティを再開するには、後で、この値を
falseに設定してこのJMSサーバーを「生成が有効化された」状態に変更してから、JMSサーバーを再デプロイするかホストしているサーバー・インスタンスを再起動する必要があります。この値が
デフォルトに設定されている場合、個々の宛先の対応する設定に基づいて「起動時に生成を休止」に決定されます。値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
起動時に消費を休止 このJMSサーバーでターゲット指定されている宛先で起動時に消費を休止するかどうかを示します。休止中は、宛先ではどのような新しいメッセージも受け取れません。
この値が
trueに設定されている場合、ホスト・サーバーのインスタンスが起動されたすぐ後に、このJMSサーバーとそのターゲット指定された宛先は「消費の休止」状態に変更され、それらの宛先でのメッセージ消費のアクティビティが抑制されます。宛先で通常のメッセージ消費のアクティビティを許可するには、後で、この値を
falseに設定してこのJMSサーバーを「消費が有効化された」状態に変更してから、JMSサーバーを再デプロイするかホストしているサーバー・インスタンスを再起動する必要があります。この値が
デフォルトに設定されている場合、個々の宛先の対応する設定に基づいて「起動時に消費を休止」に決定されます。値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
起動時に挿入を休止 このJMSサーバーでターゲット指定されている宛先で起動時に挿入を休止するかどうかを示します。休止中は、宛先ではどのような新しいメッセージも受け取れません。
この値が
trueに設定されている場合、ホスト・サーバーのインスタンスが起動されたすぐ後に、このJMSサーバーとそのターゲット指定された宛先は「起動時に挿入を休止」状態に変更され、「処理中の」作業が完了した結果として送信されるメッセージがそれらの宛先に届かなくなります。ノート:「処理中の」作業またはメッセージの詳細な定義については、weblogic.management.runtime.JMSServerRuntimeMBean#resumeInsertionおよびweblogic.management.runtime.JMSDestinationRuntime#resumeInsertionを参照してください。
処理中の作業のメッセージが宛先に現れるようにするには、後で、この値を
falseに設定してこのJMSサーバーを「挿入が有効化された」状態に変更してから、JMSサーバーを再デプロイするかホストしているサーバー・インスタンスを再起動する必要があります。この値が
デフォルトに設定されている場合、個々の宛先の対応する設定に基づいて「起動時に挿入を休止」に決定されます。値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
永続ダウングレードの許可 永続ストアが構成されていないJMSサーバーでターゲット指定されている宛先に対して、永続メッセージを送信する場合に、JMSクライアントが例外を取得するかどうかを指定します。このパラメータは、「ストアの有効化」パラメータが無効化されている(falseの)場合にのみ有効です。
false (デフォルト)に設定した場合、ストアが構成されていないJMSサーバーに永続メッセージを送信するときに、クライアントは例外を受け取ります。trueに設定した場合、永続メッセージは非永続メッセージに格下げされます。ただし、送信処理は続行できます。
ページングの最小ウィンドウ・バッファ・サイズ JVMのアドレス空間にマップされるページング・ストア・ファイルごとのデータの最小容量(バイト単位)。最も近い2のべき乗に切り捨てられます。ネイティブの
wlfileioライブラリがロードされている場合にのみ適用されます。ページングの最大ウィンドウ・バッファ・サイズを参照してください。値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
MBean属性:
JMSServerMBean.PagingMinWindowBufferSize最小値:
-1最大値:
1073741824ページングの最大ウィンドウ・バッファ・サイズ JVMのアドレス空間にマップされるページング・ストア・ファイルごとのデータの最大容量(バイト単位)。最も近い2のべき乗に切り捨てられます。ネイティブの
wlfileioライブラリがロードされている場合にのみ適用されます。ウィンドウ・バッファはJavaヒープ・メモリーを消費しませんが、off-heap (ネイティブ)メモリーを消費します。ページング・ストアがリクエストされたバッファ・サイズを割り当てられない場合は、
PagingMinWindowBufferSizeに到達するまでより小さいバッファを割り当て、PagingMinWindowBufferSizeに到達すると失敗します。最大ウィンドウ・バッファのサイズを、その他の制約がないかぎり、最大書込みの2倍(同時に更新される複数の記録が1つの書込みとして組み合される可能性があります)およびファイル・サイズ以上に設定することをお薦めします。32ビットのJVMでは、Javaヒープとoff-heap (ネイティブ)のメモリー使用量の合計の制限を2から4 GBに設定します。
実際に割り当てられているウィンドウ・バッファ・サイズを調べるには、JMSサーバー・ランタイムMBean属性
PagingAllocatedWindowBufferBytesを参照してください。値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
MBean属性:
JMSServerMBean.PagingMaxWindowBufferSize最小値:
-1最大値:
1073741824ページングのIOバッファ・サイズ I/Oバッファのサイズ(バイト単位)で、自動的に最も近い2のべき乗に切り捨てられます。
ネイティブ
wlfileioドライバを使用できる場合、この設定はoff-heap(ネイティブ)メモリーに適用されます。ネイティブ
wlfileioドライバを使用できない場合、この設定はJAVAヒープ・メモリーに適用されます。最適な実行時パフォーマンスのために、
PagingIOBufferSizeを最大書込み(同時に更新される複数のリクエストが1つの書込みとして組み合される可能性があります)よりも大きな値に設定することをお薦めします。実際に割り当てられているoff-heap (ネイティブ)メモリー量を調べるには、JMSサーバー・ランタイムMBean属性
PagingAllocatedIOBufferBytesを参照してください。値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
MBean属性:
JMSServerMBean.PagingIoBufferSize最小値:
-1最大値:
67108864ページングの最大ファイル・サイズ ページング最大ファイル・サイズ(バイト単位)。
PagingMaxFileSize値は特定のサイズのページング・ストアを格納するために必要なファイルの数に影響します(ファイルの数=ページング・ストアのサイズ/切り上げられたMaxFileSize)。新しい記録のための領域が十分にない場合、ページング・ストアは自動的に記録の削除によって開放された領域を再利用し、自動的に個々のファイルを
PagingMaxFileSizeまで拡張します。既存のファイルに新しい記録のための領域が残っていない場合、ページング・ストアは追加ファイルを作成します。各ファイルにウィンドウ・バッファおよびファイル・ハンドルが割り当てられるため、通常少数の大きなファイルのほうが多数の小さなファイルより推奨されます。
PagingMaxFileSizeが2^24 *PagingBlockSizeより大きい場合、PagingMaxFileSizeは無視され、値は2^24 *PagingBlockSizeになります。デフォルトのPagingBlockSizeは512で、2^24 * 512は8 GBです。「ページングの最大ファイル・サイズ」はデフォルト値の1,342,177,280より大きく設定しないことをお薦めします。
値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
MBean属性:
JMSServerMBean.PagingMaxFileSize最小値:
10485760ページングのブロック・サイズ ファイルのアドレス指定可能な最小ブロック(バイト)。ネイティブ
wlfileioドライバが使用でき、ページング・ブロック・サイズがユーザーによって構成されていないとき、ストアはバッファされていない(直接) I/OとしてOS指定の最小値(範囲[512, 8192]内にある場合)を選択します。一度ページング・ストアがファイルを作成すると、そのページング・ストアのブロック・サイズは変更されません。ブロック・サイズの変更は新しいページング・ストアまたは現在のファイルが削除されたときにのみ有効です。Oracle WebLogic Serverのためのパフォーマンスおよびチューニングの永続ストアのチューニングを参照してください。
値が変更されてアクティブ化される場合、その値を反映するには、(コンソールでサーバーの再起動が必要であるという警告を受けていなくても) MBeanが割り当てられているすべてのサーバーを再起動する必要があります。
MBean属性:
JMSServerMBean.PagingBlockSize最小値:
-1最大値:
8192
|