この付録の内容は次のとおりです。
coherence-cache-config.xml
にデフォルト設定されます。サンプルの構成ディスクリプタがcoherence.jar
ライブラリのルートにパッケージ化されており、アプリケーションのクラスパス内でcoherence.jar
ファイルより前にカスタムのcoherence-cache-config.xml
ファイルが検出されないかぎり、これが使用されます。可能であれば、すべてのクラスタ・メンバーで使用するキャッシュ構成ディスクリプタを統一してください。キャッシュ構成デプロイメント・ディスクリプタ・スキーマはcoherence-cache-config.xsd
ファイルで定義します。これがcoherence-cache-config-base.xsd
ファイルをインポートし、これがさらにcoherence-config-base.xsd
ファイルをインポートします。これらのXSDファイルは、coherence.jar
ライブラリのルートおよび次のWeb URLにあります。
http://xmlns.oracle.com/coherence/coherence-cache-config/1.3/coherence-cache-config.xsd
<cache-config>
要素はキャッシュ構成ディスクリプタのルート要素であり、XSDおよびネームスペースの宣言が含まれます。たとえば:
<?xml version='1.0'?> <cache-config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.oracle.com/coherence/coherence-cache-config" xsi:schemaLocation="http://xmlns.oracle.com/coherence/coherence-cache-config coherence-cache-config.xsd">
ノート:
coherence.jar
ライブラリにあるスキーマは、xsi:schemaLocation
属性がWeb URLを参照する場合であっても、常に実行時に使用されます。
xsi:schemaLocation
属性を省略すると、スキーマ検証を無効にできます。
デフォルトの文字セットがASCIIではなくEBCDICである環境にCoherenceをデプロイする場合、デプロイメント・ディスクリプタ・ファイルがASCII形式であり、ランタイム環境にバイナリ形式でデプロイされることを確認してください。
親トピック: キャッシュ構成の要素
親トピック: キャッシュ構成の要素
使用場所: proxy-scheme
説明
acceptor-config
要素は、TCP/IPまたはHTTP (REST用)接続アクセプタの構成情報を指定します。接続アクセプタはプロキシ・サービスで使用され、Coherence*Extendクライアントからクラスタへの接続を有効にして、クライアントがクラスタに参加していなくても、クラスタ・サービスを使用できるようにします。
要素
表B-1で、acceptor-config
要素のサブ要素を説明します。
表B-1 acceptor-configのサブ要素
要素 | 必須/オプション | 説明 |
---|---|---|
オプション |
リモートのRESTクライアントからのHTTPを介した接続を受け入れる接続アクセプタの構成情報を指定します。この要素は、 |
|
オプション |
Coherence*ExtendクライアントからクラスタへのTCP/IPを介した接続を有効にする、接続アクセプタの構成情報を指定します。この要素は、 |
|
オプション |
リモートのmemcachedクライアントからのTCP/IPを介した接続を受け入れる接続アクセプタの構成情報を指定します。この要素は、 |
|
オプション |
クライアントからクラスタへの接続リソース使用量の規制に使用される構成情報を指定します。 |
|
オプション |
クライアントからクラスタへの接続の切断を検出するために接続アクセプタで使用される構成情報を指定します。 |
|
< |
オプション |
この接続アクセプタで使用するフィルタ名のリストを記述します。たとえば、 <use-filters> <filter-name>gzip</filter-name> </use-filters> |
オプション |
接続アクセプタがユーザー定義型のシリアライズおよびデシリアライズに使用する <serializer> <class-name>com.tangosol.io.pof.ConfigurablePofContext</class-name> <init-params> <init-param> <param-type>string</param-type> <param-value>my-pof-types.xml</param-value> </init-param> </init-params> </serializer> |
|
< |
オプション |
この接続アクセプタで許可される同時接続の最大数。有効な値は、正の整数および0です。値0は制限がないことを意味します。デフォルト値は0です。 |
親トピック: キャッシュ構成要素リファレンス
説明
address-provider
要素は、ソケット・アドレス情報(IPまたはDNS名およびポート)またはcom.tangosol.net.AddressProvider
インタフェースの実装のいずれかを指定します。このインタフェースは、ソケット・アドレスをプログラムで定義する方法を提供します。
推奨する方法は、オペレーション・オーバーライド・ファイルに含まれているアドレス・プロバイダ定義を参照することです。この方法により、アプリケーション構成からデプロイメント構成が切り離されます。ただし、ソケット・アドレスも、インラインに構成でき、開発時にはソケット・アドレスが一般的です。address-providerを参照してください。
次の例では、TCP/IPアクセプタがバインドされるソケット・アドレスを含むアドレス・プロバイダ定義を参照します。
<tcp-acceptor>
<address-provider>ap2</address-provider>
</tcp-acceptor>
次の例では、クラスタ上のTCP/IPアクセプタのソケット・アドレスを含むアドレス・プロバイダ定義を参照します。
<tcp-initiator>
<remote-addresses>
<address-provider>ap3</address-provider>
</remote-addresses>
</tcp-initiator>
次の例では、クラスタ上のネーム・サービスTCP/IPアクセプタのソケット・アドレスを含むアドレス・プロバイダ定義を参照します。
<tcp-initiator>
<name-service-addresses>
<address-provider>ap4</address-provider>
</name-service-addresses>
</tcp-initiator>
次の例では、TCP/IP memcachedアクセプタがバインドされるソケット・アドレスを含むアドレス・プロバイダ定義を参照します。
<memcached-acceptor>
<address-provider>ap5</address-provider>
</memcached-acceptor>
要素
表B-2で、address-provider
要素のサブ要素を説明します。
表B-2 address-providerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
この要素は、 |
< |
オプション |
アドレス・プロバイダ・インスタンスを作成するための、ファクトリ・クラスの完全修飾名を指定します。インスタンスは、 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
一致するシグネチャを持つpublicなコンストラクタが含まれる実装によってアクセス可能な初期化パラメータを指定します。初期化パラメータは、 |
|
オプション |
ソケットがバインドされるアドレス(IPまたはDNS名およびポート)を指定します。 アドレス・プロバイダ実装が |
親トピック: キャッシュ構成要素リファレンス
説明
async-store-manager
要素は、他のストア・マネージャの実装に、非同期の書込み機能を追加します。サポートされるストア・マネージャは次のとおりです。
custom-store-manager
—ストア・マネージャのカスタム実装を定義します。
bdb-store-manager
—Berkeley Database JEを使用してオンディクス・キャッシュを実装します。
nio-file-manager
—NIOを使用してメモリーマップ・ファイル・ベースのキャッシュを実装します。
実装
このストア・マネージャは、com.tangosol.io.AsyncBinaryStoreManager
クラスによって実装されます。
要素
表B-3で、async-store-manager
要素のサブ要素を説明します。
表B-3 async-store-managerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
非同期ストア・マネージャのカスタム実装を指定します。カスタム実装では、 |
オプション |
カスタムasync-store-managerの実装で使用する初期化パラメータを指定します。 |
|
オプション |
キャッシュ記憶域にBerkeley Database JEのオンディスク・データベースを使用するよう外部キャッシュを構成します。 |
|
オプション |
ストレージ・マネージャのカスタム実装を使用するよう外部キャッシュを構成します。 |
|
オプション |
キャッシュ記憶域にメモリーマップ・ファイルを使用するよう外部キャッシュを構成します。 |
|
< |
オプション |
非同期に書き込まれるキューに配置される最大バイト数を指定します。この値をゼロに設定すると、最大バイト数の実装デフォルトが使用されることを示します。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[K|k|M|m]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、1が係数として適用されます。有効な値は、正のメモリー・サイズまたは0です。デフォルト値は4MBです。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: tcp-acceptor
。
説明
この要素には、TCP/IPアクセプタを使用してクラスタへの接続が許可される、TCP/IPイニシエータ・ホストのIPアドレス・コレクションを記述します。このコレクションが空の場合、制約は課せられません。任意の数のhost-address
要素およびhost-range
要素を指定できます。
要素
表B-4で、authorized-hosts
要素のサブ要素を説明します。
表B-4 authorized-hostsのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
IPアドレスまたはホスト名を指定します。これを指定すると、host-addressが指定されたホスト、または指定されたhost-range内のホストのみがクラスタに参加できます。内容のオーバーライド属性 |
|
オプション |
IPアドレスの範囲を指定します。これを指定すると、host-addressが指定されたホスト、または指定されたhost-range内のホストのみがクラスタに参加できます。 |
|
オプション |
特定のTCP/IPイニシエータを受け入れるかどうかを確認するためTCP/IPアクセプタで使用する |
親トピック: キャッシュ構成要素リファレンス
使用場所: near-scheme
、overflow-scheme
説明
back-scheme要素は、複合キャッシュのバック層キャッシュを指定します。
要素
表B-5で、back-scheme
要素のサブ要素を説明します。
表B-5 back-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
キャッシュ・エントリの記憶域がクラスタ・ノード全体でパーティション化されるキャッシュ・スキームを定義します。 |
|
オプション |
ペシミスティック・ロックではなくオプティミスティック・ロックを使用するレプリケート・キャッシュ・スキームを定義します。 |
|
オプション |
各キャッシュ・エントリがすべてのクラスタ・ノードに格納されるキャッシュ・スキームを定義します。 |
|
オプション |
トランザクションが保証され、キャッシュ・エントリの記憶域がクラスタ・ノード全体でパーティション化されるキャッシュ・スキームを定義します。 |
|
オプション |
ローカル・キャッシュ・スキームは、インメモリー・ローカル・キャッシュを定義します。ローカル・キャッシュは一般に、他のキャッシュ・スキーム内にネストされます(ニア・スキームのフロント層としてなど)。 |
|
オプション |
外部スキームを使用すると、JVMヒープ・ベースでないキャッシュを定義することで大容量の記憶域の使用が可能になります。 |
|
オプション |
external-scheme同様、 |
|
オプション |
クラス・スキームは、任意のJavaオブジェクトをインスタンス化して、他のスキームでの使用を可能にするメカニズムを提供します。この要素を含むスキームによって、拡張の必要なクラスまたはインタフェースが指定されます。 |
|
オプション |
ジャーナルを使用してデータをフラッシュ・メモリーに格納するスキームを指定します。 |
|
オプション |
ジャーナルを使用してデータをRAMメモリーに格納するスキームを指定します。 |
|
オプション |
Coherence*Extendを使用してCoherenceクラスタ外部からのキャッシュへのアクセスを有効にするキャッシュ・スキームを定義します。 |
親トピック: キャッシュ構成要素リファレンス
説明
キャッシュ・サーバー内でのエントリの格納に使用するキャッシュのタイプを指定します。
オーバーフロー・ベースのバッキング・マップを使用する際は、対応するbackup-storage
でオーバーフローを構成することが重要です(可能であれば、backing-map
と同じスキームを使用します)。オーバーフローが設定されたパーティション・キャッシュを参照してください。
ノート:
partitioned
サブ要素は、親要素がdistributed-scheme
要素の場合にのみ使用されます。
要素
表B-6で、backing-map-scheme
要素のサブ要素を説明します。
表B-6 backing-map-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
含まれるバッキング・マップが
有効な値は |
|
オプション |
永続性環境を使用して、含まれるバッキング・マップを永続化する必要があるかどうかを指定します。この要素は、 |
|
オプション |
読取り操作でエントリの失効遅延を延長する必要があるかどうかを指定します。デフォルトでは、失効遅延は更新時にのみ延長されます。デフォルト値は |
|
オプション |
オペレーション構成ファイルに定義されている記憶域アクセスの認可者への参照を指定します。記憶域アクセス認可者は、パーティション・キャッシュによって使用され、基礎となるキャッシュ・データへのアクセスを認可します。構成されている場合、キャッシュ記憶域(バッキング・マップ)のデータのすべての読取りおよび書込みアクセスは、構成済の認可者によって検証または監査されます(あるいは両方)。 次の例では、 <storage-authorizer>auditing</storage-authorizer> storage-authorizerを参照してください。 |
オプション |
ローカル・キャッシュ・スキームは、インメモリー・ローカル・キャッシュを定義します。ローカル・キャッシュは一般に、他のキャッシュ・スキーム内にネストされます(ニア・スキームのフロント層としてなど)。 |
|
オプション |
外部スキームを使用すると、JVMヒープ・ベースでないキャッシュを定義することで大容量の記憶域の使用が可能になります。 |
|
オプション |
external-scheme同様、 |
|
オプション |
|
|
オプション |
クラス・スキームは、任意のJavaオブジェクトをインスタンス化して、他のスキームでの使用を可能にするメカニズムを提供します。この要素を含むスキームによって、拡張の必要なクラスまたはインタフェースが指定されます。 |
|
オプション |
ジャーナルを使用してデータをフラッシュ・メモリーに格納するスキームを指定します。 |
|
オプション |
ジャーナルを使用してデータをRAMメモリーに格納するスキームを指定します。 |
|
オプション |
read-write-backing-map-schemeは、永続ストアのサイズ制限されたキャッシュを提供するバッキング・マップを定義します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: distributed-scheme
。
説明
backup-storage
要素は、パーティション・キャッシュのバックアップ記憶域のタイプと構成を指定します。
要素
表B-7で、backup-storage
要素のサブ要素を説明します。
表B-7 backup-storageのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
バックアップ・データの保持に使用する記憶域のタイプを指定します。有効な値は次のとおりです。
事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
バッファの初期サイズをバイト単位で指定します。クラス名は、 (\d)+[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、Mが係数として適用されます。有効な値は、1から |
< |
オプション |
バッファの初期サイズをバイト単位で指定します。クラス名は、 (\d)+[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、Mが係数として適用されます。有効な値は、1から |
< |
オプション |
ディスク永続マネージャ( |
< |
オプション |
カスタム記憶域実装のクラス名を指定します。クラス名は、 |
< |
オプション |
|
親トピック: キャッシュ構成要素リファレンス
使用場所: external-scheme
、paged-external-scheme
、async-store-manager
ノート:
bdb-store-manager
を使用するにはBerkeley Database JE Javaクラス・ライブラリが必要です。Oracle Berkeley Database JEを参照してください。
説明
BDBストア・マネージャは、Berkeley Database JEのオンディスク埋込みデータベースを記憶域として使用する外部キャッシュの定義に使用されます。オンディスク永続キャッシュおよびディスク・ベースのオーバーフローが設定されたインメモリー・キャッシュを参照してください。
実装
このストア・マネージャは、com.tangosol.io.bdb.BerkeleyDBBinaryStoreManager
クラスによって実装され、sscom.tangosol.io.bdb.BerkeleyDBBinaryStore
クラスによって実装されるBinaryStore
オブジェクトを生成します。
要素
表B-8で、bdb-store-manager
要素のサブ要素を説明します。
表B-8 bdb-store-managerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
Berkeley Database |
オプション |
追加のBerkeley DBの構成設定を指定します。Berkeley DB Java Edition入門のJEプロパティ・ファイルを参照してください。 また、カスタム実装で使用する初期化パラメータを指定する際にも使用されます。 |
|
< |
オプション |
Berkeley Database JEのストア・マネージャがファイルを格納するルート・ディレクトリのパス名を指定します。指定しない場合、または存在しないディレクトリを指定した場合は、デフォルトの場所にある一時ディレクトリが使用されます。 |
< |
オプション |
Berkeley Database JEのストア・マネージャがデータを格納するデータベース表名を指定します。このパラメータを指定すると、 このプロパティを指定する場合は、 |
親トピック: キャッシュ構成要素リファレンス
使用場所: operation-bundling
。
説明
bundle-config
要素は、1つ以上のバンドリング可能な操作に対するバンドリング戦略の構成を指定します。
要素
表B-9で、bundle-config
要素のサブ要素を説明します。
表B-9 bundle-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
複数のスレッドに対して同時実行される呼出しを、機能的に類似した1つのバルク操作にバンドルする操作名を指定します。バルク操作は、単一の引数でなく、引数のコレクションを取ります。 有効な値は、バンドル構成のコンテキストによって異なります。<
<
いずれの場合も、すべての有効な操作に対応する |
< |
オプション |
バンドル・サイズのしきい値を指定します。バンドル・サイズがこの値に達すると、対応するバルク操作が即座に起動されます。この値は、コンテキスト固有の単位で測定されます。 有効な値は、0(バンドリングが無効)または正の値です。デフォルト値は0です。 |
< |
オプション |
個別の実行リクエストをバンドルして対応するバルク操作にまとめて渡すため、各実行リクエストに許容される最大遅延時間をミリ秒単位で指定します。指定された遅延時間内にpreferred-sizeしきい値に達した場合は、バンドルが即座に処理されます。 有効な値は正の数値です。デフォルト値は1です。 |
< |
オプション |
個別の(バンドルされない)リクエストを同時実行することが要求されるスレッドの最小数を指定します。この値を超えると、バンドラがパススルー・モードからバンドリング・モードに切り替わります。 有効な値は正の数値です。デフォルト値は4です。 |
< |
オプション |
(実行時統計に基づく)preferred-size値の自動調整を許可するかどうかを指定します。 有効な値は |
親トピック: キャッシュ構成要素リファレンス
ルート要素
説明
cache-config
要素は、キャッシュ構成ディスクリプタcoherence-cache-config.xml
のルート要素です。キャッシュ構成デプロイメント・ディスクリプタを参照してください。
高レベルのキャッシュ構成は、キャッシュ・スキームとキャッシュ・スキーム・マッピングで構成されます。キャッシュ・スキームには、(データベースでバッキングされる分散キャッシュなど)キャッシュのタイプを記述します。キャッシュのマッピングには、特定のキャッシュ名に対して使用されるスキームを定義します。
要素
表B-10で、cache-config
要素のサブ要素を説明します。
表B-10 cache-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
ファクトリ全体のデフォルト設定を定義します。 |
オプション |
イベントを処理する任意の数のイベント・インターセプタを指定します。 |
|
必須 |
キャッシュ名に基づいて、キャッシュに使用されるキャッシュ・スキームを指定します。 |
|
必須 |
クラスタ内で使用可能なキャッシュ・スキームを定義します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-scheme-mapping
説明
cache-mapping
要素によって、特定のキャッシュ名またはアプリケーションが使用するキャッシュ名パターンで使用されるcaching-schemesが指定されます。
要素
表B-11で、cache-mapping
要素のサブ要素を説明します。
表B-11 cache-mappingのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
キャッシュ名または名前のパターンを指定します。名前は、キャッシュ・ファクトリ内で一意です。スラッシュ(
キャッシュ名は複数のキャッシュ・マッピングに一致する可能性があります。その場合、ワイルドカード一致よりも完全一致が優先されます。完全一致が指定されていない場合は、最後に一致したワイルドカード・パターン(ファイルで定義された順番に基づく)が選択されます。 |
< |
必須 |
キャッシュ・スキーム名を記述します。この名前は構成ファイル内で一意です。キャッシュ・スキームはcaching-schemes要素で構成されます。 |
|
オプション |
|
|
オプション |
|
オプション |
置換可能なキャッシュ・スキーム・パラメータの指定を可能にします。キャッシュ・スキームの解析時に、形式 <cache-mapping> <cache-name>My*</cache-name> <scheme-name>my-scheme</scheme-name> <init-params> <init-param> <param-name>cache-loader</param-name> <param-value>com.acme.MyCacheLoader</param-value> </init-param> <init-param> <param-name>size-limit</param-name> <param-value>1000</param-value> </init-param> </init-params> </cache-mapping>
|
|
オプション |
特定のキャッシュのイベントを処理する任意の数のイベント・インターセプタを指定します。 |
|
|
オプション |
federated-schemeにマップされているキャッシュを統合する必要があるかどうかを指定します。有効な値は |
親トピック: キャッシュ構成要素リファレンス
使用場所: proxy-config
説明
cache-service-proxy
要素には、プロキシ・サービスによって管理されるキャッシュ・サービス・プロキシの構成情報を記述します。
要素
表B-12で、cache-service-proxy
要素のサブ要素を説明します。
表B-12 cache-service-proxyのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
|
オプション |
|
|
< |
オプション |
キャッシュ・サービス・プロキシが有効化されているかどうかを指定します。無効化されている場合、クライアントはプロキシ・キャッシュにアクセスできません。有効な値は、 |
< |
オプション |
リモート・クライアントからのロック・リクエストをプロキシ・キャッシュで許可するかどうかを指定します。有効な値は、 |
< |
オプション |
リモート・クライアントからのキャッシュ更新リクエストをプロキシ・キャッシュで禁止するかどうかを指定します。有効な値は、 |
親トピック: キャッシュ構成要素リファレンス
説明
キャッシュ・ストア・スキームは、キャッシュをバックエンドのデータ・ストアに接続するメカニズムを定義します。キャッシュ・ストア・スキームでは、読取り/書込み機能を提供するcom.tangosol.net.cache.CacheStore
インタフェース、または読取り専用のcom.tangosol.net.cache.CacheLoader
インタフェースを実装するクラスを使用します。これらのインタフェースのカスタム実装を生成して、Coherenceを様々なデータ・ストアに接続することもできます。データベースのキャッシュを参照してください。
要素
表B-13で、cachestore-scheme
要素のサブ要素を説明します。
表B-13 cachestore-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
<scheme-name> |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
<scheme-ref> |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
オプション |
キャッシュ・ストアの実装を指定します。指定されたクラスでは、次のいずれかのインタフェースを実装する必要があります。
|
|
オプション |
キャッシュ・ストアの実装としてCoherence*Extendを使用するようcachestore-schemeを構成します。 |
|
オプション |
バンドリング戦略の構成情報を指定します。 |
|
<federated-loading> |
オプション | キャッシュ・ストアからリモート参加者にロードされたエントリをフェデレーション・サービスで統合するかどうかを指定します。有効な値は |
親トピック: キャッシュ構成要素リファレンス
使用場所: cache-config
説明
キャッシュ名(または名前のパターン)とcaching-schemesとのマッピングを定義します。たとえば、名前がaccounts-
で始まるキャッシュでは分散(distributed-scheme)キャッシュ・スキームを使用し、名前がrates-
で始まるキャッシュではreplicated-scheme
キャッシュ・スキームを使用するように定義できます。
要素
表B-14は、caching-scheme-mapping
要素で定義可能なサブ要素について説明しています。
表B-14 caching-scheme-mappingのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
必須 |
キャッシュ名と、このキャッシュで使用するキャッシュ・スキームとの単一バインディングを記述します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: cache-config
説明
caching-schemes
要素は、一連のキャッシュ・スキーム要素を定義します。各キャッシュ・スキームは、キャッシュのタイプを定義します(データベースでバッキングされるパーティション・キャッシュ、LRUエビクション・ポリシーが指定されたローカル・キャッシュなど)。スキームのタイプはマッピング(「caching-scheme-mapping」を参照)を使用して実際のキャッシュにバインドされます。
要素
表B-15は、caching-schemes
要素で定義可能な各スキーム・タイプについて説明しています。
表B-15 caching-schemesのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
キャッシュ・エントリの記憶域がクラスタ・ノード全体でパーティション化されるキャッシュ・スキームを定義します。 |
|
オプション |
ペシミスティック・ロックではなくオプティミスティック・ロックを使用するレプリケート・キャッシュ・スキームを定義します。 |
|
オプション |
各キャッシュ・エントリがすべてのクラスタ・ノードに格納されるキャッシュ・スキームを定義します。 |
|
オプション |
トランザクションが保証され、キャッシュ・エントリの記憶域がクラスタ・ノード全体でパーティション化されるキャッシュ・スキームを定義します。 |
|
オプション |
on-heapキャッシュ記憶域を提供するキャッシュ・スキームを定義します。 |
|
オプション |
off-heapキャッシュ記憶域(オンディスク・キャッシュなど)を提供するキャッシュ・スキームを定義します。 |
|
オプション |
時間ベースのページングを使用してサイズ制限される、off-heapキャッシュ記憶域を提供するキャッシュ・スキームを定義します。 |
|
オプション |
サイズ制限のあるフロント層のオーバーフローで削除されたエントリが大規模なバック層キャッシュに格納される2層キャッシュ・スキームを定義します。 |
|
オプション |
キャッシュのカスタム実装を使用してキャッシュ・スキームを定義します。カスタム実装では、 |
|
オプション |
データをフラッシュ・メモリーに格納するスキームを指定します。 |
|
オプション |
データをRAMメモリーに格納するスキームを指定します。 |
|
オプション |
高速のローカル・フロント層と大規模なバック層のキャッシュで構成される2層キャッシュ・スキームを定義します。 |
|
オプション |
クラスタ・ノード全体でカスタム操作をパラレルに実行するための起動サービスを定義します。 |
|
オプション |
永続ストアのキャッシュを提供するバッキング・マップ・スキームを定義します。 |
|
オプション |
Coherence*Extendを使用してCoherenceクラスタ外部からのキャッシュへのアクセスを有効にするキャッシュ・スキームを定義します。 |
|
オプション |
Coherenceクラスタ外からCoherence*Extendを使用して起動できる起動スキームを定義します。 |
|
オプション |
Coherence*Extendを使用してクライアントにリモート接続できるプロキシ・サービス・スキームを定義します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-schemes
、local-scheme
、distributed-scheme
、replicated-scheme
、optimistic-scheme
、near-scheme
、front-scheme、overflow-scheme
、read-write-backing-map-scheme
、cachestore-scheme
、listener
、eviction-policy
、unit-calculator
説明
クラス・スキームは、任意のJavaオブジェクトをインスタンス化して、他のスキームでの使用を可能にするメカニズムを提供します。この要素を含むスキームによって、拡張の必要なクラスまたはインタフェースが指定されます。データベースのキャッシュを参照してください。
class-scheme
では、class-name
を使用して直接的に、またはclass-factory-name
およびmethod-name
を使用して間接的にオブジェクトのインスタンス化を構成できます。class-scheme
は、class-name
で構成するか、class-factory-name
とmethod-name
で構成する必要があります。
要素
表B-16で、class-scheme
要素のサブ要素を説明します。
表B-16 class-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
< |
オプション |
インスタンス化するJavaクラスの完全修飾名を記述します。このクラスは、含まれるスキームの記述に従って適切な実装クラスを拡張し、スーパークラスと完全に同一のpublicなコンストラクタのセットを宣言する必要があります。 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化でファクトリとして使用されるJavaクラスの完全修飾名を指定します。 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
一致するシグネチャを持つpublicなコンストラクタが含まれる実装によってアクセス可能な初期化パラメータを指定します。 |
親トピック: キャッシュ構成要素リファレンス
説明
外部キャッシュで使用するストア・マネージャのカスタム実装の作成および構成に使用されます。
要素
表B-17で、custom-store-manager
要素のサブ要素を説明します。
表B-17 custom-store-managerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
ストア・マネージャの実装を指定します。指定したクラスは、 |
オプション |
カスタム・ストア・マネージャの実装で使用する初期化パラメータを指定します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: cache-config
説明
defaults
要素は、ファクトリ全体のデフォルト設定を定義します。この機能は、これらの設定を明示的に定義していないすべてのサービスで使用される、シリアライザおよびソケット・プロバイダのグローバル構成を有効化します。
要素
表B-18で、defaults
要素のサブ要素を説明します。
表B-18 defaultsのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
オプション |
<serializer>pof</serializer> |
|
オプション |
ソケット・プロバイダの構成を指定するか、オペレーション・デプロイメント・ディスクリプタの <socket-provider>ssl</socket-provider> この設定で指定されるのは、Coherence*Extendサービスのソケット・プロバイダのみです。TCMPソケット・プロバイダは、オペレーション構成の<unicast-listener>要素内で指定されます。 |
親トピック: キャッシュ構成要素リファレンス
説明
distributed-scheme
は、エントリの記憶域をクラスタ・ノード全体でパーティション化するキャッシュを定義します。分散キャッシュの理解およびパーティション・キャッシュを参照してください。
クラスタ化された並列処理制御
パーティション・キャッシュでは、クラスタ全体を対象とするキーベースのロック機能がサポートされるため、更新の欠落といった従来の問題を発生させることなく、クラスタ内のデータを変更できます。明示的ロックを行わずに実行された操作もすべてアトミックですが、キャッシュに格納された値がアトミック操作間で変更されない保証はありません。
キャッシュ・クライアント
パーティション・キャッシュ・サービスでは、クラスタの総記憶域には含まれないクラスタ・ノードの概念がサポートされます。記憶域が有効化されないノードはキャッシュ・クライアントと見なされます(<local-storage>
サブ要素を参照)。
キャッシュ・パーティション
キャッシュ・エントリは複数の論理パーティションに均等にセグメント化されます(<partition-count>
サブ要素を参照)。これらのパーティションの管理の役割は、特定のパーティション・サービス(<service-name>
サブ要素を参照)を実行する、記憶域が有効化された(<local-storage>
サブ要素を参照)クラスタ・ノード間で均等に分担されます。
キー・アソシエーション
デフォルトでは、各パーティションに割り当てられた特定のエントリ・セットはアプリケーションに対して透過的になります。場合によっては、特定の関連するエントリを同じクラスタ・ノード内に保持することが有用になります。key-associator(<key-associator>
サブ要素を参照)を使用すると、関連するエントリを指定して、対応付けられたエントリをパーティション・キャッシュ・サービスで同じパーティション内(つまり、同じクラスタ・ノード上)に格納できます。キー・アソシエーションは、アプリケーション・コード内からcom.tangosol.net.cache.KeyAssociation
インタフェースを実装するキーを使用して指定することもできます。
キャッシュ記憶域(バッキング・マップ)
キャッシュの記憶域は<backing-map-scheme>
サブ要素を使用して指定します。たとえば、バッキング・マップにlocal-schemeを使用するパーティション・キャッシュでは、記憶域が有効化されたクラスタ・ノードのメモリー内にキャッシュ・エントリが格納されます。
フェイルオーバー
フェイルオーバーを目的として、構成した数のキャッシュのバックアップ(<backup-count>
サブ要素を参照)をクラスタ・ノード全体のbackup-storage(<backup-storage>
サブ要素を参照)で管理できます。各バックアップもパーティションに分割されます。可能なかぎりバックアップ・パーティションはプライマリ・パーティションと同じコンピュータには配置しません。クラスタ・ノードが突然クラスタから切断された場合は、そのパーティションの役割が自動的に既存のバックアップに再割当てされ、それらのパーティションの新しいバックアップが(リモート・ノード上に)作成されて、構成されたバックアップ数が維持されます。
パーティションの再分散
クラスタにおけるノードの参加および切断時には、バックグラウンドでパーティションの再分散が行われ、パーティション総数の管理の役割がクラスタ・ノード間で均等に分担されます。バックグラウンドでのパーティションの転送で消費される帯域幅の量は、transfer-threshold(<transfer-threshold>
サブ要素を参照)によって制御されます。
要素
表B-19で、distributed-scheme
要素のサブ要素を説明します。
表B-19 distributed-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
< |
オプション |
この分散スキームから作成されたキャッシュを管理する分散キャッシュ・サービス・インスタンスの名前を指定します。分散キャッシュ・サービス定義は、 |
|
オプション |
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
|
オプション |
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
オプション |
ユーザー定義型のシリアライズおよびデシリアライズに使用する |
|
|
オプション |
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 |
< |
オプション |
バックアップ更新をデルタ形式で圧縮するか、全体を送信するかを指定します。デルタ更新は、バックアップ・エントリの一部を表しており、プライマリ・エントリと同期させるには変更が必要です。デルタは、コンプレッサを使用して作成および適用します。デフォルト値は、
|
< |
オプション |
ノート: パーティション・キャッシュ・サービスで使用されるデーモン・スレッドの数を指定します。有効な値は、正の整数、 |
|
オプション |
デーモン・スレッドの最大数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
デーモン・スレッドの最小数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
< |
オプション |
リース所有権の精度を指定します。有効な値は次のとおりです。
値がthreadの場合、ロックはそのロックを取得したスレッドによって保持され、そのスレッドによってのみ解放されます。値がmemberの場合、ロックはクラスタ・ノードによって保持され、ロックを取得したクラスタ・ノード上で実行されるスレッドによって解放できます。デフォルト値は、 |
< |
オプション |
クラスタ・ノードをクラスタの記憶域として機能させる(つまり、パーティションを保持する)かどうかを指定します。無効化した場合、そのノードはキャッシュ・クライアントと見なされます。 有効な値は、 |
< |
オプション |
分散キャッシュ・パーティションの数を指定します。分散キャッシュ・サービスを実行している記憶域が有効なクラスタ・メンバーはそれぞれ均等な数のパーティションを管理します。 有効な値は、1と32767の間の正の整数で、素数にする必要があります。素数のリストは、 |
< |
オプション |
プライマリ・バケット分散のしきい値をキロバイト単位で指定します。パーティション・キャッシュ・サービスに新しいノードが結合する場合、またはサービスのメンバーのいずれかの結合が解除される場合、残りのノードによって、バケット所有権の再分散タスクが実行されます。このプロセスでは、所有権情報とともに既存のデータの均衡化が再実行されます。このパラメータでは、データ転送通信で優先されるメッセージ・サイズを示します。この値を低く設定すると、分散プロセスの所要時間は長くなりますが、このアクティビティ実行中のネットワーク帯域幅の使用量は軽減されます。有効な値は、ゼロより大きな整数です。デフォルト値は、 |
< |
オプション |
パーティション・キャッシュ・サービスのうち、各保存単位のバックアップ・データをキャッシュに保持するメンバーの数を指定します。この値が0になっていると、異常終了した場合にキャッシュ内のデータの一部が失われます。デフォルト値は、 |
< |
オプション |
ライトビハインドを必要としないキャッシュ内の各保存単位のバックアップ・データ(つまり、クラスタ全体がシャットダウンしても失われにくいデータ)を保持する、パーティション・キャッシュ・サービスのメンバー数を指定します。ライトビハインドが必要とマークされている保存単位は、 この要素の値は0に設定するか、要素の指定を完全に省略する必要があります。論理的な根拠として、このデータは別のデータ・ストアにバックアップされるため、書込み対象のライトビハインド・キューにデータが一時的に配置される場合を除いて、メモリー内でのバックアップは必要ありません。値0は、ライトビハインドが発生した場合に、そのデータのバックアップ・コピーが破棄されることを意味します。ただし、ライトビハインドが発生するまでは、 推奨値は0です。それ以外の場合は、この要素の指定を省略してください。 |
オプション |
パーティション・キャッシュのバックアップ記憶域のタイプと構成を指定します。 |
|
オプション |
キー間の対応付けを行い、対応付けられたキーの同一パーティションへの格納を可能にするクラスを指定します。この実装には、パラメータがゼロのpublicなコンストラクタが必要です。 |
|
オプション |
|
|
|
オプション |
パーティション・サービスでパーティション分散を管理する際に使用する戦略を指定します。デフォルト値は、
|
オプション |
|
|
< |
オプション |
タスクが実行できる時間をミリ秒単位で指定します。この時間を超過すると、ハングしたと見なされます。ノート: ポストされたタスクがまだ開始されていない場合は、ハングと見なされません。この属性は、スレッド・プールが使用されている( |
< |
オプション |
サービス・ワーカー・スレッド上で実行するリクエストのタイムアウト値をミリ秒単位で指定します。この属性は、スレッド・プールが使用されている( |
< |
オプション |
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は、 |
|
オプション |
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。指定のサービスに対して要素が指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 |
|
オプション |
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。 有効な値は次のとおりです。
|
|
オプション |
|
オプション |
バンドリング戦略の構成情報を指定します。 |
|
オプション |
キャッシュ・サーバー内でのエントリの格納に使用するキャッシュのタイプを指定します。 有効なスキームは次のとおりです。 ヒープ外バッキング・マップを使用する際は、対応する< |
|
オプション |
パーティション・キャッシュ・サービスの永続性関連の構成を指定します。 |
|
オプション |
パーティション・キャッシュ・サービス用のクォーラム・ポリシー設定を指定します。 |
|
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
< |
オプション |
|
オプション |
特定の分散サービスのすべてのキャッシュのイベントを処理する任意の数のイベント・インターセプタを指定します。 |
|
|
オプション |
パーティション・キャッシュ・サービスが、クライアントに同時に応答する際に、データを非同期にバックアップするかどうかを指定します。非同期バックアップは、多くの場合、クライアントのパフォーマンスを向上させるために使用されます。ただし、厳密なデータ整合性を必要とするアプリケーションは、そのデータが危険にさらされないように設計し、テストする必要があります。有効な値は、 |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-schemes
、distributed-scheme
、replicated-scheme
、optimistic-scheme
、near-scheme
、overflow-scheme
、read-write-backing-map-scheme
説明
外部スキームを使用すると、JVMヒープ・ベースでないキャッシュを定義することで大容量の記憶域の使用が可能になります。ローカル・キャッシュ(単一のJVMからアクセス可能)を参照してください。
実装
このスキームは、次を使用して実装されます。
com.tangosol.net.cache.SerializationMap
—サイズ制限のないキャッシュ
com.tangosol.net.cache.SerializationCache
—サイズ制限のあるキャッシュ
実装タイプは次の規則に従って選択されます。
<high-units>
サブ要素に0以外の値が指定されている場合はSerializationCache
が使用されます。
これ以外の場合はSerializationMap
が使用されます。
プラガブルなストレージ・マネージャ
外部スキームでは、プラガブルなストア・マネージャを使用して、バイナリ・キー値のペアの格納と取得を行います。サポートされるストア・マネージャは次のとおりです。
他のストア・マネージャの実装に対して非同期の書込み機能を提供するラッパー
ストア・マネージャのカスタム実装定義が可能
オンディスク・キャッシュの実装にBerkeley Database JEを使用
メモリーマップ・ファイル・ベースのキャッシュの実装にNIOを使用
サイズ制限のあるキャッシュ
このキャッシュはサイズ制限のあるキャッシュとして構成できます。これにより、キャッシュが最大許容サイズ(<high-units>
サブ要素)に達すると、自動的に小さなサイズへのプルーニングが行われます。
ノート:
ディスクベースのキャッシュに対するエビクションにはコストがかかる場合があります。その場合はpaged-external-schemeの使用を検討します。
エントリの有効期限
外部スキームでは、<expiry-delay>
サブ要素の構成に従って、値の有効期間に基づいたエントリの自動失効がサポートされます。
永続性(長期記憶域)
外部キャッシュは一般に、大きなデータ・セットの一時記憶域(たとえば、overflow-scheme
のバック層)として使用されます。ただし、Berkeley Database JEを実装すると、すべての非クラスタ化キャッシュの永続性をサポートします(bdb-store-manager
の<store-name>
サブ要素を参照してください)。クラスタ化の永続性は、distributed-scheme
のread-write-backing-map-scheme
を使用して構成します。
要素
表B-20で、external-scheme
要素のサブ要素を説明します。
表B-20 external-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
< |
オプション |
外部キャッシュのカスタム実装を指定します。カスタム実装では、次のいずれかのクラスを拡張する必要があります。
また、スーパークラスと完全に同一のpublicなコンストラクタのセットを宣言する必要があります。 |
オプション |
カスタム外部キャッシュの実装で使用する初期化パラメータを指定します。 |
|
オプション |
他のストレージ・マネージャに対して非同期のストレージ・マネージャ・ラッパーを使用するよう外部キャッシュを構成します。プラガブルなストレージ・マネージャを参照してください。 |
|
オプション |
キャッシュ記憶域にBerkeley Database JEのオンディスク・データベースを使用するよう外部キャッシュを構成します。 |
|
オプション |
ストレージ・マネージャのカスタム実装を使用するよう外部キャッシュを構成します。 |
|
オプション |
キャッシュ記憶域にメモリーマップ・ファイルを使用するよう外部キャッシュを構成します。 |
|
< |
オプション |
キャッシュのサイズ制限を指定します。この値は、プルーニングが開始されるまでキャッシュに配置できる単位の最大数を表します。別のunit calculator( |
< |
オプション |
使用する単位換算カリキュレータのタイプを指定します。単位換算カリキュレータは、特定のオブジェクトのコスト(単位)の決定に使用されます。この要素は、
|
< |
オプション |
値が |
< |
オプション |
前回の更新からエントリが期限切れとなるまでの、キャッシュでエントリが保持される期間を指定します。期限切れになったエントリはアクセス不能となり、事前に削除されます。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、秒が単位として適用されます。値0は期限がないことを意味します。デフォルト値は ノート: expiry-delayのパラメータ ( |
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
親トピック: キャッシュ構成要素リファレンス
使用場所:: caching-schemes
説明
federated-scheme
要素には、フェデレーテッド・キャッシュ・スキーム構成情報を記述します。フェデレーテッド・キャッシュとは、フェデレーションの参加者であるクラスタ間で同期可能なパーティション・キャッシュです。
要素
表B-21で、federated-scheme
要素のサブ要素を説明します。
表B-21 federated-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
< |
オプション |
このフェデレーテッド・スキームから作成されたキャッシュを管理するフェデレーテッド・キャッシュ・サービス・インスタンスの名前を指定します。フェデレーテッド・キャッシュ・サービス定義は、 |
|
オプション |
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
|
オプション |
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
オプション |
ユーザー定義型のシリアライズおよびデシリアライズに使用する |
|
|
オプション |
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 |
< |
オプション |
バックアップ更新をデルタ形式で圧縮するか、全体を送信するかを指定します。デルタ更新は、バックアップ・エントリの一部を表しており、プライマリ・エントリと同期させるには変更が必要です。デルタは、コンプレッサを使用して作成および適用します。デフォルト値は、
|
< |
オプション |
ノート: パーティション・キャッシュ・サービスで使用されるデーモン・スレッドの数を指定します。有効な値は、正の整数、 |
|
オプション |
デーモン・スレッドの最大数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
デーモン・スレッドの最小数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
< |
オプション |
リース所有権の精度を指定します。有効な値は次のとおりです。
値がthreadの場合、ロックはそのロックを取得したスレッドによって保持され、そのスレッドによってのみ解放されます。値がmemberの場合、ロックはクラスタ・ノードによって保持され、ロックを取得したクラスタ・ノード上で実行されるスレッドによって解放できます。デフォルト値は、 |
< |
オプション |
クラスタ・ノードをクラスタの記憶域として機能させる(つまり、パーティションを保持する)かどうかを指定します。無効化した場合、そのノードはキャッシュ・クライアントと見なされます。 有効な値は、 |
< |
オプション |
フェデレーテッド・キャッシュ・パーティションの数を指定します。フェデレーテッド・キャッシュ・サービスを実行している記憶域が有効なクラスタ・メンバーはそれぞれ均等な数のパーティションを管理します。 有効な値は、1と32767の間の正の整数で、素数にする必要があります。素数のリストは、 |
< |
オプション |
プライマリ・バケット分散のしきい値をキロバイト単位で指定します。フェデレーテッド・キャッシュ・サービスに新しいノードが結合する場合、またはサービスのメンバーのいずれかの結合が解除される場合、残りのノードによって、バケット所有権の再分散タスクが実行されます。このプロセスでは、所有権情報とともに既存のデータの均衡化が再実行されます。このパラメータでは、データ転送通信で優先されるメッセージ・サイズを示します。この値を低く設定すると、分散プロセスの所要時間は長くなりますが、このアクティビティ実行中のネットワーク帯域幅の使用量は軽減されます。有効な値は、ゼロより大きな整数です。デフォルト値は、 |
< |
オプション |
フェデレーテッド・キャッシュ・サービスのうち、各保存単位のバックアップ・データをキャッシュに保持するメンバーの数を指定します。この値が0になっていると、異常終了した場合にキャッシュ内のデータの一部が失われます。デフォルト値は、 |
< |
オプション |
ライトビハインドを必要としないキャッシュ内の各保存単位のバックアップ・データ(つまり、クラスタ全体がシャットダウンしても失われにくいデータ)を保持する、フェデレーテッド・キャッシュ・サービスのメンバー数を指定します。ライトビハインドが必要とマークされている保存単位は、 この要素の値は0に設定するか、要素の指定を完全に省略する必要があります。論理的な根拠として、このデータは別のデータ・ストアにバックアップされるため、書込み対象のライトビハインド・キューにデータが一時的に配置される場合を除いて、メモリー内でのバックアップは必要ありません。値0は、ライトビハインドが発生した場合に、そのデータのバックアップ・コピーが破棄されることを意味します。ただし、ライトビハインドが発生するまでは、 推奨値は0です。それ以外の場合は、この要素の指定を省略してください。 |
オプション |
フェデレーテッド・キャッシュのバックアップ記憶域のタイプと構成を指定します。 |
|
オプション |
キー間の対応付けを行い、対応付けられたキーの同一パーティションへの格納を可能にするクラスを指定します。この実装には、パラメータがゼロのpublicなコンストラクタが必要です。 |
|
オプション |
|
|
|
オプション |
フェデレーテッド・サービスでパーティション分散を管理する際に使用する戦略を指定します。デフォルト値は、
|
オプション |
|
|
< |
オプション |
タスクが実行できる時間をミリ秒単位で指定します。この時間を超過すると、ハングしたと見なされます。ノート: ポストされたタスクがまだ開始されていない場合は、ハングと見なされません。この属性は、スレッド・プールが使用されている( |
< |
オプション |
サービス・ワーカー・スレッド上で実行するリクエストのタイムアウト値をミリ秒単位で指定します。この属性は、スレッド・プールが使用されている( |
< |
オプション |
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は、 |
|
オプション |
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。指定のサービスに対して要素が指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 |
|
オプション |
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。 有効な値は次のとおりです。
|
|
オプション |
|
オプション |
バンドリング戦略の構成情報を指定します。 |
|
オプション |
キャッシュ・サーバー内でのエントリの格納に使用するキャッシュのタイプを指定します。 有効なスキームは次のとおりです。 ヒープ外バッキング・マップを使用する際は、対応する< |
|
オプション |
フェデレーテッド・キャッシュ・サービスの永続性関連の構成を指定します。 |
|
オプション |
フェデレーテッド・キャッシュ・サービス用のクォーラム・ポリシー設定を指定します。 |
|
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
< |
オプション |
|
オプション |
特定のサービスのすべてのキャッシュのイベントを処理する任意の数のイベント・インターセプタを指定します。 |
|
|
オプション |
パーティション・キャッシュ・サービスが、クライアントに同時に応答する際に、データを非同期にバックアップするかどうかを指定します。非同期バックアップは、多くの場合、クライアントのパフォーマンスを向上させるために使用されます。ただし、厳密なデータ整合性を必要とするアプリケーションは、そのデータが危険にさらされないように設計し、テストする必要があります。有効な値は、 |
|
オプション |
リモートの参加者へのレプリケーション用に、フェデレーテッド・キャッシュ・サービスの内部キャッシュに保持されるキャッシュ・エントリの最大数を指定します。これは、フェデレーション・サービスの内部キャッシュで使用されるリソースを制約するメカニズムです。high-unitsに到達すると、フェデレーション・サービスにより、リモートのすべての参加者が |
オプション |
ソケットおよびチャンネル・ファクトリの構成を指定します。 |
|
オプション |
TCP/IPサーバー・ソケットがバインドされるローカル・アドレス(IPまたはDNS名およびポート)またはプログラムでソケット・アドレスを提供する |
|
|
オプション |
フェデレーテッド・サービスで一連のクラスタ・フェデレーテッド・サービス・メンバーに接続を分散する際に使用されるプラガブルな戦略を指定します。有効な値は次のとおりです。
|
オプション |
1つ以上のトポロジ定義の構成情報を指定します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: back-scheme
、backing-map-scheme
、caching-schemes
、internal-cache-scheme
説明
flashjournal-scheme
要素には、外部のブロックベースのファイル・ストア(フラッシュ)にデータを格納するスキームの構成情報を記述します。フラッシュ・ジャーナルの動作は、フラッシュ・ジャーナル・リソース・マネージャで制御します。flashjournal-managerを参照してください。
このスキームでは、com.tangosol.net.cache.CompactSerializationCache
クラスをバッキング・マップ実装として使用し、com.tangosol.io.journal.JournalBinaryStore
を使用してバイナリ・キー値のペアのジャーナルへの格納と取得を行います。
要素
表B-22で、flashjournal-scheme
要素のサブ要素を説明します。
表B-22 flashjournal-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
< |
オプション |
簡単なシリアライズ・マップ・キャッシュのカスタム実装を指定します。カスタム実装では、 |
オプション |
カスタム・シリアライズ・マップ・キャッシュの初期化パラメータを指定します。 |
|
< |
オプション |
使用するエビクション・ポリシーのタイプを指定します。有効な値は次のとおりです。
|
< |
オプション |
キャッシュのサイズ制限を指定します。この値は、プルーニングが開始されるまでキャッシュに配置できる単位の最大数を表します。別のunit calculator( |
< |
オプション |
プルーニングを実行する際にどこまでキャッシュを小さくするかを示す単位の最小数を指定します。プルーニングによりキャッシュにこの数の単位が含まれるとはかぎりませんが、これより少ない数になることはありません。別のunit calculator( |
< |
オプション |
使用する単位換算カリキュレータのタイプを指定します。単位換算カリキュレータは、特定のオブジェクトのコスト(単位)の決定に使用されます。この要素は、
|
< |
オプション |
値が |
< |
オプション |
前回の更新からエントリが期限切れとなるまでの、キャッシュでエントリが保持される期間を指定します。期限切れになったエントリはアクセス不能となり、事前に削除されます。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、秒が単位として適用されます。値0は期限がないことを意味します。デフォルト値は ノート: expiry-delayのパラメータ ( |
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
親トピック: キャッシュ構成要素リファレンス
使用場所: near-scheme
、overflow-scheme
説明
front-scheme要素は、複合キャッシュのフロント層キャッシュを指定します。
要素
表B-23で、front-scheme
要素のサブ要素を説明します。
表B-23 front-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
ローカル・キャッシュ・スキームは、インメモリー・ローカル・キャッシュを定義します。ローカル・キャッシュは一般に、他のキャッシュ・スキーム内にネストされます(ニア・スキームのフロント層としてなど)。 |
|
オプション |
クラス・スキームは、任意のJavaオブジェクトをインスタンス化して、他のスキームでの使用を可能にするメカニズムを提供します。この要素を含むスキームによって、拡張の必要なクラスまたはインタフェースが指定されます。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: acceptor-config
説明
http-acceptor要素は、HTTPを介したリモートのRESTクライアントからの接続のアクセプタを指定します。
要素
表B-24で、http-acceptor
要素のサブ要素を説明します。
表B-24 http-acceptorのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
|
オプション |
HTTPサーバー・クラスのクラス初期化パラメータを記述します。 |
|
オプション |
ソケットおよびチャンネル・ファクトリの構成を指定します。 |
|
必須 |
HTTPサーバー・ソケットがバインドされるローカル・アドレス(IPまたはDNS名およびポート)を指定します。 |
|
オプション |
HTTPアクセプタがリソース・クラスおよびプロバイダ・クラスをロードする際に使用されるJerseyリソース構成クラスを指定します。 |
|
|
オプション |
HTTPサーバーの認証メカニズムを指定します。クライアントは、サーバーによって公開されるリソースへのアクセスを得るための前提条件として、構成済メカニズムを使用して認証を受ける必要があります。有効な値は次のとおりです。
|
親トピック: キャッシュ構成要素リファレンス
使用場所: ssl。
説明
<identity-manager>
要素には、javax.net.ssl.KeyManager
インスタンスを初期化するための構成情報を記述します。
アイデンティティ・マネージャは、そのピアへのローカル接続を認証するために使用されるキー・マテリアルの管理を行います。キー・マテリアルが使用できない場合、その接続では認証資格証明を提示できません。
親トピック: キャッシュ構成要素リファレンス
説明
<incoming-message-handler>
要素は、クライアントからクラスタへの接続リソース使用量の規制に使用される構成情報を含んでいます。接続イニシエータおよび接続アクセプタは、この情報を使用して過剰なリソースを使用する接続を事前に検知および解放します。
要素
表B-25は、incoming-message-handler
要素で定義可能な要素について説明しています。
表B-26 incoming-message-handlerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
Coherence*Extend接続で送信されるメッセージのサイズ制限を指定します。この要素の値は、次の形式で指定する必要があります。 (\d)+[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、Kが係数として適用されます。有効な値は、0から |
親トピック: キャッシュ構成要素リファレンス
説明
initiator-config
要素は、TCP/IP接続イニシエータの構成情報を指定します。接続イニシエータを使用すると、Coherence*Extendクライアントからクラスタへの接続が有効になり、クライアントがクラスタに参加していなくても、クラスタの提供するサービスを使用できるようになります。
要素
表B-27で、initiator-config
要素のサブ要素を説明します。
表B-27 initiator-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
TCP/IPを介してクラスタに接続する、接続イニシエータの構成情報を指定します。 |
|
オプション |
クライアントからクラスタへの接続リソース使用量の規制に使用される構成情報を指定します。 |
|
オプション |
クライアントからクラスタへの接続の切断を検出するために接続イニシエータで使用される構成情報を指定します。 |
|
< |
オプション |
この接続アクセプタで使用するフィルタ名のリストを記述します。たとえば、 <use-filters> <filter-name>gzip</filter-name> </use-filters> |
オプション |
ユーザー定義型のシリアライズおよびデシリアライズに使用する |
|
< |
オプション |
接続アクセプタとの接続を確立するまで待機する最大時間を指定します。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。デフォルト値は |
親トピック: キャッシュ構成要素リファレンス
使用場所: init-params
説明
インスタンス化されるときに、クラスのコンストラクタに使用されるパラメータと値を定義します。データベースのキャッシュを参照してください。
初期化パラメータは、型または名前で指定できます。<param-type>
要素を使用する場合、指定された型のオブジェクトは、<param-value>
に指定されている値でインスタンス化および初期化されます。値が<param-value>
の<param-type>
のコンストラクタがコールされ、オブジェクトがインスタンス化されます。<param-name>
要素を使用する場合、値が<param-value>
の<param-name>
のコンストラクタがコールされ、オブジェクトがインスタンス化されます。
要素
表B-28で、init-param
要素のサブ要素を説明します。
表B-28 init-paramのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
初期化パラメータの名前を指定します。たとえば: <init-param> <param-name>sTableName</param-name> <param-value>EmployeeTable</param-value> </init-param>
|
< |
オプション |
初期化パラメータのJavaタイプを指定します。サポートされている標準タイプは次のとおりです。
たとえば: <init-param> <param-type>java.lang.String</param-type> <param-value>EmployeeTable</param-value> </init-param>
|
< |
必須 |
初期化パラメータの値を指定します。この値は、パラメータのJavaタイプに固有の形式にします。 |
|
オプション |
初期化パラメータの説明を指定します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: class-scheme、cache-mapping
説明
一連の初期化パラメータを、名前と値のペアで定義します。
親トピック: キャッシュ構成要素リファレンス
使用場所: interceptor、serializer、service-failure-policy、load-balancerおよびpartition-assignment-strategy
説明
<instance>
要素には、カスタム機能をプラグインするために使用される実装クラスまたはクラス・ファクトリの構成を記述します。<param-value>
要素内に<instance>
および<class-scheme>
(または、その他のカスタム・ネームスペース)をネストするXMLを記述して、パラメータを初期化できます。
たとえば、次のJavaコードを考えてみます。
public class MyClass { public MyClass(String s, OtherClass o, int i) { ... } } public class OtherClass { public OtherClass(String s) { ... } }
次のXMLを記述して、MyClass
およびOtherClass
クラスを初期化できます。XMLでは、MyClass
クラスが文字列Hello
World
および整数42
で初期化されます。MyClass
クラス内にあるOtherClass
クラスのインスタンスは、文字列Goodbye
World
で初期化されます。
<instance> <class-name>MyClass</class-name> <init-params> <init-param> <param-value>Hello World</param-value> </init-param> <init-param> <param-value> <instance> <class-name>OtherClass</class-name> <init-params> <init-param> <param-value>Goodbye World</param-value> </init-param> </init-params> </instance> </param-value> </init-param> <init-param> <param-value>42</param-value> </init-param> </init-params> </instance>
要素
表B-30で、instance
要素のサブ要素を説明します。
表B-30 instanceのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
実装クラスの完全修飾名を指定します。 この要素は、 |
|
オプション |
実装クラス・インスタンスを作成するための、ファクトリ・クラスの完全修飾名を指定します。 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
実装クラスのクラス初期化パラメータを記述します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: interceptors
説明
interceptor
要素は、ライブ・イベントの処理を行うイベント・インターセプタと関連付けられる構成を定義します。イベント・インターセプタは、com.tangosol.net.events.EventInterceptor
インタフェースを実装します。このインタフェースは、特定のキャッシュまたはサービスに対するイベント・インターセプタの制限もサポートしています。このインタフェースは、@Interceptor
注釈のサポートも提供します。これにより、実装においてイベント・タイプに基づいてイベントのサブセットに対して登録することおよびイベント・インターセプタ識別子およびイベント・インターセプタの順序を構成することが可能になります。interceptor
要素内でインターセプタの識別子および順序付けを指定すると、この実装の設定がオーバーライドされます。
フェデレーションのインターセプタ要素
インターセプタをフェデレーション・スキーマ内で使用して、フェデレーション変更レコードを取得できます。フェデレーション・スキーム内で定義された場合、インターセプタは構成済のフェデレーテッド・キャッシュ・サービスにのみ適用されます。オペレーション・ファイルで参加者構成の一部として定義されたインターセプタは、その参加者を使用するすべてのフェデレーテッド・キャッシュ・サービスに適用されます。「参加者」を参照してください。
要素
表B-31で、interceptor
要素のサブ要素を説明します。
表B-31 interceptorのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
インターセプタの一意の識別子を指定します。 |
|
オプション |
このインターセプタを、インターセプタの連鎖の最初のインターセプタにするかどうかを指定します。有効な値は |
|
必須 |
インスタンス化するインターセプタ・クラスを指定します。インターセプタ・クラスは、 |
親トピック: キャッシュ構成要素リファレンス
説明
interceptors
要素には、任意の数のイベント・インターセプタ定義が含まれます。
要素
表B-32で、interceptors
要素のサブ要素を説明します。
表B-32 interceptorsのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
イベント・インターセプタの実装を指定します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所:: caching-schemes
説明
起動サービス(com.tangosol.net.InvocationService
)を定義します。起動サービスは、任意の数のクラスタ・ノード上でカスタム操作をパラレルに実行するために使用します。
要素
表B-33で、invocation-scheme
要素のサブ要素を説明します。
表B-33 invocation-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
< |
オプション |
このスキームからの起動を管理するサービス名を指定します。スラッシュ( |
|
オプション |
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
|
オプション |
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
オプション |
ユーザー定義型のシリアライズおよびデシリアライズに使用する |
|
|
オプション |
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 |
< |
オプション |
ノート: パーティション・キャッシュ・サービスで使用されるデーモン・スレッドの数を指定します。有効な値は、正の整数、 |
|
オプション |
デーモン・スレッドの最大数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
デーモン・スレッドの最小数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
|
オプション |
タスクが実行できる時間をミリ秒単位で指定します。この時間を超過すると、ハングしたと見なされます。ノート: ポストされたタスクがまだ開始されていない場合は、ハングと見なされません。この属性は、スレッド・プールが使用されている( |
|
オプション |
タイムアウト可能なタスク(たとえば、 |
|
オプション |
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は、 |
|
オプション |
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。指定のサービスに対して要素が指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 |
|
オプション |
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。 有効な値は次のとおりです。
|
|
オプション |
|
< |
オプション |
|
親トピック: キャッシュ構成要素リファレンス
使用場所: proxy-config
説明
invocation-service-proxy
要素には、プロキシ・サービスによって管理される起動サービス・プロキシの構成情報を記述します。
要素
表B-34で、invocation-service-proxy
要素のサブ要素を説明します。
表B-34 invocation-service-proxyのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
|
オプション |
|
|
< |
オプション |
起動サービス・プロキシが有効化されているかどうかを指定します。無効化されている場合、クライアントはプロキシ・サービスJVMで |
親トピック: キャッシュ構成要素リファレンス
使用場所: distributed-scheme
説明
キーの対応付けを決定するcom.tangosol.net.partition.KeyAssociator
の実装を指定します。これにより、関連するキーを同じパーティションに格納できます。
また、com.tangosol.net.cache.KeyAssociation
インタフェースを実装することにより、キャッシュのキーで関連付けを管理することもできます。
要素
表B-35で、key-associator
要素のサブ要素を説明します。
表B-35 key-associatorのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
|
|
オプション |
実装クラス・インスタンスを作成するための、ファクトリ・クラスの完全修飾名を指定します。 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
実装クラスのクラス初期化パラメータを記述します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: distributed-scheme
説明
キーを格納するパーティションを決定するcom.tangosol.net.partition.KeyPartitioningStrategy
の実装を指定します。
要素
表B-36で、key-partitioning
要素のサブ要素を説明します。
表B-36 key-partitioningのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
|
|
オプション |
実装クラス・インスタンスを作成するための、ファクトリ・クラスの完全修飾名を指定します。 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
実装クラスのクラス初期化パラメータを記述します。 |
親トピック: キャッシュ構成要素リファレンス
説明
key-store
要素は、SSLの実装時に使用するキー・ストア実装の構成を指定します。キー・ストア実装は、java.security.KeyStore
クラスのインスタンスです。
要素
表B-37は、key-store
要素で定義可能なサブ要素について説明しています。
表B-37 key-storeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
必須 |
キー・ストアへのUniform Resource Locator (URL)を指定します。 |
|
オプション |
キャッシュ・ストアのパスワードを指定します。 |
|
オプション |
|
親トピック: キャッシュ構成要素リファレンス
使用場所: local-scheme
、external-scheme
、paged-external-scheme
、distributed-scheme
、replicated-scheme
、optimistic-scheme
、near-scheme
、overflow-scheme
、read-write-backing-map-scheme
説明
Listener要素は、キャッシュ上で発生しているイベントの通知を受け取るcom.tangosol.util.MapListener
の実装を指定します。
要素
表B-38で、listener
要素のサブ要素を説明します。
表B-38 listenerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
必須 |
使用するlistener実装の完全なクラス名を指定します。指定したクラスは、 |
親トピック: キャッシュ構成要素リファレンス
説明
local-address
要素は、ソケットがバインドされるローカル・アドレス(IPまたはDNS名およびポート)を指定します。
<tcp-acceptor>
要素のローカル・アドレスは、Coherence*Extendクライアントからの接続を受け入れるプロキシ・サービスによって使用されるTCP/IPサーバー・ソケットを指定します。<http-acceptor>
要素のローカル・アドレスは、RESTクライアントからの接続を受け入れるために使用されるHTTPサーバー・ソケットを指定します。次の例で、サーバー・ソケットは192.168.0.2:7077
にバインドされます。
<local-address> <address>192.168.0.2</address> <port>7077</port> </local-address>
<tcp-initiator>
要素のローカル・アドレスは、クラスタ上のプロキシ・サービスに接続するためにリモート・サービスによって使用されるTCP/IPクライアント・ソケットを指定します。次の例で、クライアント・ソケットは、192.168.0.1
のポート7077
にバインドされます。
<local-address> <address>192.168.0.1</address> <port>7077</port> </local-address>
ノート:
TCP/IPアクセプタのソケット・アドレスもaddress-provider
要素を使用して定義できます。address-providerを参照してください。
要素
表B-39で、local-address
要素のサブ要素を説明します。
表B-39 local-addressのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
ソケットがリスニングおよび公開を行うアドレス(IPまたはDNS名)を指定します。アドレスがバインド・アドレスである場合、そのアドレスはサブネットおよびマスクとしてCIDR注釈を使用して(たとえば |
< |
オプション |
TCP/IPソケットがリスニングおよび公開を行うポートを指定します。有効な値は0から65535です。デフォルト値は |
|
オプション |
指定したポートがすでに使用されているためにバインドできない場合に、ポートを自動的に増分するかどうかを指定します。または、 |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-schemes
、distributed-scheme
、replicated-scheme
、optimistic-scheme
、near-scheme
、front-scheme
、overflow-scheme
、read-write-backing-map-scheme
、backing-map-scheme
説明
ローカル・キャッシュ・スキームは、インメモリー・ローカル・キャッシュを定義します。ローカル・キャッシュは一般に、他のキャッシュ・スキーム内にネストされます(near-schemeのフロント層としてなど)。ニア・キャッシュを参照してください。
実装
ローカル・キャッシュは、com.tangosol.net.cache.LocalCache
クラスによって実装されます。
外部ストアのキャッシュ
ローカル・キャッシュは外部キャッシュ・ストアによりバッキングできます。cachestore-schemeを参照してください。キャッシュ・ミスでは、バックエンドのストアまでリードスルーしてデータが取得されます。書込み可能なストアが提供されている場合は、キャッシュへの書込みがキャッシュ・ストアに伝播します。read-write-backing-map-schemeを参照してください。
サイズ制限のあるキャッシュ
このキャッシュはサイズ制限のあるキャッシュとして構成できます。これにより、キャッシュが最大許容サイズ(<high-units>
サブ要素を参照)に達すると、エビクション・ポリシー(<eviction-policy>
サブ要素を参照)に従って削除対象エントリが選択され、指定されたより小さなサイズ(<low-units>
サブ要素を参照)へのプルーニングが行われます。エントリとサイズの制限は、スキームの単位換算カリキュレータ(<unit-calculator>
サブ要素を参照)によって計算された単位で測定されます。
エントリの有効期限
ローカル・キャッシュでは、値の有効期間に基づいたエントリの自動失効がサポートされます(<expiry-delay>
サブ要素を参照)。
要素
表B-40で、local-scheme
要素のサブ要素を説明します。
表B-40 local-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
< |
オプション |
ローカル・キャッシュのカスタム実装を指定します。カスタム実装では、 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
< |
オプション |
このスキームで作成されたキャッシュを管理するサービス名を指定します。スラッシュ( |
< |
オプション |
使用するエビクション・ポリシーのタイプを指定します。有効な値は次のとおりです。
|
< |
オプション |
キャッシュのサイズ制限を指定します。この値は、プルーニングが開始されるまでキャッシュに配置できる単位の最大数を表します。別のunit calculator( |
< |
オプション |
プルーニングを実行する際にどこまでキャッシュを小さくするかを示す単位の最小数を指定します。プルーニングによりキャッシュにこの数の単位が含まれるとはかぎりませんが、これより少ない数になることはありません。別のunit calculator( |
< |
オプション |
使用する単位換算カリキュレータのタイプを指定します。単位換算カリキュレータは、特定のオブジェクトのコスト(単位)の決定に使用されます。この要素は、
|
< |
オプション |
値が |
< |
オプション |
前回の更新からエントリが期限切れとなるまでの、キャッシュでエントリが保持される期間を指定します。期限切れになったエントリはアクセス不能となり、事前に削除されます。キャッシュ・ストアを使用する場合は、期限切れエントリの読取りを試行すると、対象エントリが構成済のキャッシュ・ストア(< この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、秒が単位として適用されます。値0は期限がないことを意味します。デフォルト値は ノート: expiry-delayのパラメータ ( |
オプション |
キャッシュの対象となるストアを指定します。指定しない場合、キャッシュ・データはメモリー内にのみ配置され、そのキャッシュに対して実行された操作のみを反映します。 |
|
|
オプション |
キャッシュが |
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
親トピック: キャッシュ構成要素リファレンス
使用場所: acceptor-config
説明
memcached-acceptor
要素には、リモートmemcachedクライアントからのTCP/IPを介した接続を受け入れるアクセプタの構成情報が含まれています。アクセプタによって、memcachedクライアントはmemcachedバイナリ・プロトコルでCoherenceキャッシュを使用できるようになります。
要素
表B-41で、memcached-acceptor
要素のサブ要素を説明します。
表B-41 memcached-acceptorのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
必須 |
memcachedアクセプタに接続するmemcachedクライアントが使用するキャッシュを指定します。キャッシュ名は、キャッシュ・マッピングを使用して実際のキャッシュ・スキームに解決されます。cache-mappingを参照してください。キャッシュ名は、パーティション・キャッシュ・スキームに解決される必要があります。 |
|
オプション |
値をキャッシュに格納する際にmemcachedアクセプタが、構成済キャッシュ・サービス・シリアライザをバイパスできるかどうかを指定します。これは、Coherence*Extendとmemcachedクライアントでデータを共有する場合にのみ必要です。memcachedクライアントがオブジェクトを |
|
オプション |
memcachedアクセプタの認証メカニズムを指定します。クライアントは、サーバーによって公開されるリソースへのアクセスを得るため、構成済メカニズムを使用して認証を受けている必要があります。有効な値は、 |
オプション |
ソケットおよびチャンネル・ファクトリの構成を指定します。 |
|
必須 |
TCP/IPサーバー・ソケットがバインドされるローカル・アドレス(IPまたはDNS名およびポート)またはプログラムでソケット・アドレスを提供する |
親トピック: キャッシュ構成要素リファレンス
使用場所: tcp-initiator
説明
name-service-addresses
要素には、1つ以上のネーム・サービスTCP/IPアクセプタのアドレス(IPまたはDNS名およびポート)を記述します。TCP/IPイニシエータは、この情報を使用してリモート・クラスタとの接続を確立します。TCP/IPイニシエータは、記載されたアドレスをすべて試すか、接続が確立されるまで、アドレスへの接続をランダムに試行します。Oracle Coherenceリモート・クライアントの開発のリモート・キャッシュの定義を参照してください。
要素
表B-42で、name-service-addresses
要素のサブ要素を説明します。
表B-42 name-service-addressesのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
ネーム・サービスTCP/IPアクセプタがリスニングを行うアドレス(IPまたはDNS名およびポート)を指定します。 |
|
オプション |
ネーム・サービスTCP/IPアクセプタがリスニングを行うアドレス(IPまたはDNS名およびポート)またはそのアドレスを提供する |
|
|
オプション |
IPアドレスまたはDNS名を指定します。バインド・アドレスは、ローカル・アドレスにルーティングする外部NATアドレスでもかまいません。ただし、両方のアドレスで同じポートを使用する必要があります。 |
親トピック: キャッシュ構成要素リファレンス
使用場所:: caching-schemes
説明
near-scheme
は、バック層キャッシュのサブセットをキャッシュするフロント層で構成される2層キャッシュを定義します。一般にフロント層は高速でサイズ制限があり、バック層は低速ですが大容量のキャッシュです。一般的なデプロイメントでは、フロント層にはローカル・キャッシュが、バック層には分散キャッシュが使用されます。その結果、大規模なパーティション・キャッシュの一部がローカル・インメモリーにキャッシュされ、非常に高速な読取りアクセスが実現されます。ニア・キャッシュの理解およびニア・キャッシュを参照してください。
次の点に注意してください。
フロント・マップは、バック・キャッシュが破棄されるとリセットされます。
フロント・マップは、すべての記憶域ノードが停止するとリセットされます。
フロント・マップは、拡張クライアントがプロキシで切断され、無効化戦略がnone
に設定されるとリセットされます。プロキシ切断後もフロント・マップを引き続き機能させたい場合は、無効化戦略としてnone
を使用します。
実装
ニア・スキームは、com.tangosol.net.cache.NearCache
クラスによって実装されます。
フロント層の無効化
<invalidation-strategy>
サブ要素は、ニア・キャッシュのフロント層とバック層の同期を保持するために使用される戦略を定義します。この戦略に従って、バック層で発生した特定のイベントをリスニングしてニア・キャッシュのフロント部分を自動的に更新(または無効化)するようニア・キャッシュが構成されます。
要素
表B-43で、near-scheme
要素のサブ要素を説明します。
表B-43 near-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
< |
オプション |
ニア・キャッシュのカスタム実装を指定します。カスタム実装では、 |
オプション |
カスタム・ニア・キャッシュの実装用の初期化パラメータを指定します。 |
|
必須 |
フロント層キャッシュとして使用するキャッシュを指定します。 |
|
必須 |
フロント層キャッシュとして使用するキャッシュを指定します。 |
|
< |
オプション |
フロント層およびバック層の同期を保持するために使用される戦略を指定します。有効な値は次のとおりです。
|
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
< |
オプション |
autostart要素は、キャッシュ・サーバー(つまり、 |
親トピック: キャッシュ構成要素リファレンス
説明
記憶域にメモリーマップ・ファイルを使用する外部ストアを構成します。
実装
このストア・マネージャは、com.tangosol.io.nio.MappedStoreManager
クラスによって実装されます。このクラスで作成されるBinaryStore
オブジェクトは、com.tangosol.io.nio.BinaryMapStore
のインスタンスです。
要素
表B-44で、nio-file-manager
要素のサブ要素を説明します。
表B-44 nio-file-managerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
ローカル・キャッシュのカスタム実装を指定します。カスタム実装では、 |
オプション |
カスタムnio-file-managerの実装で使用する初期化パラメータを指定します。 |
|
< |
オプション |
バッファの初期サイズをメガバイト単位で指定します。この要素の値は、次の形式で指定する必要があります。 (\d)+[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、Mが係数として適用されます。有効な値は、1から |
< |
オプション |
バッファの最大サイズをバイト単位で指定します。この要素の値は、次の形式で指定する必要があります。 (\d)+[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、Mが係数として適用されます。有効な値は、1から |
< |
オプション |
マネージャがファイルを格納するルート・ディレクトリのパス名を指定します。指定しない場合、または存在しないディレクトリを指定した場合は、デフォルトの場所にある一時ファイルが使用されます。 |
親トピック: キャッシュ構成要素リファレンス
説明
operation-bundling
要素は、特定のバンドリング戦略の構成情報を指定します。
バンドリングとは、複数の個別の操作をいくつかの束(バンドル)にまとめるプロセスです。これは次のような場合に役立ちます。
複数のスレッド上に連続的な操作ストリームがパラレルに存在する場合。
各操作の(ネットワークまたはデータベースに関連した)待機時間が比較的長い場合。
待機時間を(コレクション・サイズに応じて)線形に増加させることなく、単一引数のかわりに引数のコレクションを取る、機能的に類似したバルク操作が存在する場合。
ノート:
他のバンドリング・アルゴリズム同様、リソース使用率とリクエストの平均待機時間との間には必然的なトレードオフが存在します。この機能を有効化することによって全体的なアプリケーションのパフォーマンスが向上するか低下するかは、各アプリケーションの使用パターンによって異なります。
操作バンドリングは、キャッシュ・ストアの操作に影響します。操作バンドリングを構成すると、熟成エントリが1つのみの場合であっても、CacheStore.storeAll()
メソッドが常にコールされます。
実装の詳細は、com.tangosol.net.cache.AbstractBundler
を参照してください。
要素
表B-45は、operation-bundling
要素のサブ要素について説明しています。
表B-45 operation-bundlingのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
必須 |
1つ以上のバンドル可能な操作を記述します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-schemes、near-scheme、overflow-scheme
オプティミスティック・スキームは、サービスを実行するすべてのクラスタ・ノードに自身の全データを完全にレプリケートするキャッシュを定義します。オプティミスティック・キャッシュの理解を参照してください。
オプティミスティック・ロック
replicated-schemeやdistributed-schemeのキャッシュと異なり、オプティミスティック・キャッシュでは並行処理制御(ロック)がサポートされません。エントリに対する個々の操作はアトミックですが、キャッシュに格納された値がアトミック操作間で変更されない保証はありません。並行処理制御がないため、オプティミスティック・キャッシュでは非常に高速な書込み操作が実現されます。
キャッシュ記憶域(バッキング・マップ)
キャッシュの記憶域は<backing-map-scheme>
サブ要素を使用して指定します。たとえば、バッキング・マップにlocal-scheme
を使用するオプティミスティック・キャッシュでは、キャッシュ・エントリがメモリー内に格納されます。
要素
表B-46で、optimistic-scheme
要素のサブ要素を説明します。
表B-46 optimistic-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
|
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
|
オプション |
このスキームで作成されたキャッシュを管理するサービス名を指定します。スラッシュ( |
|
オプション |
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
オプション |
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
オプション |
ユーザー定義型のシリアライズおよびデシリアライズに使用する |
|
|
オプション |
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 |
< |
オプション |
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は、 |
|
オプション |
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。指定のサービスに対して要素が指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 |
|
オプション |
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。 有効な値は次のとおりです。
|
|
オプション |
|
オプション |
キャッシュ・サーバー内でのエントリの格納に使用するキャッシュのタイプを指定します。有効な値は次のとおりです。 キャッシュの一貫性を確保するため、オプティミスティック・キャッシュのバッキング・マップでは、キャッシュ・エントリのロードにリードスルー・パターンを使用しません。キャッシュ・サービスの外部でキャッシュアサイド・パターンを使用するか、クラスタ化キャッシュのリードスルーをサポートする |
|
|
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
< |
オプション |
|
親トピック: キャッシュ構成要素リファレンス
説明
outgoing-message-handler
は、クライアントからクラスタへの接続の切断を検出するために使用される構成情報を指定します。コネクションレスのプロトコルを使用する接続イニシエータおよび接続アクセプタでは、この情報は、切断された接続に割り当てられていたリソースを検出および解放するために必要です。この情報は、接続指向のイニシエータおよびアクセプタでも、接続の切断を検出するための追加メカニズムとして使用できます。
要素
表B-47で、outgoing-message-handler
要素のサブ要素を説明します。
表B-47 outgoing-message-handlerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
pingリクエストの間隔を指定します。pingリクエストは接続の整合性を保証するために使用されます。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。値0はpingリクエストがないことを意味します。デフォルト値は0です。 |
< |
オプション |
基礎となる接続を閉じるまでの、ハートビートpingリクエストへのレスポンスに対する最大待機時間を指定します。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 |
< |
オプション |
Coherence*Extend接続で送信されるメッセージのサイズ制限を指定します。この要素の値は、次の形式で指定する必要があります。 (\d)+[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、Kが係数として適用されます。有効な値は、0から |
< |
オプション |
レスポンス・メッセージがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、リクエストが破棄されます。 ノート: プロキシはExtendクライアントにリクエストを送信しないため、プロキシ・サービス・アクセプタはこの要素を使用しません。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。デフォルト値は30です。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-schemes
、distributed-scheme
、replicated-scheme
、optimistic-scheme
、read-write-backing-map-scheme
説明
overflow-scheme
は、高速でサイズ制限のあるフロント層キャッシュと、低速でより大容量のバック層キャッシュで構成される2層キャッシュを定義します。サイズ制限のあるフロント層が一杯になると、削除されたエントリが透過的にバック層に移動されます。キャッシュ・ミス発生時は、エントリがバック層からフロント層に移動することがあります。一般的なデプロイメントでは、フロント層にはlocal-schemeが、バック層にはexternal-schemeが使用され、JVMヒープよりも容量の大きい高速のローカル・キャッシュが実現されます。このようなデプロイメントでは、local-scheme
要素のhigh-units
およびeviction-policy
によってフロント・キャッシュからバック・キャッシュへのエントリの転送(削除)が制御されます。
ノート:
標準のキャッシュ記憶域におけるオーバーフローに依存することはお薦めしません。これは、構成された容量を記憶域所要量が一時的に超えた場合に、削除処理に付随するデータの損失を回避する目的でのみ使用してください。一般に、オーバーフローのオンディスク記憶域は空のままにします。
実装
com.tangosol.net.cache.OverflowMap
またはcom.tangosol.net.cache.SimpleOverflowMap
のいずれかにより実装されます。詳細はexpiry-enabled
を参照してください。
エントリの有効期限
オーバーフローでは、<expiry-delay>
サブ要素の構成に従って、値の有効期間に基づいたエントリの自動失効がサポートされます。
要素
表B-48で、overflow-scheme
要素のサブ要素を説明します。
表B-48 overflow-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
< |
オプション |
オーバーフロー・キャッシュのカスタム実装を指定します。カスタム実装は、 |
オプション |
カスタム・オーバーフロー・キャッシュの実装で使用する初期化パラメータを指定します。 |
|
必須 |
フロント層キャッシュとして使用するキャッシュを指定します。 |
|
必須 |
バック層キャッシュの作成に使用する cache-scheme を指定します。 |
|
< |
オプション |
キャッシュ・ミス情報を保持するcache-schemeを指定します。expiry-enabled( |
< |
オプション |
|
< |
オプション |
前回の更新からエントリが期限切れとなるまでの、キャッシュでエントリが保持される期間を指定します。期限切れになったエントリはアクセス不能となり、事前に削除されます。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、秒が単位として適用されます。値0は期限がないことを意味します。デフォルト値は ノート: expiry-delayのパラメータ ( |
< |
オプション |
|
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-schemes
、distributed-scheme
、replicated-scheme
、optimistic-scheme
、near-scheme
、overflow-scheme
、read-write-backing-map-scheme
説明
external-scheme同様、paged-external-schemes
は、より大きな記憶域容量の使用を可能にする非JVMヒープ・ベースのキャッシュを定義します。paged-externalスキームは、ページングの方法を使用して、LRUエビクションを最適化します。シリアライズ・ページ・キャッシュを参照してください。
実装
このスキームは、com.tangosol.net.cache.SerializationPagedCache
クラスによって実装されます。
ページング
キャッシュ・エントリは一連のページに対して維持されます。各ページは、構成済のストレージ・マネージャから取得した別々のcom.tangosol.io.BinaryStore
です。プラガブルなストレージ・マネージャを参照してください。ページは作成時点において現在のページと見なされ、すべての書込み操作がこのページに対して実行されます。構成された時間間隔(<page-duration>
サブ要素を参照)で現在のページが閉じられ、新しい現在のページが作成されます。特定のキーの読取り操作は、対象キーが格納された最後のページに対して実行されます。ページ数が構成済の最大値(<page-limit>
サブ要素を参照)を超過すると、最も古いページが破棄され、そのページが閉じられてから更新されていないアイテムは削除されます。
たとえば、1ページ当たり10分の間隔でキャッシュを構成し、最大値を6ページとすると、最大で1時間分のエントリがキャッシュされることになります。ページングでは、キャッシュ・エントリの削除や消去が行われるため、ストレージ・マネージャに対する削除操作を個別に実行する必要がなくなり、パフォーマンスが向上します。そのかわり、キャッシュはそれらのエントリに対する参照を解放するのみとなり、すべてのページ・エントリに使用されていた記憶域の解放は最終的に1回の操作で行われるページ全体の破棄に依存します。
プラガブルなストレージ・マネージャ
外部スキームはプラガブルなストア・マネージャを使用して、ページの作成と破棄、およびこれらのページ内のエントリへのアクセスを実行します。サポートされるストア・マネージャは次のとおりです。
async-store-manager
—他のストア・マネージャの実装に対して非同期の書込み機能を提供するラッパー。
custom-store-manager
—ストア・マネージャのカスタム実装を定義します。
bdb-store-manager
—Berkeley Database JEを使用してオンディクス・キャッシュを実装します。
nio-file-manager
—NIOを使用してメモリーマップ・ファイル・ベースのキャッシュを実装します。
永続性(長期記憶域)
外部ページ・キャッシュは、大きなデータ・セットの一時記憶域(たとえば、overflow-schemeのバック層)として使用されます。これらのキャッシュは長期記憶域(永続)としては使用されず、JVMの存続期間を超えて保持できません。クラスタ化の永続性は、distributed-schemeのread-write-backing-map-schemeを使用して構成します。非クラスタの永続キャッシュが必要な場合は、永続性(長期記憶域)を参照してください。
要素
表B-49で、paged-external-scheme
要素のサブ要素を説明します。
表B-49 paged-external-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
< |
オプション |
外部ページ・キャッシュのカスタム実装を指定します。カスタム実装では、 |
オプション |
カスタム外部ページ・キャッシュの実装で使用する初期化パラメータを指定します。 |
|
オプション |
他のストレージ・マネージャに対して非同期のストレージ・マネージャ・ラッパーを使用するよう外部ページ・キャッシュを構成します。プラガブルなストレージ・マネージャを参照してください。 |
|
オプション |
キャッシュ記憶域にBerkeley Database JEのオンディスク・データベースを使用するよう外部ページ・キャッシュを構成します。 |
|
オプション |
ストレージ・マネージャのカスタム実装を使用するよう外部ページ・キャッシュを構成します。 |
|
オプション |
キャッシュ記憶域にメモリーマップ・ファイルを使用するよう外部ページ・キャッシュを構成します。 |
|
< |
オプション |
キャッシュが管理する最大ページ数を指定します。この数を超えると、古いページは破棄されます。有効な値は、ゼロまたは2 - 3600の間の正の整数です。デフォルト値は0です。 |
< |
オプション |
キャッシュ内のページが現在のページと見なされる時間を秒単位で指定します。この時間を超過すると、ページは閉じられ、現在のページが新規に作成されます。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、秒が単位として適用されます。有効な値は、ゼロまたは5 - 604800秒(1週間)の値です。デフォルト値は0です。 |
<listener> |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
親トピック: キャッシュ構成要素リファレンス
使用場所: distributed-scheme
説明
partitioned-quorum-policy-scheme
要素には、パーティション・キャッシュ・サービス用のクォーラム・ポリシー設定を記述します。
要素
表B-50で、partitioned-quorum-policy-scheme
要素のサブ要素を説明します。
表B-50 partitioned-quorum-policy-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
|
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
パーティション分散を行うために必要な、パーティション・サービスの記憶域メンバーの最小数を指定します。有効な値は負でない整数です。 |
|
オプション |
失われたプライマリ・パーティションをバックアップからリストアするために必要な、パーティション・サービスの記憶域メンバーの最小数を指定します。有効な値は負でない整数です。 |
|
オプション |
読取りリクエストを処理するために必要な、キャッシュ・サービスの記憶域メンバーの最小数を指定します。読取りリクエストとは、キャッシュの状態や内容を変化させないリクエストです。有効な値は負でない整数です。 |
|
オプション |
書込みリクエストを処理するために必要な、キャッシュ・サービスの記憶域メンバーの最小数を指定します。書込みリクエストとは、キャッシュの状態や内容を変化させる可能性のあるリクエストです。有効な値は負でない整数です。 |
|
オプション |
孤立パーティションを永続記憶域からリカバリするか、空のパーティションを割り当てる(永続記憶域が利用できないか、失われている場合)ために必要な、パーティション・キャッシュ・サービスの記憶域メンバーの最小数を指定します。有効な値は負でない整数です。値を0にすると、動的リカバリ・ポリシーが有効になります。これにより、すべての永続化状態の可用性が確保され、最新の正常なクラスタ・メンバーシップ情報に基づいてリカバリに必要なメンバー数が決定されます。デフォルト値は0です。 |
|
オプション |
オペレーション構成ファイルに構成されているhost-addressのセットへの参照を指定します。孤立パーティションを永続記憶域からリカバリするか、空のパーティションを割り当てる(永続記憶域が利用できないか、失われている場合)ために、host-addressのセットを記憶域メンバーのセットで表す必要があります。 次の例では、 <partitioned-quorum-policy-scheme> <recovery-hosts>persistence-host-list</recovery-hosts> </partitioned-quorum-policy-scheme> 永続性のaddress-provider要素を参照してください。 ノート: |
|
オプション |
カスタム・クォーラム・ポリシーを提供するクラスを指定します。この要素は、デフォルトのクォーラム要素または クラスは、 |
|
オプション |
カスタム・アクション・ポリシー・インスタンスを作成するためのファクトリ・クラスを指定します。この要素は、デフォルトのクォーラム要素または この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
実装クラスのクラス初期化パラメータを記述します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: distributed-scheme
説明
com.tangosol.net.partition.PartitionListener
インタフェースの実装を指定します。これにより、パーティション分散イベントの受信が可能になります。
要素
表B-51で、partition-listener
要素のサブ要素を説明します。
表B-51 partition-listenerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
|
|
オプション |
実装クラス・インスタンスを作成するための、ファクトリ・クラスの完全修飾名を指定します。 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
実装クラスのクラス初期化パラメータを記述します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: distributed-scheme
説明
persistence
要素には、分散キャッシュ・サービスの永続性関連の構成を記述します。
要素
表B-53で、persistence
要素内で定義可能なサブ要素を説明します。
表B-52 persistenceのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
オペレーション構成ファイルに定義されている永続性環境構成への参照を指定します。永続性環境は、包含分散キャッシュ・サービスによって使用され、バッキング・マップの内容を永続化します。構成されている場合、永続性環境により、クラスタが再起動するか複数のメンバーが失われた後、またはオンデマンドのいずれかで、名前付きのスナップショットからキャッシュの内容を自動的にリカバリできます。 次の例では、 <persistence> <environment>environment1</environment> </persistence> persistence-environmentsを参照してください。 |
|
オプション |
オペレーション構成ファイルに定義されているスナップショット・アーカイバ定義への参照を指定します。アーカイバは、永続性スナップショットのアーカイブ、取得またはパージに使用されます。次の例では、 <persistence> <archiver>archiver1</archiver> </persistence> snapshot-archiversを参照してください。 |
|
オプション |
アクティブ永続性モードで永続性操作を実行中に、予期しない障害が発生した場合に、サービスがどのように応答するかを指定します。有効な値は次のとおりです。
|
親トピック: キャッシュ構成要素リファレンス
使用場所: ssl、identity-manager、trust-manager
説明
provider要素には、java.security.Provider
クラスを拡張するセキュリティ・プロバイダの構成情報を記述します。
要素
表B-53は、provider
要素で定義可能なサブ要素について説明しています。
表B-53 providerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
クラス名は、この要素を使用するか、 |
|
オプション |
この要素は、 |
|
オプション |
この要素は、 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
プロバイダ実装のクラス初期化パラメータを記述します。 この要素は、 |
親トピック: キャッシュ構成要素リファレンス
使用場所: proxy-scheme
。
説明
proxy-config
要素は、プロキシ・サービスによって管理されるクラスタ化サービス・プロキシの構成情報を指定します。サービス・プロキシは、リモート・クライアント(接続アクセプタを使用してクラスタに接続)と、リモート・クライアントが使用するクラスタ化サービスとの間を媒介します。
要素
表B-54で、proxy-config
要素のサブ要素を説明します。
表B-54 proxy-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
プロキシ・サービスによって管理されるキャッシュ・サービス・プロキシの構成情報を指定します。 |
|
オプション |
プロキシ・サービスによって管理される起動サービス・プロキシの構成情報を指定します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: proxy-scheme
説明
proxy-quorum-policy-scheme
要素には、プロキシ・サービス用のクォーラム・ポリシー設定を記述します。
要素
表B-56で、proxy-quorum-policy-scheme
要素のサブ要素を説明します。
表B-55 proxy-quorum-policy-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
|
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
クライアント接続を可能にするために必要な、プロキシ・サービスのメンバーの最小数を指定します。 値は負ではない整数である必要があります。 |
|
オプション |
カスタム・クォーラム・ポリシーを提供するクラスを指定します。この要素は、 クラスは、 |
|
オプション |
カスタム・アクション・ポリシー・インスタンスを作成するためのファクトリ・クラスを指定します。この要素は、 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
実装クラスのクラス初期化パラメータを記述します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-schemes
。
説明
proxy-scheme
要素には、クラスタ化サービスの構成情報を記述します。これにより、Coherence*Extendクライアントは、クラスタへの接続が可能になり、クラスタに参加しなくてもクラスタ化サービスを使用できるようになります。
要素
表B-56で、proxy-scheme
要素のサブ要素を説明します。
表B-56 proxy-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
< |
オプション |
サービスの名前を指定します。スラッシュ( |
|
オプション |
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
オプション |
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
|
オプション |
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 |
< |
オプション |
ノート: パーティション・キャッシュ・サービスで使用されるデーモン・スレッドの数を指定します。有効な値は、正の整数、 |
|
オプション |
デーモン・スレッドの最大数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
デーモン・スレッドの最小数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
< |
オプション |
タスクが実行できる時間をミリ秒単位で指定します。この時間を超過すると、ハングしたと見なされます。ポストされ、まだ開始されていないタスクはハングしたとみなされません。この属性は、スレッド・プールが使用されている( |
< |
オプション |
サービス・ワーカー・スレッド上で実行するリクエストのタイムアウト値をミリ秒単位で指定します。この属性は、スレッド・プールが使用されている( |
< |
オプション |
他の同名のプロキシに送信されるリクエストがくるまでプロキシが待機する最大時間を指定します。プロキシ間でリクエストが送信されることはないため、この要素を使用しないでください。 |
|
オプション |
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。指定のサービスに対して要素が指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 |
|
オプション |
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。 有効な値は次のとおりです。
|
|
オプション |
|
必須 |
接続アクセプタの構成を記述します。サービスでは、この接続アクセプタを使用してCoherence*Extendクライアントからの接続を受け入れ、クライアントがクラスタに参加していなくても、クラスタの提供するサービスを使用できるようにします。 |
|
オプション |
このサービスによって管理されるクラスタ化サービス・プロキシの構成を記述します。 |
|
|
オプション |
プロキシ・サービスで一連のクラスタ・プロキシ・サービス・メンバーにクライアント接続を分散する際に使用されるプラガブルな戦略を指定します。有効な値は次のとおりです。
|
オプション |
プロキシ・サービス用のクォーラム・ポリシー設定を指定します。 |
|
< |
オプション |
|
親トピック: キャッシュ構成要素リファレンス
使用場所: back-scheme
、backing-map-scheme
、caching-schemes
、internal-cache-scheme
説明
ramjournal-scheme
要素には、バッファ(ジャーナル・ファイル)にインメモリーでデータを格納するスキームの構成情報を記述します。RAMジャーナルの動作は、RAMジャーナル・リソース・マネージャで制御します。ramjournal-managerを参照してください。
このスキームでは、com.tangosol.net.cache.CompactSerializationClass
クラスをバッキング・マップ実装として使用し、com.tangosol.io.journal.JournalBinaryStore
を使用してバイナリ・キー値のペアのジャーナルへの格納と取得を行います。
要素
表B-57で、ramjournal-scheme
要素のサブ要素を説明します。
表B-57 ramjournal-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
< |
オプション |
簡単なシリアライズ・マップ・キャッシュのカスタム実装を指定します。カスタム実装では、 |
オプション |
カスタム・シリアライズ・マップ・キャッシュの初期化パラメータを指定します。 |
|
< |
オプション |
使用するエビクション・ポリシーのタイプを指定します。有効な値は次のとおりです。
|
< |
オプション |
キャッシュのサイズ制限を指定します。この値は、プルーニングが開始されるまでキャッシュに配置できる単位の最大数を表します。別のunit calculator( |
< |
オプション |
プルーニングを実行する際にどこまでキャッシュを小さくするかを示す単位の最小数を指定します。プルーニングによりキャッシュにこの数の単位が含まれるとはかぎりませんが、これより少ない数になることはありません。別のunit calculator( |
< |
オプション |
使用する単位換算カリキュレータのタイプを指定します。単位換算カリキュレータは、特定のオブジェクトのコスト(単位)の決定に使用されます。この要素は、
|
< |
オプション |
値が |
< |
オプション |
前回の更新からエントリが期限切れとなるまでの、キャッシュでエントリが保持される期間を指定します。期限切れになったエントリはアクセス不能となり、事前に削除されます。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、秒が単位として適用されます。値0は期限がないことを意味します。デフォルト値は ノート: expiry-delayのパラメータ ( |
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
親トピック: キャッシュ構成要素リファレンス
説明
read-write-backing-map-schemeは、永続ストアのサイズ制限されたキャッシュを提供するバッキング・マップを定義します。データ・ソースのキャッシュを参照してください。
実装
read-write-backing-map-scheme
は、com.tangosol.net.cache.ReadWriteBackingMap
クラスによって実装されます。
外部ストアのキャッシュ
読取り/書込みバッキング・マップでは、外部の永続キャッシュ・ストア(<cachestore-scheme>
サブ要素を参照)でバッキングされるキャッシュを保持します。キャッシュ・ミスでは、バックエンドのストアまでリードスルーしてデータが取得されます。書込み可能なストアが提供されている場合は、キャッシュへの書込みがキャッシュ・ストアに伝播します。
リフレッシュアヘッド・キャッシング
これが有効な場合(<refreshahead-factor>
サブ要素を参照)、失効時期が近い、最近アクセスされたエントリがキャッシュによって監視され、キャッシュ・ストアから非同期でリロードされます。アイテムは定期的に期限切れになるため、アプリケーションでキャッシュ・ストアの読取りが遅くなる事態を回避できます。
ライトビハインド・キャッシング
これが有効な場合(<write-delay>
サブ要素を参照)、キャッシュによるバックエンド・キャッシュ・ストアへの書込みが遅延されます。これにより、書込みをより効率的な更新ブロックにバッチ化できます(<write-batch-factor>
サブ要素を参照)。これは、クライアント・スレッドとは非同期に実行されます。
要素
表B-58で、read-write-backing-map-scheme
要素のサブ要素を説明します。
表B-58 read-write-backing-map-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
< |
オプション |
読取り/書込みバッキング・マップのカスタム実装を指定します。カスタム実装では、 |
< |
必須 |
エントリのキャッシュに使用されるcache-schemeを指定します。有効な値は次のとおりです。 |
< |
オプション |
1回の |
< |
オプション |
キャッシュ・ミス情報を保持するcache-schemeを指定します。miss-cacheは、キャッシュ・ストアに見つからなかったキーの追跡に使用されます。キャッシュ・ストアにキーがないことを事前に知っておくことで、一部の操作がより迅速に実行されます。処理に時間がかかる可能性のあるキャッシュ・ストアへの問合せを回避できるからです。サイズが制限されたスキームを使用すると、キャッシュされるキャッシュ・ミスの数を制御できます。値を指定しないと、キャッシュ・ミスのデータは保持されません。有効な値は次のとおりです。 |
オプション |
キャッシュするストアを指定します。指定しない場合、キャッシュ・データは内部キャッシュにのみ配置され( |
|
< |
オプション |
読取り専用にするかどうかを指定します。 |
< |
オプション |
ライトビハインド・キューに関して、キャッシュ・ストアへの非同期書込みの遅延期間を指定します。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、秒が単位として適用されます。0の場合、キャッシュ・ストアへの同期書込み(キューイングなし)が行われます。それ以外の場合、キャッシュ内の値が最後に更新されてから指定された期間だけ遅延して、書込みが非同期で実行されます。デフォルト値は0です。 この要素は、 |
< |
オプション |
ライトビハインド・キューに関して、キャッシュ・ストアへの非同期書込みの遅延時間を秒数で指定します。0の場合、キャッシュ・ストアへの同期書込み(キューイングなし)が行われます。それ以外の場合、キャッシュ内の値が最後に更新されてから指定された秒数だけ遅延して、書込みが非同期で実行されます。 この要素は、 |
< |
オプション |
概念的には、バッチ化された更新を実行する際に、write-behindスレッドでは次のロジックが使用されます。
この要素は、非同期の書込みが有効で(つまり、write-delay要素の値が0より大きくて)、 |
< |
オプション |
追加のアクションを実行できるライトビハインド・キューのサイズを指定します。ゼロの場合、ライトビハインドの再キューは無効になります。それ以外の場合、この値は、対応するログ・メッセージの頻度を制御します。たとえば、この値が100の場合、ライトビハインド・キューのサイズが100の倍数になるたびにログ・メッセージが生成されます。有効な値は、正の整数またはゼロです。デフォルト値は0です。 |
< |
オプション |
refresh-ahead-factor要素は、キャッシュ・エントリのソフト失効時間の計算に使用されます。ソフト失効時間は、実際の失効時間より前の時点になります。これより後では、エントリへのアクセス・リクエストによって、エントリに対する非同期のロード・リクエストがスケジュール化されます。この属性は、内部キャッシュが |
< |
オプション |
(\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 |
< |
オプション |
同期のキャッシュ・ストア操作でキャッチされた例外が、コール元のスレッドに再スローされるかどうかを指定します(ネットワークを介してリモート・メンバーに送信されることもあります)。有効な値は、 |
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
親トピック: キャッシュ構成要素リファレンス
使用場所: tcp-initiator
説明
remote-addresses
要素には、1つ以上のTCP/IPアクセプタのアドレス(IPまたはDNS名とポート)を記述します。TCP/IPイニシエータは、この情報を使用してリモート・クラスタのプロキシ・サービスとの接続を確立します。TCP/IPアクセプタは、proxy-scheme要素内で構成されます。TCP/IPイニシエータは、記載されたアドレスをすべて試すか、接続が確立されるまで、アドレスへの接続をランダムに試行します。Oracle Coherenceリモート・クライアントの開発のリモート・キャッシュの定義を参照してください。
ノート:
name-service-addresses
要素は、リモート・クラスタ上のプロキシ・サービスとの接続を確立するためにも使用できます。name-service-addressesを参照してください。
次の構成例は、イニシエータに対して192.168.0.2:7077
および192.168.0.3:7077
にランダムに接続するよう指示します。
<remote-addresses> <socket-address> <address>192.168.0.2</address> <port>7077</port> </socket-address> <socket-address> <address>192.168.0.3</address> <port>7077</port> </socket-address> </remote-addresses>
要素
表B-59で、remote-addresses
要素のサブ要素を説明します。
表B-59 remote-addressesのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
TCP/IPアクセプタがリスニングを行うアドレス(IPまたはDNS名およびポート)を指定します。複数の |
|
オプション |
TCP/IPアクセプタがリスニングを行うアドレス(IPまたはDNS名およびポート)またはそのアドレスを提供する
|
親トピック: キャッシュ構成要素リファレンス
説明
remote-cache-scheme
要素には、クラスタの外部からCoherence*Extendを使用してクラスタ化キャッシュを利用する際に必要な構成情報を記述します。
要素
表B-60で、remote-cache-scheme
要素のサブ要素を説明します。
表B-60 remote-cache-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
< |
オプション |
このスキームで作成されたキャッシュを管理するサービス名を指定します。スラッシュ( |
|
オプション |
このリモート・サービスの接続先のプロキシ・サービス名を指定します。この要素は、このリモート・サービスがネーム・サービスを使用してプロキシ・サービスを検索する場合にのみ使用します。name-service-addressesを参照してください。 この値は、プロキシ・サービスの |
オプション |
バンドリング戦略の構成情報を指定します。 |
|
必須 |
クラスタへの接続を確立するためにサービスで使用される接続イニシエータの構成を記述します。 |
|
|
オプション |
キー・アソシエーションの処理を、拡張クライアントによって行うか、クラスタ側まで遅延するかを指定します。有効な値は、 |
<listener> |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-schemes
説明
remote-invocation-scheme
要素には、最初にクラスタに参加せずにクラスタ内でタスクを実行する際に必要な構成情報を記述します。このスキームは、Coherence*Extendを使用してクラスタに接続します。
要素
表B-61で、remote-invocation-scheme
要素のサブ要素を説明します。
表B-61 remote-invocation-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
< |
オプション |
サービスの名前を指定します。スラッシュ( |
|
オプション |
このリモート・サービスの接続先のプロキシ・サービス名を指定します。この要素は、このリモート・サービスがネーム・サービスを使用してプロキシ・サービスを検索する場合にのみ使用します。name-service-addressesを参照してください。 この値は、プロキシ・サービスの |
必須 |
クラスタへの接続を確立するためにサービスで使用される接続イニシエータの構成を記述します。 |
親トピック: キャッシュ構成要素リファレンス
説明
レプリケート・スキームは、指定したサービスを実行する各クラスタ・ノードに、すべてのキャッシュ・エントリを完全にレプリケートするキャッシュを定義します。レプリケート・キャッシュの理解を参照してください。
クラスタ化された並列処理制御
レプリケート・キャッシュでは、クラスタ全体を対象とするキーベースのロック機能がサポートされるため、更新の欠落といった従来の問題を発生させることなく、クラスタ内のデータを変更できます。明示的ロックを行わずに実行された操作もすべてアトミックですが、キャッシュに格納された値がアトミック操作間で変更されない保証はありません。
キャッシュ記憶域(バッキング・マップ)
キャッシュの記憶域はbacking-map-schemeを使用して指定します(<backing-map>
サブ要素を参照)。たとえば、バッキング・マップにlocal-scheme
を使用するレプリケート・キャッシュでは、キャッシュ・エントリがメモリー内に格納されます。
要素
表B-62で、replicated-scheme
要素のサブ要素を説明します。
表B-62 replicated-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
< |
オプション |
このスキームで作成されたキャッシュを管理するサービス名を指定します。スラッシュ( |
|
オプション |
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
|
オプション |
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、 |
オプション |
ユーザー定義型のシリアライズおよびデシリアライズに使用する |
|
|
オプション |
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 |
< |
オプション |
標準的なリースの継続時間をミリ秒単位で指定します。リースがこのミリ秒数を超過すると、ロックは自動的に解放されます。期限切れが発生しないリースを指定するには、この値をゼロに設定します。この設定の目的は、スタック・スレッドを原因とするデッドロックまたはブロックが発生しないようにすることです。最長の予想ロック継続時間より高い(たとえば、トランザクション・タイムアウトより高い)値を設定する必要があります。また、 |
< |
オプション |
リース所有権の精度を指定します。有効な値は次のとおりです。
値がthreadの場合、ロックはそのロックを取得したスレッドによって保持され、そのスレッドによってのみ解放されます。値がmemberの場合、ロックはクラスタ・ノードによって保持され、ロックを取得したクラスタ・ノード上で実行されるスレッドによって解放できます。デフォルト値は、 |
< |
オプション |
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は、 |
|
オプション |
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。指定のサービスに対して要素が指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 |
|
オプション |
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。 有効な値は次のとおりです。
|
|
オプション |
|
オプション |
キャッシュ・サーバー内でのエントリの格納に使用するキャッシュのタイプを指定します。有効な値は次のとおりです。 キャッシュの一貫性を確保するため、レプリケート・キャッシュのバッキング・マップでは、キャッシュ・エントリのロードにリードスルー・パターンを使用しません。キャッシュ・サービスの外部でキャッシュアサイド・パターンを使用するか、クラスタ化キャッシュのリードスルーをサポートする |
|
< |
オプション |
キャッシュ上で発生しているイベントの通知を受け取る |
< |
オプション |
|
親トピック: キャッシュ構成要素リファレンス
使用場所: http-acceptor
説明
resource-config
要素には、com.sun.jersey.api.core.ResourceConfig
クラスを拡張するクラスの構成情報を記述します。このインスタンスは、HTTPアクセプタが、指定されたコンテキスト・パスにマップされたCoherence RESTアプリケーション用のリソース・クラスおよびプロバイダ・クラスをロードする際に使用されます。複数のリソース構成クラスを構成して、別々のコンテキスト・パスにマップできます。
要素
表B-63で、resource-config
要素のサブ要素を説明します。
表B-63 resource-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
RESTアプリケーションのルートURIパスを指定します。パスの先頭の文字は |
|
オプション |
|
親トピック: キャッシュ構成要素リファレンス
使用場所: acceptor-config、defaults、distributed-scheme、initiator-config、invocation-scheme、optimistic-scheme、replicated-scheme、transactional-scheme
説明
serializer要素には、com.tangosol.io.Serializer
実装のクラス構成情報を記述します。
serializer
要素は、シリアライザ構成への参照またはシリアライザのフル構成のいずれかを受け入れます。ベスト・プラクティスは、オペレーション構成ファイルで定義されている構成を参照する方法です。オペレーション構成ファイルには、Java用(デフォルト)とPOF用の2つのシリアライザ・クラス構成が含まれています。serializerを参照してください。
次の例では、オペレーション構成ファイル内のPOFシリアライザ定義を参照しています。
... <serializer>pof</serializer> ...
次の例は、フル・シリアライザ・クラス構成を示します。
... <serializer> <instance> <class-name>com.tangosol.io.pof.ConfigurablePofContext</class-name> <init-params> <init-param> <param-type>String</param-type> <param-value>my-pof-config.xml</param-value> </init-param> </init-params> </instance> </serializer> ...
要素
表B-64で、serializer
要素のサブ要素を説明します。
表B-64 serializerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
|
親トピック: キャッシュ構成要素リファレンス
説明
socket-address
要素は、TCP/IPアクセプタがリスニングを行うアドレスとポートを指定します。
要素
表B-65で、socket-address
要素のサブ要素を説明します。
表B-65 socket-addressのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
TCP/IPアクセプタ・ソケットがリスニングを行うIPアドレス(IPまたはDNS名)を指定します。アドレスがバインド・アドレスである場合、そのアドレスはサブネットおよびマスクとしてCIDR注釈を使用して(たとえば |
< |
必須 |
TCP/IPアクセプタ・ソケットがリスニングを行うポートを指定します。有効な値は0から65535です。デフォルト値は |
親トピック: キャッシュ構成要素リファレンス
説明
<socket-provider>
要素には、ソケットおよびチャンネル・ファクトリの構成情報を記述します。<tcp-acceptor>
要素および<tcp-initiator>
要素内で構成されるソケット・プロバイダは、Coherence*Extendで使用されます。<http-acceptor>
要素内で構成されたソケット・プロバイダは、Coherence RESTによって使用されます。<memcached-acceptor>
要素内で構成されたソケット・プロバイダは、memcachedクライアントによって使用されます。TCMPのソケット・プロバイダは、オペレーション・オーバーライドにおいて、<unicast-listener>
要素内で構成されます。
<socket-provider>
要素は、ソケット・プロバイダ構成への参照またはソケット・プロバイダのフル構成のいずれかを受け入れます。ベスト・プラクティスは、オペレーション構成ファイルで定義されている構成を参照する方法です。socket-providerを参照してください。使用可能なソケット・プロバイダは、system
(デフォルト)、ssl
、tcp
およびsdp
です。ソケット・プロバイダ構成は、id
属性名を使用して参照されます。次の例は、事前定義のSSLソケット・プロバイダ構成を参照します。
<socket-provider>ssl</socket-provider>
事前構成済オーバーライド値はcoherence.socketprovider
です。
要素
表B-66は、socket-provider
要素で定義可能なサブ要素について説明しています。
表B-66 socket-providerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
JVMのデフォルトのソケットおよびチャンネル実装のインスタンスを作成するソケット・プロバイダを指定します。 |
|
オプション |
SSLを使用するソケットおよびチャンネル実装を作成するソケット・プロバイダを指定します。 |
|
オプション |
TCPベースのソケットおよびチャンネル実装を生成するソケット・プロバイダを指定します。 |
|
オプション |
JVMおよび基礎となるネットワーク・スタックでSDPがサポートされている場合、SDPベースのソケットおよびチャネルの実装を生成するソケット・プロバイダを指定します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: socket-provider
説明
<ssl>
要素には、SSLを使用するソケットおよびチャンネル実装を作成するソケット・プロバイダの構成情報を記述します。
要素
表B-67は、ssl
要素で定義可能なサブ要素について説明しています。
表B-67 sslのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
SSLソケット・プロバイダによって作成されたソケットおよびチャンネル実装が使用するプロトコルの名前を指定します。デフォルト値は |
|
オプション |
セキュリティ・プロバイダ・インスタンスの構成を指定します。 |
|
オプション |
|
オプション |
アイデンティティ・マネージャ・インスタンスを初期化するための構成情報を指定します。 |
|
オプション |
トラスト・マネージャ・インスタンスを初期化するための構成情報を指定します。 |
|
|
オプション |
|
オプション |
SSLの委譲プロバイダの構成情報を指定します。有効な値は、 |
親トピック: キャッシュ構成要素リファレンス
使用場所: acceptor-config
説明
tcp-acceptor
要素は、Coherence*ExtendクライアントからのTCP/IPを介した接続を受け入れる接続アクセプタの構成情報を指定します。Oracle Coherenceリモート・クライアントの開発のプロキシ・アドレスの明示的な構成を参照してください。
要素
表B-68で、tcp-acceptor
要素のサブ要素を説明します。
表B-68 tcp-acceptorのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
ソケットおよびチャンネル・ファクトリの構成を指定します。 |
|
オプション |
TCP/IPサーバー・ソケット(接続アクセプタによって開かれる)がバインドされるローカル・アドレス(IPまたはDNS名およびポート)を指定します。 |
|
オプション |
TCP/IPサーバー・ソケットがバインドされるローカル・アドレス(IPまたはDNS名およびポート)またはプログラムでソケット・アドレスを提供する
|
|
< |
オプション |
|
< |
オプション |
TCP遅延(Nagleアルゴリズム)が、TCP/IPソケットで有効にされているかどうかを示します。有効な値は、 |
< |
オプション |
基礎となるTCP/IPソケット・ネットワーク受信バッファのサイズを構成します。受信バッファ・サイズを増やすと、大量の接続におけるネットワークI/Oのパフォーマンスが向上します。受信バッファ・サイズを減らすと、未処理の受信データが削減されます。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[K|k|M|m|G|g]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、1が係数として適用されます。デフォルト値は、オペレーティング・システムに依存します。 |
< |
オプション |
基礎となるTCP/IPソケット・ネットワーク送信バッファのサイズを構成します。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[K|k|M|m|G|g]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、1が係数として適用されます。デフォルト値は、オペレーティング・システムに依存します。 |
< |
オプション |
TCP/IPサーバー・ソケットの未処理キューのサイズを構成します。有効値は正の整数です。デフォルト値は、オペレーティング・システムに依存します。 |
|
オプション |
TCP/IPソケットの (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。デフォルト値は |
オプション |
このTCP/IPアクセプタへの接続が許可される、TCP/IPイニシエータ・ホストのIPアドレス・コレクションです。 |
|
|
オプション |
不正なCoherence*Extendクライアント接続を検出して閉じるため、疑いのあるプロトコルを有効にするかどうかを指定します。疑いのあるプロトコルはデフォルトで有効です。 有効な値は、 |
|
オプション |
対応するクライアント接続が疑いありとマークされるまでの送信接続バックログ(バイト単位)を指定します。疑いのあるクライアント接続は、疑いがなくなるまで、またはメモリー不足からプロキシ・サーバーを保護するためにその接続が閉じられるまでモニターされます。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、1が係数として適用されます。デフォルト値は10000000です。 |
|
オプション |
対応するクライアント接続が疑いありとマークされるまでの送信接続バックログ(メッセージ単位)を指定します。疑いのあるクライアント接続は、疑いがなくなるまで、またはメモリー不足からプロキシ・サーバーを保護するためにその接続が閉じられるまでモニターされます。デフォルト値は |
|
オプション |
その時点で疑いのあるクライアント接続の疑いが晴れたと見なされる送信接続バックログ(バイト単位)を指定します。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、1が係数として適用されます。デフォルト値は2000000です。 |
|
オプション |
その時点で疑いのあるクライアント接続の疑いが晴れたと見なされる送信接続バックログ(メッセージ単位)を指定します。デフォルト値は |
|
オプション |
メモリー不足からプロキシ・サーバーを保護するため、その時点で対応するクライアント接続を閉じる必要のある送信接続バックログ(バイト単位)を指定します。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、1が係数として適用されます。デフォルト値は100000000です。 |
|
オプション |
メモリー不足からプロキシ・サーバーを保護するため、その時点で対応するクライアント接続を閉じる必要のある送信接続バックログ(メッセージ単位)を指定します。デフォルト値は |
親トピック: キャッシュ構成要素リファレンス
使用場所: initiator-config
。
説明
tcp-initiator
要素は、Coherence*Extendクライアントからリモート・クラスタへのTCP/IPを介した接続を有効にする接続イニシエータの構成情報を指定します。Oracle Coherenceリモート・クライアントの開発のリモート・キャッシュの定義を参照してください。
要素
表B-69で、tcp-initiator
要素のサブ要素を説明します。
表B-69 tcp-initiatorのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
ソケットおよびチャンネル・ファクトリの構成を指定します。 |
|
オプション |
TCP/IPクライアント・ソケット(TCP/IPイニシエータによって開かれる)がバインドされるローカル・アドレス(IPまたはDNS名およびポート)を指定します。 |
|
オプション |
1つ以上のネーム・サービスTCP/IPアクセプタのアドレス(IPまたはDNS名およびポート)を記述します。TCP/IP接続イニシエータは、この情報を使用してリモート・クラスタとの接続を確立します。 この要素は、リモート・アドレスの構成に |
|
オプション |
1つ以上のTCP/IP接続アクセプタのアドレス(IPまたはDNS名およびポート)を記述します。TCP/IP接続イニシエータは、この情報を使用してリモート・クラスタとの接続を確立します。 この要素は、 |
|
< |
オプション |
|
< |
オプション |
TCP遅延(Nagleアルゴリズム)が、TCP/IPソケットで有効にされているかどうかを示します。有効な値は、 |
< |
オプション |
基礎となるTCP/IPソケット・ネットワーク受信バッファのサイズを構成します。受信バッファ・サイズを増やすと、大量の接続におけるネットワークI/Oのパフォーマンスが向上します。受信バッファ・サイズを減らすと、未処理の受信データが削減されます。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[K|k|M|m|G|g]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、1が係数として適用されます。デフォルト値は、オペレーティング・システムに依存します。 |
< |
オプション |
基礎となるTCP/IPソケット・ネットワーク送信バッファのサイズを構成します。この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[K|k|M|m|G|g]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、1が係数として適用されます。デフォルト値は、オペレーティング・システムに依存します。 |
|
オプション |
TCP/IPソケットの (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。デフォルト値は |
親トピック: キャッシュ構成要素リファレンス
使用場所: federated-scheme
説明
topologies
要素には、1つ以上のトポロジ定義の構成情報を記述します。
親トピック: キャッシュ構成要素リファレンス
使用場所: federated-scheme
説明
topology
要素は、フェデレーテッド・スキームで使用されているトポロジを指定する場合に使用されます。トポロジは、オペレーション・オーバーライド・ファイルに構成され、フェデレーション参加者間でデータがどのように同期されるかを定義します。topology-definitionsを参照してください。
要素
表B-70で、topology
要素のサブ要素を説明します。
表B-71 topologyのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
必須 |
オペレーション・オーバーライド構成ファイルに定義されているトポロジの名前を指定します。 |
|
オプション |
リモートの参加者の宛先キャッシュ名を指定します。 |
親トピック: キャッシュ構成要素リファレンス
使用場所: caching-schemes
説明
transactional-scheme
要素は、トランザクションを保証する専用の分散キャッシュであるトランザクション・キャッシュを定義します。複数のtransactional-scheme
要素を定義して様々な構成をサポートできます。アプリケーションは、次の3つのうちのいずれかの方法でトランザクション・キャッシュを使用します。
アプリケーションは、CacheFactory.getCache()
メソッドを使用して、トランザクション・キャッシュのインスタンスを取得します。この場合、キャッシュ操作を行う際、暗黙にトランザクションが保証されます。ただし、デフォルトのトランザクション動作を変更することはできません。
アプリケーションは、明示的にトランザクション・フレームワークAPIを使用して、トランザクション・キャッシュを使用するConnection
インスタンスを作成します。この場合、キャッシュ操作はトランザクション内で行われ、アプリケーションは必要に応じてデフォルトのトランザクション動作の変更をすべて制御できます。
Java EEアプリケーションは、Coherenceリソース・アダプタを使用して、トランザクション・キャッシュを使用するトランザクション・フレームワークAPIのConnection
インスタンスを作成します。この場合、キャッシュ操作は、分散(グローバル)トランザクションの一部として参加できるトランザクション内で実行されます。アプリケーションは、一部のデフォルト・トランザクション動作を変更できます。
要素
表B-72で、transactional-scheme
要素のサブ要素を説明します。
表B-72 transactional-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。 |
< |
オプション |
継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください。 |
|
オプション |
この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。 |
< |
オプション |
このスキームで作成されたキャッシュを管理するサービス名を指定します。スラッシュ( |
|
オプション |
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
オプション |
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
オプション |
ユーザー定義型のシリアライズおよびデシリアライズに使用する |
|
|
オプション |
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 |
< |
オプション |
ノート: パーティション・キャッシュ・サービスで使用されるデーモン・スレッドの数を指定します。有効な値は、正の整数、 スレッド数を指定すると、トランザクション記憶域およびリカバリに使用されるトランザクション・フレームワークの内部トランザクション・キャッシュのデフォルト動作が変更されます。 |
|
オプション |
デーモン・スレッドの最大数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
デーモン・スレッドの最小数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 |
|
オプション |
ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
< |
オプション |
クラスタ・ノードをクラスタの記憶域として機能させる(つまり、パーティションを保持する)かどうかを指定します。無効化した場合、そのノードはキャッシュ・クライアントと見なされます。 通常、構成ファイル内ではこの値を未指定にしておき、システム・プロパティ 有効な値は、 |
< |
オプション |
パーティション(分散)キャッシュを分割するパーティションの数を指定します。パーティション・キャッシュ・サービスを実行し、local-storage( パーティションの数は素数とし、いずれのパーティションも50MBを超えることのないように十分なパーティション数を指定する必要があります。 次に、サンプルのサービス記憶域サイズの適切なデフォルト設定を示します。 service storage partition-count _______________ ______________ 100M 257 1G 509 10G 2039 50G 4093 100G 8191 最初の1,000個の素数のリストについては、次のサイトを参照してください。 有効値は正の整数です。デフォルト値は、 |
|
オプション |
トランザクション記憶域のサイズを指定します。トランザクション記憶域のサイズに達すると、エビクション・ポリシーが適用され、記憶域から使用可能なエントリの25%が削除されます。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。
値に係数が含まれていない場合は、1が係数として適用されます。デフォルト値は10MBです。 |
< |
オプション |
プライマリ・バケット分散のしきい値をキロバイト単位で指定します。パーティション・キャッシュ・サービスに新しいノードが結合する場合、またはサービスのメンバーのいずれかの結合が解除される場合、残りのノードによって、バケット所有権の再分散タスクが実行されます。このプロセスでは、所有権情報とともに既存のデータの均衡化が再実行されます。このパラメータでは、データ転送通信で優先されるメッセージ・サイズを示します。この値を低く設定すると、分散プロセスの所要時間は長くなりますが、このアクティビティ実行中のネットワーク帯域幅の使用量は軽減されます。有効な値は、ゼロより大きな整数です。デフォルト値は、 |
< |
オプション |
パーティション・キャッシュ・サービスのうち、各保存単位のバックアップ・データをキャッシュに保持するメンバーの数を指定します。この値が0になっていると、異常終了した場合にキャッシュ内のデータの一部が失われます。デフォルト値は、 |
|
オプション |
パーティション・サービスでパーティション分散を管理する際に使用する戦略を指定します。有効な値は、 |
< |
オプション |
タスクが実行できる時間をミリ秒単位で指定します。この時間を超過すると、ハングしたと見なされます。ノート: ポストされたタスクがまだ開始されていない場合は、ハングと見なされません。この属性は、スレッド・プールが使用されている( |
< |
オプション |
サービス・ワーカー・スレッド上で実行するリクエストのタイムアウト値をミリ秒単位で指定します。この属性は、スレッド・プールが使用されている( |
< |
オプション |
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は、 |
|
オプション |
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。指定のサービスに対して要素が指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 |
|
オプション |
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。 有効な値は次のとおりです。
|
オプション |
パーティション・キャッシュ・サービス用のクォーラム・ポリシー設定を指定します。 |
|
< |
オプション |
この要素は、キャッシュ・サーバー(つまり、 |
親トピック: キャッシュ構成要素リファレンス
使用場所: ssl。
説明
<trust-manager>
要素には、javax.net.ssl.TrustManager
インスタンスを初期化するための構成情報を記述します。
トラスト・マネージャは、信頼の決定を行う際に使用されるトラスト・マテリアルを管理し、ピアが提示した資格証明を受け入れるかどうかを決定します。
有効なtrust-manager構成には、少なくとも1つの子要素が記述されます。
親トピック: キャッシュ構成要素リファレンス
表B-74 キャッシュ構成デプロイメント・ディスクリプタの属性
属性 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
この属性は、任意の要素のシステム・プロパティ名を指定するために使用します。システム・プロパティは、Javaコマンド行から要素の値をオーバーライドする際に使用します。この機能により、すべてのクラスタ・ノードで同じオペレーション・ディスクリプタ(およびオーバーライド・ファイル)を使用し、システム・プロパティで各ノードをカスタマイズできます。システム・プロパティのオーバーライドを参照してください。 |
親トピック: キャッシュ構成の要素