この付録の内容は次のとおりです。
tangosol-coherence.xml
オペレーション・デプロイメント・ディスクリプタでは、クラスタリング、通信およびデータ管理サービスを制御する操作設定および実行時設定を指定します。このオペレーション・デプロイメント・ディスクリプタはcoherence.jar
ライブラリのルートにあります。カスタムのtangosol-coherence.xml
ファイルを作成できますが、操作設定の変更に推奨される方法は、後述のオペレーション・オーバーライド・ファイルで説明するように、tangosol-coherence-override.xml
オペレーション・オーバーライド・ファイルを使用することです。
オペレーション・デプロイメント・ディスクリプタ・スキーマはcoherence-operational-config.xsd
ファイルで定義します。これがcoherence-operational-config-base.xsd
ファイルをインポートし、これがさらにcoherence-config-base.xsd
ファイルを暗黙的にインポートします。このオペレーション・デプロイメント・ディスクリプタ・スキーマ・ファイルは、coherence.jar
ライブラリのルートおよび次のWeb URLにあります。
http://xmlns.oracle.com/coherence/coherence-operational-config/1.2/coherence-operational-config.xsd
<cohrence>
要素はオペレーション・ディスクリプタのルート要素であり、XSDおよびCoherenceネームスペース・リファレンスと、coherence-operational-config.xsd
ファイルの場所が含まれます。次に例を示します。
<?xml version='1.0'?> <coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config" xsi:schemaLocation="http://xmlns.oracle.com/coherence/ coherence-operational-config coherence-operational-config.xsd">
注意:
coherence.jar
ライブラリにあるスキーマは、xsi:schemaLocation
属性がWeb URLを参照する場合であっても、常に実行時に使用されます。
xsi:schemaLocation
属性を省略すると、スキーマ検証を無効にできます。
デフォルトの文字セットがASCIIではなくEBCDICである環境にCoherenceをデプロイする場合、デプロイメント・ディスクリプタ・ファイルがASCII形式であり、ランタイム環境にバイナリ形式でデプロイされることを確認してください。
操作設定の構成に推奨される方法は、オペレーション・オーバーライド・ファイルを使用することです。オーバーライド・ファイルのスキーマは、すべての要素がオプションであることを除き、オペレーション・デプロイメント・ディスクリプタと同一です。欠落している要素はすべてtangosol-coherence.xml
オペレーション・デプロイメント・ディスクリプタからロードされます。オーバーライド・ファイルのデフォルト名はtangosol-coherence-override.xml
です。実行時に、このファイルがクラスパス内のcoherence.jar
ライブラリの前に置かれている必要があります。
追加のオーバーライド・ファイルは、<coherence>
要素内のxml-override
属性を使用して構成できます。これにより、ステージングと本番など、類似のデプロイメント環境間で追加のチューニングが可能になります。この機能の例は、coherence.jar
内のtangosol-coherence-override-eval.xml
、tangosol-coherence-override-dev.xml
およびtangosol-coherence-override-prod.xml
の各ファイルを参照してください。xml-override
属性の使用方法の詳細は、属性リファレンスを参照してください。
表A-1は、オペレーション構成のすべての非終端要素を示しています。
表A-1 オペレーション構成の非終端要素
要素 | 使用場所 |
---|---|
ルート要素 |
|
access-controller、address-provider、callback-handler、configurable-cache-factory-config、filter、service |
|
socket-provider、service-failure-policy |
|
使用場所: security-config
説明
access-controller
要素には、com.tangosol.net.security.AccessController
インタフェースを実装するクラスの構成情報が含まれます。Coherenceセキュリティ・フレームワークはこれを使用してアクセス権をチェックしたり、ノード間の通信を暗号化または復号化します。
要素
表A-2で、access-controller
要素のサブ要素を説明します。
表A-2 access-controllerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
|
< |
オプション |
<init-params> <init-param id="1"> <param-type>java.io.File</param-type> <param-value system-property="coherence.security.keystore"> </param-value> </init-param> <init-param id="2"> <param-type>java.io.File</param-type> <param-value system-property="coherence.security.permissions"> </param-value> </init-param> </init-params> デフォルトの |
使用場所: topology-definitions
説明
active-passive
要素は、他のアクティブおよびパッシブな参加者にデータを送信するアクティブな参加者が1つ以上ある、アクティブ/パッシブ・トポロジを指定します。アクティブな参加者はデータを再送信せず、パッシブな参加者はデータの受信のみを行います。次に例を示します。
<active-passive> <name>MyTopology</name> <active>ClusterA</active> <passive>ClusterB</passive> </active-passive>
アクティブ/パッシブ・トポロジは、すべての参加者がアクティブな参加者のアクティブ/アクティブ設定を定義する場合に使用することもできます。次に例を示します。
<active-passive> <name>MyTopology</name> <active>ClusterA</active> <active>ClusterB</active> </active-passive>
要素
表A-3で、active-passive
要素のサブ要素を説明します。
表A-3 active-passiveのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
必須 |
トポロジのユーザー定義名を指定します。この名前は、このトポロジへの参照に使用されます。 |
|
必須 |
トポロジのアクティブな参加者の名前を指定します。複数のアクティブな参加者を定義できます。 |
|
オプション |
トポロジのパッシブな参加者の名前を指定します。複数のパッシブな参加者を定義できます。 |
|
オプション |
フェデレーテッド変更イベントのインターセプタとして実装するカスタム参加者の名前を指定します。 |
説明
address-provider
要素は、ソケット・アドレス情報(IPまたはDNS名およびポート)またはcom.tangosol.net.AddressProvider
インタフェースの実装のいずれかを指定します。このインタフェースは、ソケット・アドレスをプログラムで定義する方法を提供します。多くの要素でaddress-provider
要素が使用されます。
Well Knownアドレスのaddress-provider要素
well-known-addresses
要素内で、address-provider
要素を使用して、com.tangosol.net.AddressProvider
インタフェースを実装するアドレス・ファクトリを指定します。このインタフェースは、プログラムでWell Knownアドレス(WKA)メンバーを定義する方法を提供します。WKAの詳細は、Well Knownアドレスの使用を参照してください。次の例は、well-known-addresses
要素内でのaddress-provider
要素の使用方法を示しています。
<unicast-listener> <well-known-addresses> <address-provider> <class-name>package.MyAddressProvider</class-name> </address-provider> </well-known-addresses> </unicast-listener>
ソケット・アドレスのaddress-provider要素
address-providers
要素内で、address-provider
要素を使用して、ソケット・アドレスまたはcom.tangosol.net.AddressProvider
インタフェースを実装するアドレス・ファクトリを指定します。アドレス・プロバイダ定義は、Coherence*Extendの設定に使用されるTCP/IPアクセプタおよびTCP/IPイニシエータによって参照されます。また、TCP/IPアクセプタもmemcachedクライアントで使用できます。
キャッシュ構成ファイルのtcp-acceptor
、memcached-acceptor
、remote-addresses
およびname-service-addresses
要素は、指定されているid
属性値を使用してアドレス・プロバイダ定義を参照します。tcp-acceptor
要素の詳細は、tcp-acceptorを参照してください。memcached-acceptor
要素の詳細は、memcached-acceptorを参照してください。remote-addresses
要素の詳細は、remote-addressesを参照してください。name-service-addresses
要素の詳細は、name-service-addressesを参照してください。次の例は、<address-providers>
要素内でのアドレス・プロバイダ定義の定義方法を示しています。
<address-providers> <address-provider id="ap1"> <class-name>package.MyAddressProvider</class-name> </address-provider> <address-provider id="ap2"> <socket-address> <address>192.168.1.3</address> <port>9999</port> </socket-address> </address-provider> <address-provider id="ap3"> <socket-address> <address>192.168.1.4</address> <port>9999</port> </socket-address> </address-provider> </address-providers>
永続性のaddress-provider要素
address-providers
要素内で、address-provider
要素を使用して、com.tangosol.net.AddressProvider
インタフェースを実装するアドレス・ファクトリまたはアドレスを指定します。アドレス・プロバイダ定義は、キャッシュ永続性の構成時に使用されます。アドレスでは、孤立パーティションを永続記憶域からリカバリするか、空のパーティションを割り当てる(永続記憶域が利用できないか、失われている場合)ために必要な、クラスタ内の記憶域が有効なホストを表します。次に例を示します。
<address-providers> <address-provider id="persistence-host-list"> <address>HOST_NAME/address> <address>HOST_NAME</address> </address-provider> </address-providers>
フェデレーションのaddress-provider要素
name-service-addresses
要素内で、address-provider
要素を使用して、com.tangosol.net.AddressProvider
インタフェースを実装するアドレス・ファクトリまたはアドレスを指定します。アドレス・プロバイダ定義は、クラスタ・フェデレーションの構成時に使用されます。アドレスは、リモート・クラスタ参加者のクラスタ・ノードを表します。
要素
表A-4で、address-provider
要素のサブ要素を説明します。
表A-4 address-providerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
この要素は、 |
|
オプション |
実装クラス・インスタンスを作成するための、ファクトリ・クラスの完全修飾名を指定します。 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
一致するシグネチャを持つpublicなコンストラクタが含まれる実装によってアクセス可能な初期化パラメータを指定します。初期化パラメータは、 |
|
オプション |
ソケットがバインドされるアドレス(IPまたはDNS名およびポート)を指定します。 この要素は、TCP/IPアクセプタのソケット・アドレスを定義する場合にのみ使用してください。アドレス・プロバイダ実装が |
|
|
オプション |
IPアドレスまたはDNS名を指定します。バインド・アドレスの場合、そのアドレスはサブネットおよびマスクとしてCIDR形式(例: 192.168.1.0/24)で表すこともできるため、使用可能なローカルIPアドレスに対するランタイム解決が可能になります。 |
使用場所: cluster-config
説明
address-providers
要素には、アドレス・プロバイダごとの宣言データを記述します。
要素
表A-5で、address-provider
要素のサブ要素を説明します。
表A-5 address-providersのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
ソケット・アドレス情報または |
使用場所: cluster-config
説明
これを指定すると、クラスタ・メンバーシップが、ユニキャスト・アドレスのコレクションまたはアドレス範囲で指定されたクラスタ・ノードに制限されます。ユニキャスト・アドレスは、認可されたクラスタ・ノードのunicast-listener
要素のアドレス値です。任意の数のhost-address
要素およびhost-range
要素を指定できます。
要素
表A-6で、authorized-hosts
要素のサブ要素を説明します。
表A-6 authorized-hostsのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
IPアドレスまたはホスト名を指定します。これを指定すると、host-addressが指定されたホスト、または指定されたhost-range内のホストのみがクラスタに参加できます。内容のオーバーライド属性 |
オプション |
IPアドレスの範囲を指定します。これを指定すると、host-addressが指定されたホスト、または指定されたhost-range内のホストのみがクラスタに参加できます。内容のオーバーライド属性 |
|
|
オプション |
新しいクラスタ・メンバーを受け入れるかどうかを判断するためクラスタによって使用される |
使用場所: coherence
説明
cache-factory-builder-config
要素には、com.tangosol.net.CacheFactoryBuilder
インタフェースのインスタンスを作成するための構成情報を記述します。デフォルトの実装はcom.tangosol.net.DefaultCacheFactoryBuilder
クラスで、高度な用途では、これを拡張してConfigurableCacheFactory
インスタンスを作成および管理するためのよりドメイン固有なロジックを提供できます。
複数のクラス・ローダーにわたる複数のキャッシュ・ファクトリ構成を構築および管理するには、カスタムのCacheFactoryBuilder
実装を使用します。これは、異なるクラス・ローダーによってスコープ設定されるアプリケーションが、異なるキャッシュ構成ファイルを使用できるようにする高度な使用例(JavaEEおよびOSGIと同様)です。たとえば、次のコードでは、2つのクラスローダーのカスタムConfigurableCacheFactory
実装を使用します。
CacheFactoryBuilder cfb = CacheFactory.getCacheFactoryBuilder(); //load the first configuration cfb.getConfigurableCacheFactory("example-config.xml", loader0); CacheFactory.ensureCluster(); NamedCache cache = CacheFactory.getCache("dist-example"); //load the second configuration cfb.getConfigurableCacheFactory("example-config1.xml", loader1); CacheFactory.ensureCluster(); NamedCache cache1 = CacheFactory.getCache("dist-example1");
要素
表A-7で、cache-factory-builder-config
要素のサブ要素を説明します。
表A-7 cache-factory-builder-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
|
オプション |
キャッシュ・ファクトリ・ビルダー実装の初期化パラメータを記述します。 |
|
|
オプション |
キャッシュ構成ファイル内でスコープ名を指定する方法の詳細は、 |
使用場所: security-config
表A-8で、callback-handler
要素のサブ要素を説明します。
表A-8 callback-handlerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
|
オプション |
|
使用場所: topology-definitions
説明
central-replication
要素は、1つ以上のリーフ参加者がデータをハブ参加者に送信し、ハブ参加者がデータを他のすべてのリーフ参加者に再送信する(繰り返す)、集中型レプリケーション・トポロジを指定します。ハブ参加者で変更が発生した場合は、すべてのリーフ参加者に送信されます。
次の例は、カスタム・トポロジを示しています。
<central-replication> <name>central</name> <hub>ClusterA</hub> <leaf>ClusterB</leaf> <leaf>ClusterC</leaf> </central-replication>
要素
表A-9で、central-replication
要素のサブ要素を説明します。
表A-9 central-replicationのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
必須 |
トポロジのユーザー定義名を指定します。この名前は、このトポロジへの参照に使用されます。 |
|
必須 |
トポロジのハブ参加者の名前を指定します。 |
|
必須 |
トポロジのリーフ参加者の名前を指定します。複数のリーフ参加者を定義できます。 |
|
オプション |
フェデレーテッド変更イベントのインターセプタとして実装するカスタム参加者の名前を指定します。 |
使用場所: coherence
説明
通信パラメータやサービス・パラメータなどのクラスタ構成情報を記述します。
要素
表A-10で、cluster-config
要素のサブ要素を説明します。
表A-10 cluster-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
クラスタ・メンバーの位置とロールの定義に有用な、詳細な識別情報を指定します。 |
|
必須 |
Point-to-Pointネットワーク通信の受信に使用するユニキャスト・リスナーの構成情報を指定します。 |
|
必須 |
Point-to-Multipointネットワーク通信の受信に使用するマルチキャスト・リスナーの構成情報を指定します。 |
|
必須 |
停止検出に使用するTCPリング・リスナーの構成情報を指定します。 |
|
必須 |
外部シャットダウン・リクエストを受信したときに実行するアクションを指定します。 |
|
必須 |
サービスのデッドロックの検出と解決に使用されるサービス・ガーディアンの構成情報を指定します。 |
|
必須 |
ネットワーク・データ転送に使用するパケット・スピーカーの構成情報を指定します。 |
|
必須 |
ネットワーク・データ転送の管理に使用するパケット・パブリッシャの構成情報を指定します。 |
|
必須 |
受信するクラスタ通信のディスパッチに使用する受信メッセージ・ハンドラの構成情報を指定します。 |
|
必須 |
送信するクラスタ通信のディスパッチに使用する送信メッセージ・ハンドラの構成情報を指定します。 |
|
オプション |
クラスタに参加できるホストを指定します。 |
|
|
必須 |
使用可能なCoherenceサービスすべての宣言データを指定します。 |
|
オプション |
クラスタ・ノード間で転送されるデータに対するカスタム変換を実行できるデータ変換フィルタを指定します。 |
オプション |
|
|
オプション |
各永続性環境の宣言データを指定します。 |
|
オプション |
アドレス・プロバイダ定義の数を指定します。 |
|
必須 |
ソケット・プロバイダの定義を記述します。 |
|
オプション |
クラスタ・サービスのクォーラムベース・アクション・ポリシーの構成情報を記述します。 |
|
オプション |
ジャーナル・サブシステムの構成を指定します。 |
|
オプション |
各記憶域アクセス認可者の実装の宣言データを記述します。 |
使用場所: cluster-config
説明
cluster-quorum-policy
要素には、クラスタ・サービス用のクォーラム・ポリシー設定を記述します。
要素
表A-11で、cluster-quorum-policy
要素のサブ要素を説明します。
表A-11 cluster-quorum-policy-schemeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
根本原因に関係なく、ネットワークのタイムアウトの検出により1つ以上のクラスタ・メンバーを終了するために保持する必要のある、クラスタ・メンバーの最小数を指定します。値は負ではない整数である必要があります。 ( <timeout-survivor-quorum role="Server">50 </timeout-survivor-quorum> |
|
オプション |
カスタム・クォーラム・ポリシーを提供するクラスを指定します。この要素は、 クラスは、 |
|
オプション |
カスタム・アクション・ポリシー・インスタンスを作成するためのファクトリ・クラスを指定します。この要素は、 この要素は、 |
ルート要素
説明
coherence
要素は、オペレーション・デプロイメント・ディスクリプタtangosol-coherence.xml
のルート要素です。
要素
表A-12で、coherence
要素のサブ要素を説明します。
表A-12 coherenceのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
必須 |
クラスタ構成情報を記述します。この要素では、ほとんどの通信およびサービスのパラメータを定義します。 |
|
必須 |
ロギング機能の構成情報を記述します。 |
|
必須 |
構成可能なキャッシュ・ファクトリの構成情報を記述します。これにより、キャッシュ構成設定のロード元およびロード方法を制御します。 |
|
必須 |
キャッシュ・ファクトリ・ビルダーの構成情報を記述します。これにより、複数のクラス・ローダーにわたり、複数のキャッシュ・ファクトリ構成の構築および管理が可能になります。 |
|
必須 |
Coherenceの管理フレームワークの構成情報を記述します。詳細は、『Oracle Coherenceのマネージメント』を参照してください。 |
|
オプション |
Coherenceのセキュリティ・フレームワークの構成情報を記述します。 |
|
オプション |
エディションおよび操作モードの構成を記述します。 |
|
オプション |
クラスタの同期に使用されるフェデレーション構成情報を記述します。 |
使用場所: coherence
説明
configurable-cache-factory-config
要素には、com.tangosol.net.ConfigurableCacheFactory
インタフェースのインスタンスを作成するための構成情報を記述します。デフォルトの実装は、com.tangosol.net.ExtensibleConfigurableCacheFactory
クラスです。
カスタムのConfigurableCacheFactory
実装の使用は高度な使用例で、通常、異なるクラス・ローダーによってスコープ設定されるアプリケーションが、異なるキャッシュ構成ファイルを使用できるようにするために使用されます(JavaEEおよびOSGIと同様)。
次の例では、異なるキャッシュ定義を含み、異なるClassLoaders
を使用する2つの構成ファイルをロードします。
//load the first configuration and use a cache ConfigurableCacheFactory eccf= new ExtensibleConfigurableCacheFactory("example-config.xml", loader0); NamedCache cache = eccf.ensureCache("dist-example", loader0); cache.put(key, value); //load the second cache configuration and use a cache ConfigurableCacheFactory eccf1= new ExtensibleConfigurableCacheFactory("example-config1.xml", loader1); NamedCache cache1 = eccf1.ensureCache("dist-example1", loader1); cache1.put(key, value);
注意:
この例では、各キャッシュ定義が異なるサービス名を使用する必要があります。そうしない場合、異なる構成ディスクリプタのファクトリによりサービスが開始されたことを示す例外がスローされます。
要素
表A-13で、configurable-cache-factory-config
要素のサブ要素を説明します。
表A-13 configurable-cache-factory-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
事前構成済システム・プロパティのオーバーライド値は |
オプション |
キャッシュ構成ファクトリ実装の初期化パラメータを記述します。デフォルトのキャッシュ構成ファクトリ・クラスの場合、次のように1つのパラメータが使用されます。 <init-param> <param-type>java.lang.String</param-type> <param-value>coherence-cache-config.xml</param-value> </init-param> . 事前構成済システム・プロパティのオーバーライド値は |
使用場所: topology-definitions
説明
custom-topology
要素は、グループ・リストで構成される自由形式のトポロジです。グループは、特定のロールを持つ参加者(送信者、リピータまたは受信者)で構成されます。変更をグループ内の他の参加者に送信または転送できるのは、送信者およびリピータの参加者のみです。
使用場所: filters
説明
データ変換フィルタはサービスによって使用され、クラスタ・ノード間で転送されるデータに対するカスタム変換に適用できます。これは、ネットワーク・トラフィックを圧縮するインスタンスに使用できます。詳細は、<filter-class>
要素を参照してください。
実装
データ変換フィルタは、com.tangosol.util.WrapperStreamFactory
インタフェースの実装です。
注意:
データ変換フィルタは、com.tangosol.util.Filter
には関係がなく、キャッシュの問合せに使用するCoherence APIの一部です。
要素
表A-16で、各filter
要素のサブ要素を説明します。
表A-16 filterのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
フィルタの正規名を指定します。この名前はクラスタ内で一意です。例: |
< |
必須 |
フィルタ実装のクラス名を指定します。このクラスには、パラメータがゼロのpublicなコンストラクタが必要であり、 |
オプション |
フィルタを構成するための初期化パラメータを指定します。たとえば <init-param> <param-name>strategy</param-name> <param-value>gzip</param-value> </init-param> <init-param> <param-name>level</param-name> <param-value>default</param-value> </init-param> 標準的なフィルタのパラメータ値の詳細は、ネットワーク・フィルタの使用を参照してください。 |
使用場所: journaling-config
説明
<flashjournal-manager>
要素には、フラッシュ・ジャーナル・リソース・マネージャの構成が含まれており、これによって一時的なジャーナルベースのファイルからソリッド状態のデバイスへのI/Oが管理されます。
要素
表A-18で、flashjournal-manager
要素のサブ要素を説明します。
表A-18 flashjournal-managerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
この値未満であれば、ジャーナル・ファイルが圧縮(ガベージ・コレクション)に適したものになる、ライブ・データ率を指定します。 |
|
オプション |
フラッシュ・ジャーナルに格納されるバイナリ値の最大サイズをバイト単位で指定します。64MB以下の値を指定する必要があります。デフォルト値は |
|
オプション |
基礎となるジャーナル・ファイルの最大ファイル・サイズを指定します。この値は2の累乗であり、ブロック・サイズの倍数である必要があります。値は、1MBと4GBの間である必要があり、最低2つの値をファイルに格納できるだけの大きさである必要があります。デフォルト値は |
|
オプション |
ジャーナル・コレクタが、タイムアウトと判断する前に待機する時間を指定します。タイムアウトの最小値は30sです。有効な値は、時間間隔を表す文字列です。デフォルト値は |
|
オプション |
ジャーナルの最大容量をメモリー・サイズとして指定します。値が0の場合は、フラッシュ記憶域が無効になるため、ジャーナルでRAM記憶域のみが使用され、フラッシュ記憶域にオーバーフローされません。 事前構成済システム・プロパティのオーバーライド値は |
|
オプション |
書込みバッファがここで指定したサイズに達すると、基礎となるディスク・ファイルへの書き込みが発生します。このサイズは、物理デバイスの最適ブロック・サイズと一致するか、その倍数であり、2の累乗である必要があります。値は4KBから1MBの範囲にする必要があります。デフォルト値は |
|
オプション |
バッファ・プールのサイズをバイト単位で指定します。このサイズによって、割当て可能または特定の時点で存在可能なバッファの数が制限されることはありません。このサイズによって決まるのは、再利用されるバッファの数のみです。プールの最大サイズは1GBです。デフォルト値は |
|
オプション |
ジャーナル・ファイルを配置するディレクトリを指定します。既存のディレクトリを指定する必要があります。実行時には作成されません。ディレクトリが存在しないか、指定されていない場合は、JVMまたはオペレーティング・システムのデフォルトの一時ディレクトリが使用されます。推奨される場所は、ローカルのフラッシュ(SSD)ドライブです。 他のアプリケーションまたはシステム操作によって共有されているドライブ上にあるディレクトリを指定すると、予定外の領域使用量になる可能性が高くなります。より予測可能な環境を確保するために、共有されていないディスク・パーティション上のディレクトリを使用してください。 |
|
オプション |
バックログの最大サイズをバイト単位で指定します。バックログは、まだ永続化されていないデータの量です。クライアント・スレッドは、指定されている制限を超えるとブロックされ、バックログが制限を下回るまでブロックされたままになります。これは、メモリー不足の状態を回避するのに役立ちます。注意: バックログで使用するメモリーの最大容量は、指定されている容量の2倍以上にする必要があります。これは、データがバイナリ形式であり、ライトビハインド・バッファにレンダリングされるからです。値は4KBから1GBの範囲にする必要があります。デフォルト値は |
|
オプション |
ジャーナル・サブシステムによって使用されている一時ファイルが削除に適したものになるまでの待機時間を指定します。この遅延は、ファイルが最後に使用された後に開始されます。デフォルト値は |
|
オプション |
ジャーナル・サイズまたはフラッシュ・ジャーナル容量のパーセンテージに、バイト単位で弱い制限を指定します。弱い制限では、圧縮(ガベージ・コレクション)スレッドが自己調整して、失効している値を削除し、ジャーナルをその制限以内に保ちます。これは、強い制限ではなく、ジャーナルは依然として最大ファイル数( 事前構成済システム・プロパティのオーバーライド値は |
|
オプション |
ジャーナル・ライターが、タイムアウトと判断する前に待機する時間を指定します。タイムアウトの最小値は30sです。有効な値は、時間間隔を表す文字列です。デフォルト値は ( |
使用場所: packet-delivery
説明
flow-control要素には、パケット速度の調整およびリモートGCの検出に関連する構成情報を記述します。
要素
表A-19で、flow-control
要素のサブ要素を説明します。
表A-19 flow-controlのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
フロー制御を有効にするかどうかを指定します。有効な値は |
オプション |
応答のないクラスタ・ノードに再送信するパケットの数を定義します。このパケット数を超過すると、そのノードは一時停止していると見なされます。 |
|
オプション |
クラスタ・ノードに送信する未確認パケットの数を定義します。このパケット数を超過すると、そのノードを送信先とするパケットは遅延されます。 |
使用場所: groups
説明
group
要素は、明確に定義されたロールを持つ一連の参加者を指定します。参加者のロールに関係なく、すべての参加者がデータを受信できます。次のロールを使用できます。
送信者 – 送信者の参加者は、そのローカル・クラスタから発生したデータのみを送信できます。
リピータ – リピータ参加者は、ローカルに発生したデータ、および他の参加者から受信したデータを送信できます。
受信者 – 受信者の参加者は、データを送信することはありません。
次の例は、カスタム・トポロジを示しています。
<custom-topology> <name>custom</name> <groups> <group> <sender>ClusterA</sender> <sender>ClusterB</sender> </group> <group> <repeater>ClusterA</repeater> <receiver>ClusterC</receiver> </group> </groups> </custom-topology>
要素
表A-20で、group
要素のサブ要素を説明します。
表A-20 groupのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
送信者として機能する参加者を指定します。複数の送信者の参加者をグループに定義できます。 |
|
オプション |
リピータとして機能する参加者を指定します。複数のリピータ参加者をグループに定義できます。 |
|
オプション |
受信者として機能する参加者を指定します。複数の受信者の参加者をグループに定義できます。 |
使用場所: authorized-hosts
説明
クラスタに参加できるノードのユニキャスト・アドレスの範囲を指定します。
要素
表A-22で、各host-range
要素のサブ要素を説明します。
表A-22 host-rangeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
ホスト・アドレスの範囲の開始IPアドレスを指定します(例: 198.168.1.1)。 |
< |
必須 |
ホストの範囲の終了IPアドレスを指定します(例: 198.168.2.255)。 |
使用場所: topology-definitions
説明
hub-spoke
要素は、1つ以上のスポーク参加者のみがデータを受信するハブおよびスポーク・トポロジを指定します。ハブ参加者は、すべてのスポーク参加者にデータを送信します。
次の例は、ハブおよびスポーク・トポロジを示しています。
<hub-spoke> <name>hub</name> <hub>ClusterA</hub> <spoke>ClusterB</spoke> <spoke>ClusterC</spoke> </hub-spoke>
要素
表A-23で、hub-spoke
要素のサブ要素を説明します。
表A-23 hub-spokeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
必須 |
トポロジのユーザー定義名を指定します。この名前は、このトポロジへの参照に使用されます。 |
|
必須 |
トポロジのハブ参加者の名前を指定します。 |
|
必須 |
トポロジのスポーク参加者の名前を指定します。複数のスポーク参加者を定義できます。 |
|
オプション |
フェデレーテッド変更イベントのインターセプタとして実装するカスタム参加者の名前を指定します。 |
使用場所: security-config
説明
<identity-asserter>
要素には、com.tangosol.net.security.IdentityAsserter
インタフェースを実装するクラスの構成情報を記述します。このクラスは、ユーザーのIDを確立するためIDトークンを検証する際にコールされ、Coherence*Extendプロキシ・サーバーで使用されます。IDアサーション・プロバイダが(Coherence*Extendクライアント上で使用される)IDトランスフォーマとともに使用され、有効なクライアントのみが拡張プロキシに接続できるようにします。
要素
表A-24で、<identity-asserter>
要素のサブ要素を説明します。
表A-24 identity-asserterのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
|
|
オプション |
asserterインスタンスを作成するためのファクトリ・クラスを指定します。このインスタンスは、 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
アサーション・プロバイダ実装のクラス初期化パラメータを記述します。 |
使用場所: ssl
説明
<identity-manager>
要素には、javax.net.ssl.KeyManager
インスタンスを初期化するための構成情報を記述します。
アイデンティティ・マネージャは、そのピアへのローカル接続を認証するために使用されるキー・マテリアルの管理を行います。キー・マテリアルが使用できない場合、その接続では認証資格証明を提示できません。
使用場所: security-config
説明
<identity-transformer>
要素には、com.tangosol.net.security.IdentityTransformer
インタフェースを実装するクラスの構成情報を記述します。このクラスは、Subject
(.NETではPrincipal
)を、IDをアサートしCoherence*Extendクライアントで使用されるトークンに変換する際にコールされます。IDトランスフォーマが(Coherence*Extendプロキシ・サーバー上で使用される)IDアサーション・プロバイダとともに使用され、有効なクライアントのみが拡張プロキシに接続できるようにします。
要素
表A-26で、<identity-transformer>
要素のサブ要素を説明します。
表A-26 identity-transformerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
|
|
オプション |
asserterインスタンスを作成するためのファクトリ・クラスを指定します。このインスタンスは、 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
トランスフォーマ実装のクラス初期化パラメータを記述します。 |
使用場所: cluster-config
説明
incoming-message-handler
は、パケットを論理メッセージにアセンブルして、それを適切なCoherenceサービスにディスパッチして処理できるようにします。
要素
表A-27で、incoming-message-handler
要素のサブ要素を説明します。
表A-27 incoming-message-handlerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
新しいクラスタ・メンバーのシステム時刻とクラスタ時刻との間の差異を測定する際に、ブロードキャスト・メッセージの送受信間の最大時刻差異を指定します。差異が小さいほど、クラスタ内で実行中の複数のシステム間でクラスタ時刻が接近する確率が高まりますが、クラスタに参加するプロセスは、指定された差異内でメッセージの交換が起こることが可能になるまで延長されます。通常は、20ミリ秒程度の値で十分ですが、負荷の高いクラスタや複数のネットワーク・ホップでは、より大きな値が必要になる場合があります。デフォルト値は |
< |
必須 |
パケットの受信側で否定応答(パケット・リクエスト)を使用して、欠落パケットを認識したときに積極的に応答するかどうかを指定します。詳細と構成は、notification-queueingを参照してください。有効な値は、 |
< |
必須 |
受信メッセージ・ハンドラの実行スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
使用場所: init-params
説明
初期化パラメータを定義します。任意の数のinit-param
要素を指定できます。
初期化パラメータは、型または名前で指定できます。<param-type>
要素を使用する場合、指定された型のオブジェクトは、<param-value>
に指定されている値でインスタンス化および初期化されます。値が<param-value>
の<param-type>
のコンストラクタがコールされ、オブジェクトがインスタンス化されます。<param-name>
要素を使用する場合、値が<param-value>
の<param-name>
のコンストラクタがコールされ、オブジェクトがインスタンス化されます。
要素
表A-28で、init-param
要素のサブ要素を説明します。
表A-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タイプに固有の形式にします。 |
|
オプション |
初期化パラメータの説明を指定します。 |
使用場所: address-provider
、filter
、service
、configurable-cache-factory-config
、access-controller
およびcallback-handler
説明
一連の初期化パラメータを定義します。
使用場所: service-failure-policy
、scope-resolver
、partition-assignment-strategy
、custom-archiver
およびpersistence-environment
。
説明
<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>
要素
表A-30で、instance
要素のサブ要素を説明します。
表A-30 instanceのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
実装クラスの完全修飾名を指定します。 この要素は、 |
|
オプション |
実装クラス・インスタンスを作成するための、ファクトリ・クラスの完全修飾名を指定します。 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
一致するシグネチャを持つpublicなコンストラクタが含まれる実装によってアクセス可能な初期化パラメータを指定します。初期化パラメータは、 |
使用場所: interceptors
説明
interceptor
要素は、フェデレーション変更レコードの処理を行うイベント・インターセプタと関連付けられる構成を定義します。インターセプタは、FederatedChangeEvent
タイプの場合com.tangosol.net.events.EventInterceptor
インタフェースを実装します。ライブ・イベントの使用の詳細は、「ライブ・イベントの使用」を参照してください。
注意:
参加者構成内で定義されたインターセプタは、その参加者を使用するすべてのフェデレーテッド・キャッシュ・サービスに適用されます。特定のフェデレーテッド・キャッシュ・サービスに対するインターセプタを制限するには、インターセプタをキャッシュ構成ファイルのfederated-scheme
内に定義します。
要素
表A-31 interceptorのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
インターセプタの一意の識別子を指定します。 |
|
オプション |
このインターセプタを、インターセプタの連鎖の最初のインターセプタにするかどうかを指定します。有効な値は |
|
必須 |
インスタンス化するインターセプタ・クラスを指定します。インターセプタ・クラスは、 |
使用場所: participant
説明
interceptors
要素には、任意の数のイベント・インターセプタ定義が含まれます。
要素
表A-32で、interceptors
要素のサブ要素を説明します。
表A-32 interceptorsのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
イベント・インターセプタの実装を指定します。 |
使用場所: cluster-config
説明
<journaling-config>
要素には、フラッシュおよびRAMメモリーにバイナリ形式でデータを格納する役割を持つリソース・マネージャの構成が含まれます。
要素
表A-30で、journaling-config
要素のサブ要素を説明します。
表A-33 journaling-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
必須 |
RAMジャーナル・リソース・マネージャの構成を指定します。 |
|
必須 |
フラッシュ・ジャーナル・リソース・マネージャの構成を指定します。 |
使用場所: identity-manager
およびtrust-manager
。
説明
key-store
要素は、SSLの実装時に使用するキー・ストア実装の構成を指定します。キー・ストア実装は、java.security.KeyStore
クラスのインスタンスです。
要素
表A-34で、key-store
要素のサブ要素を説明します。
表A-34 key-storeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
必須 |
キー・ストアへのUniform Resource Locator (URL)を指定します。 |
|
オプション |
キャッシュ・ストアのパスワードを指定します。 |
|
オプション |
|
使用場所: coherence
説明
license-config
要素には、このメンバーが使用するライセンスの詳細を記述します。
要素
表A-35で、license-config
要素のサブ要素を説明します。
表A-35 license-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
メンバーが使用する製品のエディションを指定します。有効な値は、 注意: エディションの切替えによってライセンスの制限が適用されることはなくなりました。デフォルトの設定( |
< |
オプション |
製品を開発モードと本番モードのいずれで使用するかを指定します。有効な値は、 |
使用場所: coherence
要素
次の表で、logging-config
要素のサブ要素を説明します。
表A-36 logging-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
ロギング・システムで使用する出力デバイスを指定します。有効な値は次のとおりです。
事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
Coherence関連のメッセージを記録するよう選択されたロギング・システム内でのロガー名を指定します。この値は、JDKおよびlog4jロギング・システムでのみ使用されます。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
< |
必須 |
どのログ・メッセージをログ出力先に出力するかを指定します。有効な値は 事前構成済システム・プロパティのオーバーライド値は |
< |
必須 |
ログ出力先に渡す前に、ロギング・レベルが指定されたメッセージをフォーマットする方法を指定します。このフォーマットには、静的テキストおよび {date}/{uptime} {product} {version} <{level}> (thread={thread}, member={member}): {text} |
< |
必須 |
ロガー・デーモンがメッセージ・キューから処理する文字の最大数を指定します。この数を超過すると、キューに残っているメッセージがすべて破棄されます。破棄されたメッセージはすべて、ロギング・システムによって、破棄されたメッセージの数と合計サイズの詳細を説明する1つのログ・エントリでまとめられます。有効な値は、正の整数または 事前構成済システム・プロパティのオーバーライド値は |
使用場所: coherence
要素
表A-37で、management-config
要素のサブ要素を説明します。
表A-37 management-configのサブ要素
要素 | オプション/ 必須 | 説明 |
---|---|---|
< |
必須 |
クラスタ・ノードのJVMに
事前構成済システム・プロパティのオーバーライド値は |
< |
必須 |
このクラスタ・ノードで、管理オブジェクトをリモートのMBeanサーバーに公開するかどうかを指定します。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
|
オプション |
リモート管理情報のリフレッシュに使用されるメソッドを指定します。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
|
オプション |
管理ノードでリモートのMBean情報が無効化されるまでの時間間隔(ミリ秒単位)を指定します。有効な値は、時間間隔を表す文字列です。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
|
オプション |
MBean情報のリフレッシュ時に管理ノードがリモート・ノードからのレスポンスを待つ期間を指定します。この値はrefresh-expiryの間隔より小さくする必要があります。有効な値は、時間間隔を表す文字列です。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
このクラスタ・ノードで公開された管理オブジェクトに、実行時属性の変更操作を許可するかどうかを指定します。有効な値は、trueまたはfalseです。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
Coherence管理フレームワークにより公開されるMBeanを登録するために使用される既存のMBeanサーバーのドメイン名を指定します。この要素は、クラスタ・メンバーで管理が有効化されていて、MBeanサーバーがクラスタ・メンバーと同じプロセス内にある場合にのみ使用できます。値が指定されていない場合、最初の既存のMBeanサーバーが使用されます。この要素は、既存のMBeanサーバーを識別するためにのみ使用してください。 この要素は、 |
< |
オプション |
リモート管理に使用する起動サービスの名前を指定します。この要素は、 |
|
オプション |
|
|
オプション |
ノードがクラスタに参加するときに登録されるMBeanのリストを記述します。 |
オプション |
登録前にMBeanをフィルタ処理するために使用されるフィルタ・クラスの構成情報を記述します。 |
|
|
オプション |
Reporterの構成を記述します。 |
|
オプション |
事前構成済システム・プロパティのオーバーライド値は |
使用場所: mbeans
説明
mbean
要素には、Coherence管理フレームワークでインスタンス化および登録される要素のリストを記述します。
要素
表A-38で、mbean
要素のサブ要素を説明します。
表A-38 mbeanのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
Coherence管理フレームワークでインスタンス化および登録する標準MBeanのフル・クラス名を指定します。正しくインスタンス化するには、クラスパスにMBeanクラスを指定する必要があります。 この要素は、 |
|
オプション |
Coherence管理フレームワークに登録するMBeanを取得するために使用するクラス・ファクトリの名前を指定します。正しくインスタンス化するには、クラスパスにファクトリ・クラスを指定する必要があります。この要素は、 この要素は、 |
|
オプション |
JMX <mbean-query>java.lang:*</mbean-query> この要素は、 |
|
オプション |
ソースMBeanサーバーのデフォルト・ドメインの名前を指定します。これは、mbean-queryを実行する必要のあるMBeanサーバーを見つけるために使用されます。 |
|
オプション |
MBeanのインスタンス化に使用されるファクトリ・クラス( |
|
必須 |
Coherence管理フレームワークに登録するMBeanのJMX |
|
オプション |
MBeanをクラスタ全体で参照可能にするかどうかを指定します。有効な値は |
|
オプション |
このインスタンスでMBeanをインスタンス化および登録するかどうかを指定します。有効な値は |
|
オプション |
MBeanがノード接続のライフ・サイクルを超えるかどうかを指定します。有効な値は |
使用場所: management-config
説明
mbeans
要素は、カスタムMBeanを定義するためのルート要素で、カスタムMBean構成ファイルのルート要素です。これには、Coherence管理フレームワークでインスタンス化および登録されるmbean要素のリストを記述します。
使用場所: management-config
説明
mbean-filter
要素は、MBeanサーバーに登録する前にMBean名を評価するフィルタの指定に使用します。com.tangosol.net.management.ObjectNameExcludeFilter
クラスはデフォルトのフィルタで、標準のRegexパターンを使用するJMXオブジェクト名に基づいて、MBeanが登録されないように除外する場合に使用します。リストは、空白文字により区切られた名前のリストとして入力されます。次のMBeanは、初期状態の構成では除外されています。
<management-config> <mbean-filter> <class-name>com.tangosol.net.management.ObjectNameExcludeFilter</class-name> <init-params> <init-param> <param-type>string</param-type> <param-value system-property="coherence.management.exclude"> .*type=Service,name=Management,.* .*type=Platform,Domain=java.lang,subType=ClassLoading,.* .*type=Platform,Domain=java.lang,subType=Compilation,.* .*type=Platform,Domain=java.lang,subType=MemoryManager,.* .*type=Platform,Domain=java.lang,subType=Threading,.* </param-value> </init-param> </init-params> </mbean-filter> </management-config>
要素
表A-58で、mbean-filter
要素のサブ要素を説明します。
表A-40 mbean-filterのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
MBeanをフィルタ処理するためのフィルタ・クラスの名前を指定します。 この要素は、 |
|
オプション |
フィルタ・インスタンスを作成するためのファクトリ・クラスを指定します。 この要素は、 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
フィルタ実装のクラス初期化パラメータを記述します。 |
使用場所: cluster-config
member-identity
要素には、クラスタ・メンバーの位置とロールの定義に有用な、詳細な識別情報を記述します。
要素
表A-41で、member-identity
要素のサブ要素を説明します。
表A-41 member-identityのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
事前構成済システム・プロパティのオーバーライド値は |
< |
オプション |
事前構成済システム・プロパティのオーバーライド値は |
使用場所: cluster-config
説明
マルチキャスト・リスナーの構成情報を指定します。この要素は、クラスタ全体およびPoint-to-Pointの通信のためにクラスタで使用するアドレスおよびポートを指定するために使用します。クラスタ内のすべてのノードが同じマルチキャスト・アドレスおよびポートを使用する必要があります。同じネットワーク上で互いに独立している複数のクラスタは、それぞれ異なるマルチキャスト・アドレスを使用する必要があります。マルチキャストを使用する際のクラスタの構築に問題がある場合は、『Oracle Coherenceの管理』でマルチキャスト接続テストの実行方法を参照してください。
マルチキャストフリーのクラスタリング
デフォルトでは、クラスタの形成時に他のノードを検出するためにマルチキャスト・プロトコルが使用されます。マルチキャスト・ネットワーキングが適さない場合、または環境内で使用できない場合には、well-known-addresses
機能を使用するとマルチキャスト・トラフィックを使用する必要がなくなります。
要素
表A-42で、multicast-listener
要素のサブ要素を説明します。
表A-42 multicast-listenerのサブ要素
要素 | 必須 /オプション | 説明 |
---|---|---|
|
オプション |
マルチキャスト・ソケットがバインドされるIPアドレスを指定します。デフォルトでは、マルチキャスト・ソケットにはunicast-listenerのIPアドレスのインタフェース(NIC)が使用されます。このオプションにより、マルチキャスト用に別のインタフェースを指定できます。このアドレスを |
< |
必須 |
マルチキャスト・ソケットがリスニングまたは公開を行うマルチキャストIPアドレスを指定します。有効な値は224.0.0.0から239.255.255.255です。デフォルト値は、リリースおよびビルド・レベルによって異なり、一般的に 事前構成済システム・プロパティのオーバーライド値は |
< |
必須 |
マルチキャスト・ソケットがリスニングまたは公開を行うポートを指定します。ポート値はWKA構成にも使用されます。有効な値は1から65535です。他のソフトウェアに同じポートがランダムに割り当てられるのを回避するために、オペレーティング・システムのエフェメラル・ポートの範囲外のクラスタ・ポートを指定します。値は1024から8999の間にすることをお薦めします。デフォルト値は7574です。 事前構成済システム・プロパティのオーバーライド値は |
< |
必須 |
マルチキャストの有効時間設定を指定します。これにより、パケットが横断するホップの最大数を決定します。ホップは、あるネットワーク・セグメントから別のネットワーク・セグメントへの、ルーターを使用した横断として測定されます。有効な値は0から255です。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
必須 |
オペレーティング・システムがバッファリングを要求される受信パケットの量を指定します。この値はパケット数またはバイト数で表します。 |
|
< |
必須 |
マルチキャスト・リスナーの実行スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は8です。 |
< |
必須 |
新しいメンバーがクラスタの形跡を見つけないで待機する時間を指定します(ミリ秒単位)。この時間を超過すると、自身のクラスタが開始され、上位クラスタ・メンバーに自身が昇格されます。有効な値は1000から1000000です。デフォルト値は 注意: 本番で使用する場合、推奨値は |
< |
必須 |
パケットをユニキャストとマルチキャストのいずれで送信するかを決定する際に使用するしきい値(%)を指定します。この割合は1 - 100%で指定します。n個のノードで構成されるクラスタにおいて、特定のノードが他の送信先ノードのセット(送信者自身を除く)のサイズをdとすると(dは0からn-1)、次の両方とも当てはまる場合にのみ、パケットはマルチキャストで送信されます。
有効な値は1から100です。デフォルト値は 注意: この要素は |
使用場所: participant
説明
name-service-addresses
要素には、1つ以上のネーム・サービスTCP/IPアクセプタのアドレス(IPまたはDNS名およびポート)を記述します。フェデレーション・サービスは、この情報を使用してリモート・クラスタとの接続を確立します。TCP/IPイニシエータは、記載されたアドレスをすべて試すか、接続が確立されるまで、アドレスへの接続をランダムに試行します。
name-service-address
要素をtcp-initiator
のサブ要素として使用する方法の詳細は、キャッシュ構成リファレンスのname-service-addressesを参照してください。
要素
表A-43で、name-service-addresses
要素のサブ要素を説明します。
表A-43 name-service-addressesのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
ネーム・サービスTCP/IPアクセプタがリスニングを行うアドレス(IPまたはDNS名およびポート)を指定します。 |
|
オプション |
ネーム・サービスTCP/IPアクセプタがリスニングを行うアドレス(IPまたはDNS名およびポート)またはそのアドレスを提供する |
|
|
オプション |
IPアドレスまたはDNS名を指定します。 |
使用場所: packet-publisher
説明
notification-queueing
要素は、他のクラスタ・ノードに送信される通知パケットのタイミングを指定するために使用します。通知パケットは、確認が要求されているパケットを受信したことの肯定応答に使用されます。
要素
次の表で、notification-queuing
要素のサブ要素を説明します。
表A-44 notification-queuingのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
パケット・パブリッシャの最大遅延時間を指定します(ミリ秒単位)。この時間を超過すると、ACKパケットが送信されます。ACKパケットは、バッチ化された肯定応答数がACKパケットを満たした場合に、早期に送信されることがあります。この値はリモート・ノードの |
< |
必須 |
パケット・パブリッシャの遅延時間を指定します(ミリ秒単位)。この時間を超過すると、NACKパケットが送信されます。デフォルト値は |
使用場所: cluster-config
説明
outgoing-message-handler
要素には、送信メッセージ・ハンドラ(ディスパッチャとも呼ばれる)関連の構成情報を記述します。
使用場所: flow-control
説明
クラスタ・ノードに送信する未確認パケットの数を定義します。このパケット数を超過すると、そのノードを送信先とするパケットは遅延されます。これにより、送信側が原因で受信側のネットワーク・バッファがオーバーフローすることがなくなります。
要素
表A-46で、outstanding-packets
要素のサブ要素を説明します。
表A-46 outstanding-packetsのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
クラスタ・ノードに送信する未確認パケットの最大数です。このパケット数を超過すると、そのノードを送信先とするパケットは遅延されます。この値を256未満に設定しないことをお薦めします。デフォルト値は |
< |
オプション |
クラスタ・ノードに送信する未確認パケット数の範囲の下限です。このパケット数を超過すると、そのノードを送信先とするパケットは遅延されます。この値を16未満に設定しないことをお薦めします。デフォルト値は |
説明
データグラム・ソケットに使用するオペレーティング・システムのバッファのサイズを指定します(パケットまたはバイト単位)。
要素
表A-47で、packet-buffer
要素のサブ要素を説明します。
表A-47 packet-bufferのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
unicast-listener、multicast-listenerおよびpacket-publisherの場合: データグラム・ソケット自身がバッファに求められるサイズのpacket-sizeのパケット数を指定します。
|
|
オプション |
基礎になるソケット・バッファの要求されるサイズを、パケット数ではなくバイト数で指定します。
|
使用場所: packet-delivery
説明
packet-bundling
要素には、ネットワーク切替えインフラストラクチャにかかる負荷を軽減するために、複数の小さなパケットを1つの大きなパケットにバンドルする操作に関連する構成情報を記述します。
要素
表A-48で、packet-bundling
要素のサブ要素を説明します。
表A-48 packet-bundlingのサブ要素
要素 | 必須/オプション | 説明 |
---|---|---|
< |
オプション |
追加のパケットがバンドルされるまで待機する間のパケットの最大遅延時間。この値を0に設定すると、待機のないアルゴリズムとなり、即座にアクセスできるパケットのみがバンドルされます。0より大きい値を設定すると、追加のパケットが得られるまで待機する間に、多少の送信遅延が発生します。スループットに有害な影響が出ないように、通常この値は250マイクロ秒未満に設定します。単位を指定しない場合は、ナノ秒と見なされます。デフォルト値は |
< |
オプション |
パケット遅延アルゴリズムの積極性を指定します。maximum-deferral-time要素では遅延時間の上限を定義しますが、aggression-factorは平均の遅延時間に影響します。積極性の値が高いほど、パブリッシャが追加のパケットを待つ時間が長くなります。この係数は実数で表します。多くの場合は待機時間を最小に抑えながらパケットの使用率を上げることができるように、0.0から1.0の値を使用します。デフォルト値は |
使用場所: packet-publisher
説明
パケット配信に関連するタイミングおよび転送レートのパラメータを指定します。
要素
表A-49で、packet-delivery
要素のサブ要素を説明します。
表A-49 packet-deliveryのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
確認が要求されるパケットの場合、対応するACKパケットを待つ最小時間をミリ秒単位で指定します。この時間を超過すると、パケットが再送信されます。デフォルト値は |
< |
必須 |
確認が要求されるパケットの場合、最大時間をミリ秒単位で指定します。この時間を超過すると、パケットが再送信されます。このタイムアウトが経過した後、Coherenceでは受信側が終了していると見なすかどうかが決定されます。これを決定するには、他のノードがその受信者と通信できているかどうかなど、他のデータも考慮されます。デフォルト値は |
< |
必須 |
ハートビートの間隔を指定します。各メンバーはユニキャストのハートビートを発行し、最も上位のメンバーは、ブロードキャスト・メッセージとなるクラスタ・ハートビートを発行します。ハートビートは、高速な停止検出の一環として |
オプション |
ノード当たりのパケット速度の調整およびリモートのGCの検出を構成します。 |
|
オプション |
Coherenceでパケット使用率の最大化を試行する積極性を構成します。 |
使用場所: cluster-config
説明
ネットワーク・データ転送を管理するパケット・パブリッシャの構成情報を指定します。
信頼性のあるパケット配信
パケット・パブリッシャは、送信したパケットが送信先のクラスタ・ノードに確実に届くように管理します。パブリッシャは肯定応答を待つ一連のパケットを保持し、ACKがpacket-delivery
再送信タイムアウトまでに届かない場合、そのパケットは再送信されます(<packet-delivery>
サブ要素を参照)。受信側ノードはACKを遅延して、一連のACKを1つのレスポンスにバッチ化します(<notification-queuing>
サブ要素を参照)。
要素
表A-50で、packet-publisher
要素のサブ要素を説明します。
表A-50 packet-publisherのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
使用するパケットのサイズを指定します。 |
|
必須 |
信頼性のあるパケット配信に関連するタイミングのパラメータを指定します。 |
|
必須 |
通知キューに関連する構成情報を記述します。 |
|
必須 |
パブリッシャのキューに配置できるパケットの最大数を指定します。この数を超過すると、クライアント・スレッドによってブロックされます。 |
|
必須 |
オペレーティング・システムがバッファリングを要求される送信パケットの数を指定します。この値はパケット数またはバイト数で表します。 |
|
< |
必須 |
パケット・パブリッシャの実行スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
オプション |
TCMPクラスタリングを有効にするかどうかを指定します。Coherence*ExtendベースとCoherence TCMPベース両方のクラスタリングを使用している場合、この機能を使用してTCMPを無効化し、ノードがExtendプロトコルのみを使用して接続するようにできます。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
使用場所: packet-publisher
説明
packet-size要素は、パケットの最大サイズと最適サイズを指定します。クラスタ・ノードは、いずれも同一の最大パケット・サイズを使用する必要があります。
要素
表A-51で、packet-size
要素のサブ要素を説明します。
表A-51 packet-sizeのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
すべてのクラスタ・メンバーが問題なく処理できるパケット・サイズをバイト単位で指定します。この値は、クラスタ内のすべてのメンバーで同一にする必要があります。小さい値を設定することでクラスタの最大サイズを意図的に制限できます。これには512以上の値を指定する必要があります。デフォルト値は64KBです。 |
< |
必須 |
ユニキャスト・ソケットおよびマルチキャスト・ソケットで送受信される これには |
使用場所: cluster-config
説明
パケット・パブリッシャの負荷が高い場合、ネットワーク・データ転送に使用するパケット・スピーカーの構成情報を指定します。
注意:
パケット・スピーカーは、データ通信のデフォルト・プロトコルであるTCMP/TMBには使用されません。
要素
表A-52で、packet-speaker
要素のサブ要素を説明します。
表A-52 packet-speakerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
packet-speakerスレッドを有効化するかどうかを指定します。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
オプション |
スピーカーの起動に必要なパケットの負荷を指定します。 |
|
< |
必須 |
パケット・スピーカーの実行スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
使用場所: participants
説明
participant
要素は、フェデレーションに参加しているリモートCoherenceクラスタを指定します。任意の数の参加者を定義できます。
要素
表A-53で、participant
要素のサブ要素を説明します。
表A-53 participantのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
必須 |
参加者のクラスタ名を指定します。 |
|
オプション |
リモート参加者の起動アクションを指定します。このアクションは、起動時にローカル参加者によって実行されます。有効な値は次のとおりです。
|
|
オプション |
接続先の参加者への接続のタイムアウトを指定します。 この要素の値は、
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は、 |
|
オプション |
接続先の参加者に中止する前に接続を試行する合計時間を指定します。 この要素の値は、
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は |
|
オプション |
フェデレーテッド・レプリケーション・メッセージの確認タイムアウトを指定します。 この要素の値は、
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は、 |
|
オプション |
レプリケーション・メッセージの送信に使用可能な最大ネットワーク帯域幅を指定します。デフォルト値は無制限です。有効な値は、オプションの係数と単位のディスクリプタが付いた10進値です。 有効な係数のディスクリプタは次のとおりです。
値に係数が含まれていない場合は、1が係数として適用されます。 有効な単位のディスクリプタは次のとおりです。
単位が指定されていない場合は、 |
|
オプション |
更新されたキャッシュ・エントリをリモート参加者にレプリケートするとき、フェデレーション・サービスに古い値を含めるかどうかを指定します。有効な値は、 |
|
オプション |
レプリケーションに選択可能なジャーナル・エントリの最大数を指定します。バッチ・サイズは、レプリケート時にヒープ・メモリーを制限内に保持します。有効な値は、エントリの数を表す整数です。デフォルト値は50です。 |
|
オプション |
参加者の地理的メタデータを指定します。値は、暗黙的な構造なしのユーザー定義で、参加者の定義に使用されます(例: 緯度、経度、国コードなど)。 |
|
オプション |
参加者のタイプを指定します。有効な値は次のとおりです。
値が指定されていない場合のデフォルト値は、 |
オプション |
フェデレーション変更レコードのイベント・インターセプタの数を指定します。 |
|
オプション |
参加者のソケット・アドレスを指定します。参加者の設定に応じて、1つ以上のプロキシまたは記憶域が有効なノードのいずれかにアドレスを指定できます。 |
|
オプション |
フェデレーションの一部として参加しているこのクラスタについて、1つ以上のネーム・サービスTCP/IPアクセプタのアドレスを含めます。 |
使用場所: federation-config
説明
participants
要素には、各フェデレーション参加者の宣言データを記述します。
要素
表A-53で、participants
要素のサブ要素を説明します。
表A-54 participantsのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
フェデレーションに参加しているリモートCoherenceクラスタを指定します。 |
使用場所: flow-control
説明
Coherenceでリモート一時停止検出を使用すると、(GCが長いなどが原因で)応答のないクラスタ・ノードを検出し、それに対して反応できます。ノードが一時停止としてマークされた場合、そのノードを送信先とするパケットは、ノードが応答を再開するまでは、通常より遅い速度で送信されます。リモートGCの検出を使用すると、ノードが応答できない間にノードがあふれないようにできます。
要素
表A-55で、pause-detection
要素のサブ要素を説明します。
表A-55 pause-detectionのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
オプション |
応答のないクラスタ・ノードに再送信するパケットの最大数です。このパケット数を超過すると、そのノードは一時停止していると見なされます。この値を0に指定すると、一時停止検出が無効になります。デフォルト値は |
使用場所: persistence-environments
説明
persistent-environment
要素には、永続性環境の実装の構成情報を記述します。この要素はid
属性をサポートしており、複数の環境定義を作成してキャッシュで参照できます。次に例を示します。
<persistence-environments> <persistence-environment id="environment1"> <persistence-mode>active</persistence-mode> <active-directory>/environment1/active</active-directory> <snapshot-directory>/environment1/snapshot</snapshot-directory> <trash-directory>/environment1/trash</trash-directory> </persistence-environment> <persistence-environment id="environment2"> <persistence-mode>active</persistence-mode> <active-directory>/environment2/active</active-directory> <snapshot-directory>/environment2/snapshot</snapshot-directory> <trash-directory>/environment2/trash</trash-directory> </persistence-environment> </persistence-environments>
ディレクトリの場所は、ローカル・ディスクまたは共有ディスク上が可能です。ローカル・ディスク記憶域では、記憶域が有効なホストのリストを構成する必要があります。詳細は、永続性のaddress-provider要素を参照してください。
注意:
永続性がNFSマウント・ファイル・システムを使用するように構成されている場合、NFSマウントは、多くのオペレーティング・システムでデフォルトである非同期IOではなく同期IOを使用するよう構成される必要があります。非同期IOを使用すると、ファイル・システムが停止により応答しなくなった場合、データの損失を起こす可能性があります。構成の詳細は、オペレーティング・システムのmount
に関するドキュメントを参照してください。
要素
表A-56で、persistence-environment
要素のサブ要素を説明します。
表A-56 persistence-environmentのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
デフォルトの永続性環境のかわりに使用されるカスタムの永続性環境の実装を指定します。 |
|
オプション |
永続性環境をキャッシュ・データの継続的な永続化(アクティブ)に使用するか、リクエストされた場合(オンデマンド)にのみ使用するかを指定します。有効な値は、 |
|
オプション |
キャッシュ・データが永続性環境によってアクティブに永続化されるディレクトリのパスを指定します。デフォルト値は |
|
オプション |
キャッシュデータのコピーが永続性環境によって永続化されるディレクトリのパスを指定します。デフォルト値は |
|
オプション |
破損した可能性のある永続データが永続性環境によって格納されるディレクトリのパスを指定します。デフォルト値は |
使用場所: cluster-config
説明
persistence-environments
要素には、各永続性環境の宣言データを記述します。
要素
表A-57で、persistence-environments
要素のサブ要素を説明します。
表A-57 persistence-environmentsのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
各永続性環境の実装の構成情報を記述します。 |
使用場所: ssl
、identity-manager
およびtrust-manager
。
説明
<provider>
要素には、java.security.Provider
クラスを拡張するセキュリティ・プロバイダの構成情報を記述します。
要素
表A-58で、provider
要素のサブ要素を説明します。
表A-58 providerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
クラス名は、この要素を使用するか、 |
|
オプション |
この要素は、 |
|
オプション |
この要素は、 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
プロバイダ実装のクラス初期化パラメータを記述します。 この要素は、 |
使用場所: journaling-config
説明
<ramjournal-manager>
要素には、RAMジャーナル・リソース・マネージャの構成を記述します。これは、ジャーナルベースのストレージのメモリー・バッファをメモリー内で管理します。RAMジャーナル・リソース・マネージャは、フラッシュ・ジャーナル・リソース・マネージャを使用してラージ・オブジェクトを格納し、RAMジャーナルに割り当てられている合計メモリー量に達したときにはオーバーフローとしても使用されます。RAMジャーナルでは、ジャーナルのガベージ・コレクションが一時的に要求に従うことができない場合にも、フラッシュ・ジャーナルを使用します。フラッシュ・ジャーナル・リソース・マネージャの構成の詳細は、flashjournal-managerを参照してください。
要素
表A-59で、ramjournal-manager
要素のサブ要素を説明します。
表A-59 ramjournal-managerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
この値未満であれば、ジャーナル・ファイルが圧縮(ガベージ・コレクション)に適したものになる、ライブ・データ率を指定します。 |
|
オプション |
RAMジャーナルに格納するバイナリ値の最大サイズをバイト単位で指定します。4MB以下の値を指定する必要があります。デフォルト値は 最大値サイズを超えるバイナリ値は、自動的にフラッシュ・ジャーナルに委任されます。 |
|
オプション |
基礎となるジャーナル・ファイルの最大ファイル・サイズを指定します。この値は2の累乗であり、ブロック・サイズの倍数である必要があります。値は2MBから2GBの範囲にする必要があります。デフォルト値は |
|
オプション |
ジャーナル・コレクタが、タイムアウトと判断する前に待機する時間を指定します。タイムアウトの最小値は30sです。有効な値は、時間間隔を表す文字列です。デフォルト値は |
|
オプション |
ジャーナルで使用するRAMの最大量を指定します。この値は、使用可能なヒープの最大量の割合として、または特定のメモリー量として指定できます。値にパーセント記号(%)が含まれている場合は、JVM最大ヒープの割合として解釈されます(JVM最大ヒープは通常、Javaコマンド行で 事前構成済システム・プロパティのオーバーライド値は |
|
オプション |
仮想マシンのバイト・バッファとヒープ外NIOバッファのどちらで使用するのかを指定します。 |
使用場所: participant
説明
participant
内のremote-addresses
の使用は非推奨になりました。かわりに、name-service-addressesを使用してください。
remote-addresses
要素には、フェデレーションの一部として参加しているクラスタのアドレスを記述します。
注意:
要素
表A-60で、remote-addresses
要素のサブ要素を説明します。
表A-60 remote-addressesのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
ソケットがバインドされるアドレス(IPまたはDNS名およびポート)を指定します。 |
|
オプション |
ソケット・アドレス情報(IPまたはDNS名およびポート)または |
使用場所: management-config
説明
Reporterには、JMXのレポート作成機能が用意されています。Reporterは、即時利用可能なレポートを提供し、さらにカスタムのレポートの作成をサポートします。レポートは、管理者および開発者が容量管理や問題のトラブルシューティングを行う際に役立ちます。
要素
表A-61で、reporter
要素のサブ要素を説明します。
表A-61 reporterのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
必須 |
レポート・グループ・デプロイメント・ディスクリプタの場所を指定します。デフォルト・ファイルは |
|
必須 |
ノードの起動時にReporterを自動的に起動させるかどうかを指定します。有効な値は、 |
|
必須 |
Reporterを複数の管理ノード上で実行するかどうかを指定します。有効な値は、 |
|
オプション |
レポート内に表示するタイムスタンプのタイムゾーンを指定します。サポートされるタイムゾーン書式の詳細は、 |
|
オプション |
レポート内に表示するタイムスタンプの日時の書式を指定します。 |
使用場所: coherence
要素
表A-62で、security-config
要素のサブ要素を説明します。
表A-62 security-configのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
アクセス・コントローラ・セキュリティ機能が有効かどうかを指定します。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
< |
必須 |
コール元の認証に使用するJAAS LoginModuleの名前を指定します。この名前は、JAASで使用される構成ファイルのモジュールと一致している必要があります( |
必須 |
|
|
オプション |
|
|
オプション |
ユーザーIDを確立するためIDトークンの検証の際にコールされる |
|
オプション |
|
|
|
オプション |
リモート・キャッシュまたはサービス参照がサブジェクトによって共有されるかどうかを指定します。有効な値は |
|
オプション |
コール元が対応する権限オブジェクトによって記述されるアクションを実行することを認可するための環境固有の機能を表す |
使用場所: serializers
説明
serializer
要素には、シリアライザ・クラス構成を記述します。シリアライザ・クラスはcom.tangosol.io.Serializer
を実装する必要があります。JavaシリアライザとPOFシリアライザが事前に定義されています。
<cluster-config> <serializers> <serializer id="java"> <class-name>com.tangosol.io.DefaultSerializer</class-name> </serializer> <serializer id="pof"> <class-name>com.tangosol.io.pof.ConfigurablePofContext</class-name> <init-params> <init-param> <param-type>String</param-type> <param-value>pof-config.xml</param-value> </init-param> </init-params> </serializer> </serializers> </cluster-config>
シリアライザの定義は、個々のキャッシュ・スキーム定義で参照され(serializerを参照)、また明示的にシリアライザを定義しないサービスのデフォルト・シリアライザでも参照されます(defaultsを参照)。
必要に応じて、オペレーション・オーバーライド・ファイルで追加のシリアライザを定義できます。
要素
表A-63で、serializer
要素のサブ要素を説明します。
表A-63 serializerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
|
|
オプション |
カスタムのシリアライザ・インスタンスを作成するためのファクトリ・クラスを指定します。このインスタンスは、 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
シリアライザ実装のクラス初期化パラメータを記述します。 |
使用場所: cluster-config
説明
serializers
要素には、各シリアライザの宣言データを記述します。
要素
表A-64で、serializers
要素のサブ要素を説明します。
表A-64 serializersのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
特定のシリアライザの宣言データを指定します。 |
使用場所: services
説明
Coherenceサービスの構成を指定します。
サービス・コンポーネント
構成可能なサービスの種類は、次のとおりです。
PartitionedService.PartitionedCache
: サービスを実行する複数のクラスタ・ノードにわたって、キャッシュ・エントリを均一にパーティション化するキャッシュ・サービス。このサービスは、多くの場合、分散キャッシュ・サービスと呼ばれます。
ReplicatedCache
: サービスを実行する全クラスタ・ノードの全キャッシュ・エントリのコピーを保持するキャッシュ・サービス。
ReplicatedCache.Optimistic
: 最適なロックを使用するReplicatedCache
のバージョン。
SimpleCache
: 並行処理制御なしのReplicatedCache
のバージョン。
LocalCache
: すべてのキャッシュ・エントリが1つのクラスタ・ノードに存在するキャッシュのキャッシュ・サービス。
InvocationService
: リモート・クラスタ・ノードでのカスタム操作の実行に使用されるサービス。
ProxyService
: Coherence*Extendクライアントからの接続を受け入れるサービス。
RemoteCache
—キャッシュ操作をCoherence*Extendクライアントからクラスタ上のキャッシュにルーティングするサービスです。
RemoteInvocation
—キャッシュ呼出しタスクをCoherence*Extendクライアントからクラスタ上のキャッシュにルーティングするサービスです。
NameService
—このサービスは特殊化されたTCPアクセプタで、Coherence*Extendクライアントでは、プロキシ・サービス・アドレスではなく、プロキシ・サービス名を指定することでプロキシに接続できます。
RemoteNameService
— JVMがクラスタに参加せずにリモートNameService
を使用できるようにするNameService
の実装です。
PartitionedService.PartitionedCache.FederatedCache
– クラスタ間でキャッシュ・データをレプリケートする専用のパーティション・キャッシュ・サービス。
要素
表A-65で、services
要素のサブ要素を説明します。
表A-65 serviceのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
サービスの正規名を指定します。これにより、キャッシュ構成のキャッシング・スキームの |
< |
必須 |
サービスの完全修飾クラス名、またはベースのサービス・コンポーネントに対する再配置可能なコンポーネントの相対名を指定します。有効な値は次のとおりです。
|
< |
オプション |
このサービスで使用する <use-filters> <filter-name>gzip</filter-name> </use-filters> この例では、このサービスによって使用されるネットワーク・メッセージに対して |
オプション |
各サービスに固有の初期化パラメータを指定します。各パラメータの説明を次に示します。 |
サービスの初期化パラメータは、Coherenceのオペレーション構成デプロイメント・ディスクリプタの<init-param>
要素によって定義されます。init-param
の下に表示されるパラメータは、サービスによって異なります。
次の各項では、各サービスに構成可能なパラメータについて説明します。
各項の表では、各サービスに構成可能な具体的な<param-name>
と<param-value>
のペアについて説明します。「パラメータ名」列には<param-name>
要素の値が、「パラメータ値の説明」列には対応する<param-value>
要素に対する可能な値が示されています。
DistributedCacheサービスでは、表A-66に記載されたパラメータがサポートされます。これらの設定は、各サービス・インスタンスに対してcoherence-cache-config.xml
ディスクリプタ内の<distributed-scheme
>要素の一部としても指定できます。
表A-66 DistributedCacheサービスのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
リース所有権の精度を指定します。有効な値は次のとおりです。
値が |
|
分散キャッシュ・パーティションの数を指定します。分散キャッシュ・サービスを実行している記憶域が有効なクラスタ・メンバーはそれぞれ均等な数のパーティションを管理します。 有効な値は、1と32767の間の正の整数で、素数にする必要があります。デフォルト値は257パーティションです。詳細は、パーティションの数の変更を参照してください。 |
|
この 通常、構成ファイル内ではこの値を未指定にしておき、システム・プロパティ 事前構成済システム・プロパティのオーバーライド値は |
|
プライマリ・バケット分散のしきい値をキロバイト単位で指定します。分散キャッシュ・サービスに新しいノードが結合する場合、またはサービスのメンバーのいずれかの結合が解除される場合、残りのノードによって、バケット所有権の再分散タスクが実行されます。このプロセスでは、所有権情報とともに既存のデータの均衡化が再実行されます。このパラメータでは、データ転送通信で優先されるメッセージ・サイズを示します。この値を低く設定すると、分散プロセスの所要時間は長くなりますが、このアクティビティ実行中のネットワーク帯域幅の使用量は軽減されます。有効な値は、ゼロより大きな整数です。デフォルト値は0.5MBです。 事前構成済システム・プロパティのオーバーライド値は |
|
パーティション・キャッシュ・サービスのうち、各保存単位のバックアップ・データをキャッシュに保持するメンバーの数を指定します。デフォルト値は1です。 事前構成済システム・プロパティのオーバーライド値は |
|
注意: パーティション・キャッシュ・サービスで使用されるデーモン・スレッドの数を指定します。有効な値は、正の整数、 単にインメモリー・データを使用する(リードスルー、ライトスルーおよびライトビハインドを使用しない)シナリオまたは単純なアクセスを使用する(エントリ・プロセッサや集計などを使用しない)シナリオでは、値を 事前構成済システム・プロパティのオーバーライド値は |
|
|
|
|
|
|
|
タスクが実行できる時間をミリ秒単位で指定します。この時間を超過すると、ハングしたと見なされます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。 注意: ポストされたタスクがまだ開始されていない場合は、ハングとみなされません。この属性は、スレッド・プールが使用される場合にのみ適用されます。 事前構成済システム・プロパティのオーバーライド値は |
|
サービス・ワーカー・スレッド上で実行するリクエストのタイムアウト値をミリ秒単位で指定します。この属性は、スレッド・プールが使用されている場合にのみ適用され、 事前構成済システム・プロパティのオーバーライド値は |
|
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
この要素の値は、
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
|
ライトビハインドを必要としないキャッシュ内の各保存単位のバックアップ・データ(つまり、クラスタ全体がシャットダウンしても失われにくいデータ)を保持する、パーティション・キャッシュ・サービスのメンバー数を指定します。ライトビハインドが必要とマークされている保存単位は、 この要素の値は0に設定するか、要素の指定を完全に省略する必要があります。論理的な根拠として、このデータは別のデータ・ストアにバックアップされるため、書込み対象のライトビハインド・キューにデータが一時的に配置される場合を除いて、メモリー内でのバックアップは必要ありません。値0は、ライトビハインドが発生した場合に、そのデータのバックアップ・コピーが破棄されることを意味します。ただし、ライトビハインドが発生するまでは、 推奨値は0です。 |
|
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。パラメータが指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 事前構成済システム・プロパティのオーバーライド値は |
|
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。すべてのサービスに関してサービス・ガーディアンをグローバルに構成する方法の詳細は、service-guardian要素を参照してください。 有効な値は次のとおりです。
|
|
|
|
パーティション・キャッシュ・サービス用のクォーラム・ポリシー設定を指定します。partitioned-quorum-policy-schemeを参照してください。 |
|
パーティション・サービスでパーティション分散を管理する際に使用する戦略を指定します。
事前構成済システム・プロパティのオーバーライド値は |
|
バックアップ更新をデルタ形式で圧縮するか、全体を送信するかを指定します。デルタ更新は、バックアップ・エントリの一部を表しており、プライマリ・エントリと同期させるには変更が必要です。有効な値は次のとおりです。
事前構成済システム・プロパティのオーバーライド値は |
|
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 事前構成済システム・プロパティのオーバーライド値は |
|
パーティション・キャッシュ・サービスが、クライアントに同時に応答する際に、変更を非同期にバックアップするかどうかを指定します。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
|
分散キャッシュ・サービスの永続性関連の構成を指定します。 |
|
デーモン・スレッドの最大数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
|
デーモン・スレッドの最小数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
ReplicatedCacheサービスでは、表A-67に記載されたパラメータがサポートされます。これらの設定は、各サービス・インスタンスに対してcoherence-cache-config.xml
ディスクリプタ内のreplicated-scheme
要素の一部としても指定できます。
表A-67 ReplicatedCacheサービスのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
標準的なリースの継続時間をミリ秒単位で指定します。リースがこのミリ秒数を超過すると、ロックは自動的に解放されます。期限切れが発生しないリースを指定するには、この値をゼロに設定します。この設定の目的は、スタック・スレッドを原因とするデッドロックまたはブロックが発生しないようにすることです。最長の予想ロック継続時間より高い(たとえば、トランザクション・タイムアウトより高い)値を設定する必要があります。また、packet-delivery/timeout-millisecondsの値より高い値を設定することをお薦めします。有効な値は、桁数の多い正の数値またはゼロです。デフォルト値は |
|
リース所有権の精度を指定します。リリース2.3以降で使用できます。有効な値は次のとおりです。
値が |
|
リースの問題を最新のロック・ホルダーに転送するかどうかを指定します。有効な値は、 |
|
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
この要素の値は、
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
|
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。パラメータが指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 事前構成済システム・プロパティのオーバーライド値は |
|
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。すべてのサービスに関してサービス・ガーディアンをグローバルに構成する方法の詳細は、service-guardian要素を参照してください。 有効な値は次のとおりです。
|
|
|
|
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 事前構成済システム・プロパティのオーバーライド値は |
OptimisiticCacheサービスでは、表A-68に記載されたパラメータがサポートされます。これらの設定は、各サービス・インスタンスに対してcoherence-cache-config.xml
ディスクリプタ内のoptimistic-scheme
要素の一部としても指定できます。
表A-68 OptimisiticCacheサービスのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
この要素の値は、
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
|
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。パラメータが指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 事前構成済システム・プロパティのオーバーライド値は |
|
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。すべてのサービスに関してサービス・ガーディアンをグローバルに構成する方法の詳細は、service-guardian要素を参照してください。 有効な値は次のとおりです。
|
|
|
|
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 事前構成済システム・プロパティのオーバーライド値は |
起動サービスでは、表A-69に記載されたパラメータがサポートされます。これらの設定は、各サービス・インスタンスに対してcoherence-cache-config.xml
ディスクリプタ内のinvocation-scheme
要素の一部としても指定できます。
表A-69 起動サービスのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
注意: サービスで使用されるデーモン・スレッドの数を指定します。有効な値は、正の整数、 単にインメモリー・データを使用する(リードスルー、ライトスルーおよびライトビハインドを使用しない)シナリオまたは単純なアクセスを使用する(エントリ・プロセッサや集計などを使用しない)シナリオでは、値を 事前構成済システム・プロパティのオーバーライド値は |
|
タスクが実行できる時間をミリ秒単位で指定します。この時間を超過すると、ハングしたと見なされます。注意: ポストされたタスクがまだ開始されていない場合は、ハングと見なされません。この属性は、スレッド・プールが使用される場合にのみ適用されます。 事前構成済システム・プロパティのオーバーライド値は |
|
タイムアウト可能なリクエスト(ポーリングおよび 事前構成済システム・プロパティのオーバーライド値は |
|
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
この要素の値は、
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
|
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。パラメータが指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 事前構成済システム・プロパティのオーバーライド値は |
|
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。すべてのサービスに関してサービス・ガーディアンをグローバルに構成する方法の詳細は、service-guardian要素を参照してください。 有効な値は次のとおりです。
|
|
|
|
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 事前構成済システム・プロパティのオーバーライド値は |
|
デーモン・スレッドの最大数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
|
デーモン・スレッドの最小数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
LocalCacheサービスでは、表A-70に記載されたパラメータがサポートされます。
表A-70 LocalCacheサービスのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
入力、削除および消去操作にロックを施行するかどうかを指定します。この値がfalseの場合は、クライアントがロックおよびロック解除を明示的にコールする必要があります。 デフォルト値は |
|
ロックの取得を試行し続ける時間をミリ秒単位で指定します。このパラメータは、ロックの施行が有効になっている場合のみ使用されます。値を デフォルト値は |
プロキシ・サービスでは、表A-71に記載されたパラメータがサポートされます。これらの設定は、各サービス・インスタンスに対してcoherence-cache-config.xml
ディスクリプタ内のproxy-scheme
要素の一部としても指定できます。
表A-71 プロキシ・サービスのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
接続アクセプタの構成を記述します。サービスでは、この接続アクセプタを使用してCoherence*Extendクライアントからの接続を受け入れ、クライアントがクラスタに参加していなくても、クラスタの提供するサービスを使用できるようにします。 |
|
このサービスによって管理されるクラスタ化サービス・プロキシの構成を記述します。 |
|
注意: プロキシ・サービスで使用されるデーモン・スレッドの数を指定します。有効な値は、正の整数または 注意: プロキシ・サービス・スレッドは、コール元のアプリケーションのかわりに操作を実行します。したがって、スレッド数を明示的に設定する場合は、値は同時操作と同じ数に設定します。 スレッド・プールを無効化するには、 事前構成済システム・プロパティのオーバーライド値は |
|
タスクが実行できる時間をミリ秒単位で指定します。この時間を超過すると、ハングしたと見なされます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。 注意: ポストされたタスクがまだ開始されていない場合は、ハングとみなされません。この属性は、スレッド・プールが使用される場合にのみ適用されます 事前構成済システム・プロパティのオーバーライド値は |
|
タイムアウト可能なタスク(たとえば、 事前構成のシステム・プロパティのオーバーライド値は |
|
他の同名のプロキシに送信されるリクエストがくるまでプロキシが待機する最大時間を指定します。プロキシ間でリクエストが送信されることはないため、このパラメータを使用しないでください。 |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
|
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。パラメータが指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 事前構成済システム・プロパティのオーバーライド値は |
|
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。すべてのサービスに関してサービス・ガーディアンをグローバルに構成する方法の詳細は、service-guardian要素を参照してください。 有効な値は次のとおりです。
|
|
|
|
プロキシ・サービス用のクォーラム・ポリシー設定を指定します。 |
|
プロキシ・スキームの一環として戦略が明示的に構成されていない場合にプロキシ・サービスで使用するデフォルトのロード・バランシング戦略を指定します。有効な値は次のとおりです。
|
|
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 事前構成済システム・プロパティのオーバーライド値は |
|
動的スレッド・プールで許容されるデーモン・スレッドの最大数を指定します。このパラメータは、 事前構成済システム・プロパティのオーバーライド値は |
|
動的スレッド・プールで許容される(および最初に作成される)デーモン・スレッドの最小数を指定します。このパラメータは、 事前構成済システム・プロパティのオーバーライド値は |
RemoteCacheサービスでは、表A-72に記載されたパラメータがサポートされます。これらの設定は、各サービス・インスタンスに対してcoherence-cache-config.xml
ディスクリプタ内のremote-cache-scheme
要素の一部としても指定できます。
表A-72 RemoteCacheサービスのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
クラスタへの接続を確立するためにサービスで使用される接続イニシエータの構成を記述します。 |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
|
キー・アソシエーションの処理を、拡張クライアントによって行うか、クラスタ側まで遅延するかを指定します。有効な値は、 |
RemoteInvocationサービスでは、表A-73に記載されたパラメータがサポートされます。これらの設定は、各サービス・インスタンスに対してcoherence-cache-config.xml
ディスクリプタ内のremote-invocation-scheme
要素の一部としても指定できます。
表A-73 RemoteInvocationサービスのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
クラスタへの接続を確立するためにサービスで使用される接続イニシエータの構成を記述します。 |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
NameServiceサービスでは、表A-74に記載されたパラメータがサポートされます。
表A-74 NameServiceのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
クラスタでCoherence*Extendクライアントの使用に利用可能なプロキシ・サービスを検出するために使用される接続アクセプタの構成が含まれています。 |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
RemoteNameServiceサービスでは、表A-75に記載されたパラメータがサポートされます。
表A-75 RemoteNameServiceのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
クラスタへの接続を確立するためにサービスで使用されるTCP接続イニシエータの構成を記述します。 |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
FederatedCacheサービスでは、表A-76に記載されたパラメータがサポートされます。これらの設定は、各サービス・インスタンスに対してcoherence-cache-config.xml
ディスクリプタ内の<federated-scheme
>要素の一部としても指定できます。
表A-76 FederatedCacheサービスのパラメータ
パラメータ名 | パラメータ値の説明 |
---|---|
|
リース所有権の精度を指定します。有効な値は次のとおりです。
値が |
|
分散キャッシュ・パーティションの数を指定します。分散キャッシュ・サービスを実行している記憶域が有効なクラスタ・メンバーはそれぞれ均等な数のパーティションを管理します。 有効な値は、1と32767の間の正の整数で、素数にする必要があります。デフォルト値は257パーティションです。詳細は、パーティションの数の変更を参照してください。 |
|
この 通常、構成ファイル内ではこの値を未指定にしておき、システム・プロパティ 事前構成済システム・プロパティのオーバーライド値は |
|
プライマリ・バケット分散のしきい値をキロバイト単位で指定します。分散キャッシュ・サービスに新しいノードが結合する場合、またはサービスのメンバーのいずれかの結合が解除される場合、残りのノードによって、バケット所有権の再分散タスクが実行されます。このプロセスでは、所有権情報とともに既存のデータの均衡化が再実行されます。このパラメータでは、データ転送通信で優先されるメッセージ・サイズを示します。この値を低く設定すると、分散プロセスの所要時間は長くなりますが、このアクティビティ実行中のネットワーク帯域幅の使用量は軽減されます。有効な値は、ゼロより大きな整数です。デフォルト値は0.5MBです。 事前構成済システム・プロパティのオーバーライド値は |
|
フェデレーテッド・キャッシュ・サービスのうち、各保存単位のバックアップ・データをキャッシュに保持するメンバーの数を指定します。デフォルト値は1です。 事前構成済システム・プロパティのオーバーライド値は |
|
注意: フェデレーテッド・キャッシュ・サービスで使用されるデーモン・スレッドの数を指定します。有効な値は、正の整数、 単にインメモリー・データを使用する(リードスルー、ライトスルーおよびライトビハインドを使用しない)シナリオまたは単純なアクセスを使用する(エントリ・プロセッサや集計などを使用しない)シナリオでは、値を 事前構成済システム・プロパティのオーバーライド値は |
|
|
|
|
|
|
|
タスクが実行できる時間をミリ秒単位で指定します。この時間を超過すると、ハングしたと見なされます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。 注意: ポストされたタスクがまだ開始されていない場合は、ハングとみなされません。この属性は、スレッド・プールが使用される場合にのみ適用されます。 事前構成済システム・プロパティのオーバーライド値は |
|
サービス・ワーカー・スレッド上で実行するリクエストのタイムアウト値をミリ秒単位で指定します。この属性は、スレッド・プールが使用されている場合にのみ適用され、 事前構成済システム・プロパティのオーバーライド値は |
|
レスポンスがくるまでクライアントが待機する最大時間を指定します。この時間を超過すると、元のリクエストが破棄されます。リクエスト時間はクライアント側で測定されるもので、対応するサーバー・ノードに対して実行のためのリクエストが送信されてからの経過時間に次の時間を加えたものです。
この要素の値は、
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。有効な値は、正の整数またはゼロです(ゼロの場合は、デフォルト・タイムアウトがないことを示します)。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
|
オブジェクト・シリアライゼーション用のシリアライザ・クラスを指定します。シリアライザ・クラスは |
|
ライトビハインドを必要としないキャッシュ内の各保存単位のバックアップ・データ(つまり、クラスタ全体がシャットダウンしても失われにくいデータ)を保持する、フェデレーテッド・キャッシュ・サービスのメンバー数を指定します。ライトビハインドが必要とマークされている保存単位は、 この要素の値は0に設定するか、要素の指定を完全に省略する必要があります。論理的な根拠として、このデータは別のデータ・ストアにバックアップされるため、書込み対象のライトビハインド・キューにデータが一時的に配置される場合を除いて、メモリー内でのバックアップは必要ありません。値0は、ライトビハインドが発生した場合に、そのデータのバックアップ・コピーが破棄されることを意味します。ただし、ライトビハインドが発生するまでは、 推奨値は0です。 |
|
サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。パラメータが指定されていない場合、デフォルトのガーディアンのタイムアウト( この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。 事前構成済システム・プロパティのオーバーライド値は |
|
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。すべてのサービスに関してサービス・ガーディアンをグローバルに構成する方法の詳細は、service-guardian要素を参照してください。 有効な値は次のとおりです。
|
|
|
|
フェデレーテッド・キャッシュ・サービス用のクォーラム・ポリシー設定を指定します。partitioned-quorum-policy-schemeを参照してください。 |
|
フェデレーテッド・サービスでパーティション分散を管理する際に使用する戦略を指定します。
事前構成済システム・プロパティのオーバーライド値は |
|
バックアップ更新をデルタ形式で圧縮するか、全体を送信するかを指定します。デルタ更新は、バックアップ・エントリの一部を表しており、プライマリ・エントリと同期させるには変更が必要です。有効な値は次のとおりです。
事前構成済システム・プロパティのオーバーライド値は |
|
サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
|
信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。
デフォルト値は、 事前構成済システム・プロパティのオーバーライド値は |
|
フェデレーテッド・キャッシュ・サービスが、クライアントに同時に応答する際に、変更を非同期にバックアップするかどうかを指定します。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
|
フェデレーテッド・キャッシュ・サービスの永続性関連の構成を指定します。 |
|
デーモン・スレッドの最大数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
|
デーモン・スレッドの最小数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、 事前構成済システム・プロパティのオーバーライド値は |
使用場所: cluster-config
説明
サービスのデッドロックを検出して解決を試みるサービス・ガーディアンの構成を指定します。
要素
表A-77で、service-guardian
要素のサブ要素を説明します。
表A-77 service-guardianのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。 有効な値は次のとおりです。
|
|
オプション |
サービスがデッドロックされたり応答しなくなったりするのを回避するために使用されるタイムアウト値。 事前構成済システム・プロパティのオーバーライド値は |
内容のオーバーライド属性xml-override
を使用して、この要素の内容の全部または一部を、ベース・ドキュメントの外部にあるXMLドキュメントでオーバーライドすることもできます。詳細は、属性リファレンスを参照してください。
使用場所: cluster-config
説明
services要素には、各サービスの宣言データを記述します。
要素
表A-65で、services
要素のサブ要素を説明します。
表A-78 servicesのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
特定のサービスの宣言データを指定します。 |
使用場所: cluster-config
説明
外部シャットダウン・リクエストを受信したときにクラスタ・ノードで実行するアクションを指定します。外部シャットダウンには、UNIXのkillコマンドやWindowsおよびUNIXのCtrl-C
などがあります。
要素
表A-79で、shutdown-listener
要素のサブ要素を説明します。
表A-79 shutdown-listenerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
外部JVMシャットダウンの際に実行するアクションの種類を指定します。有効な値は次のとおりです。
注意: 本番で使用する場合、外部シャットダウンに対する動作が目的どおりであることがテストで検証されている場合を除き、この値をnoneに設定することをお薦めします。 事前構成済システム・プロパティのオーバーライド値は |
使用場所: cluster-config
説明
snapshot-archivers
要素には、各永続性スナップショット・アーカイバの宣言データを記述します。スナップショット・アーカイバは、永続性スナップショットの保存に使用されます。
要素
表A-80で、shutdown-listener
要素のサブ要素を説明します。
表A-80 snapshot-archiversのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
共有ディレクトリを使用してアーカイブ済スナップショットを格納するために、デフォルトのディレクトリ・ベースのスナップショット・アーカイバの構成情報を記述します。 <directory-archiver id="archiver1"> <archive-directory>/temp/mydirectory</archive-directory> </directory-archiver> |
|
オプション |
|
説明
socket-address
要素は、ソケットがバインドされるアドレス(IPまたはDNS名およびポート)を指定します。
要素
表A-81で、socket-address
要素のサブ要素を説明します。
表A-81 socket-addressのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
ソケットがリスニングまたは公開するIPアドレスを指定します。IPアドレスまたはDNS名を入力します。 |
< |
必須 |
ソケットがリスニングまたは公開を行うポートを指定します。有効な値は1から65535です。異なるクラスタ・ポートが定義されていないかぎり、デフォルトのクラスタ・ポートの7574を使用します。 |
使用場所: socket-providers
、unicast-listener
およびssl
。
説明
<socket-provider>
要素には、ソケットおよびチャンネル・ファクトリの構成情報を記述します。次のソケット・プロバイダがサポートされており、定義済のid
属性名を使用して参照されます。
<socket-providers> <socket-provider id="system"> <system/> </socket-provider> <socket-provider id="tcp"> <tcp/> </socket-provider> <socket-provider id="ssl"> <ssl> <identity-manager> <key-store> <url system-property="coherence.security.keystore"> file:keystore.jks</url> <password system-property="coherence.security.password"/> </key-store> <password system-property="coherence.security.password"/> </identity-manager> <trust-manager> <algorithm>PeerX509</algorithm> <key-store> <url system-property="coherence.security.keystore"> file:keystore.jks</url> <password system-property="coherence.security.password"/> </key-store> </trust-manager> <socket-provider>tcp</socket-provider> </ssl> </socket-provider> <socket-provider id="sdp"> <sdp/> </socket-provider> </socket-providers>
より詳細なSSL構成をサポートするために、別のSSL定義を作成できます。
要素
表A-82で、socket-provider
要素のサブ要素を説明します。
表A-82 socket-providerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
JVMのデフォルトのソケットおよびチャンネル実装のインスタンスを作成するソケット・プロバイダを指定します。これがデフォルトのソケット・プロバイダです。 |
|
オプション |
SSLを使用するソケットおよびチャンネル実装を作成するソケット・プロバイダを指定します。 |
|
オプション |
TCPベースのソケットおよびチャンネル実装を生成するソケット・プロバイダを指定します。 |
|
オプション |
JVMおよび基礎となるネットワーク・スタックでSDPがサポートされている場合、SDPベースのソケットおよびチャネルの実装を生成するソケット・プロバイダを指定します。 |
使用場所: cluster-config
説明
socket-providers
要素には、ソケット・プロバイダ実装ごとの宣言データを記述します。Coherenceでは、system
、tcp
、ssl
およびsdp
のソケット・プロバイダがサポートされています。
要素
表A-83で、socket-providers
要素のサブ要素を説明します。
表A-83 socket-providersのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
ソケットおよびチャンネル・ファクトリの構成情報を指定します。 |
使用場所: socket-provider
説明
<ssl>
要素には、SSLを使用するソケットおよびチャンネル実装を作成するソケット・プロバイダの構成情報を記述します。SSLがユニキャスト・リスナー用に構成されている場合、リスナーはwell-known-addressesを使用して構成する必要があります。
要素
表A-84で、ssl
要素のサブ要素を説明します。
表A-84 sslのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
SSLソケット・プロバイダによって作成されたソケットおよびチャンネル実装が使用するプロトコルの名前を指定します。デフォルト値は |
|
オプション |
セキュリティ・プロバイダ・インスタンスの構成を指定します。 |
|
オプション |
|
オプション |
アイデンティティ・マネージャ・インスタンスを初期化するための構成情報を指定します。 |
|
オプション |
トラスト・マネージャ・インスタンスを初期化するための構成情報を指定します。 |
|
|
オプション |
|
|
オプション |
暗号のリストを指定します。
|
|
オプション |
プロトコル・バージョンのリストを指定します。
|
オプション |
SSLの委譲プロバイダの構成情報を指定します。有効な値は、 |
使用場所: storage-authorizers
説明
storage-authorizer
要素には、com.tangosol.net.security.StorageAccessAuthorizer
インタフェースのインスタンスである必要のある、記憶域アクセス認可者の宣言データを記述します。記憶域アクセス認可者は、サーバー側のアクセス制御を認可します。storage-authorizer
要素はid
属性をサポートしており、複数の記憶域アクセス認可者を定義してキャッシュで参照できます。次に例を示します。
<storage-authorizers> <storage-authorizer id="auditing"> <class-name>package.MyStorageAccessAuthorizer</class-name> </storage-authorizer> <storage-authorizer id="restricted-access"> <class-name>package.AnotherStorageAccessAuthorizer</class-name> </storage-authorizer> </storage-authorizers>
要素
表A-85で、storage-authorizer
要素のサブ要素を説明します。
表A-85 storage-authorizerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
この要素は、 |
|
オプション |
実装クラス・インスタンスを作成するための、ファクトリ・クラスの完全修飾名を指定します。 この要素は、 |
< |
オプション |
オブジェクトのインスタンス化を実行する、ファクトリ・クラスのstaticなファクトリ・メソッドの名前を指定します。 |
オプション |
一致するシグネチャを持つpublicなコンストラクタが含まれる実装によってアクセス可能な初期化パラメータを指定します。初期化パラメータは、 |
使用場所: cluster-config
説明
storage-authorizers
要素は、任意の数の記憶域アクセス認可者の宣言データを記述します。
要素
表A-85で、storage-authorizers
要素のサブ要素を説明します。
表A-86 storage-authorizersのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
記憶域アクセス認可者を指定します。記憶域アクセス認可者は、 |
使用場所: cluster-config
説明
TCPリングを使用すると、クラスタ内の別のノードの停止を迅速に検出できます。これを有効にすると、そのクラスタ・ノードでは、クラスタ全体に及ぶTCP接続のリングを1つ使用します。クラスタ・ノードは、TCP接続を使用して1つのハートビート間隔内で別のノードの停止を検出できます(デフォルト値は1秒です。packet-delivery
の<heartbeat-milliseconds>
サブ要素を参照)。これを無効にすると、別のノードがパケットへの応答を停止したことを非常に長い間隔で検出する方法に頼る必要があります(packet-delivery
の<timeout-milliseconds>
サブ要素を参照)。停止が検出されると、他のすべてのクラスタ・ノードに送信されます。
要素
表A-87で、tcp-ring-listener
要素のサブ要素を説明します。
表A-87 tcp-ring-listenerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
ノードの障害を迅速に検出するためにTCPリング・リスナーを有効にするかどうかを指定します。有効な値は、 |
< |
オプション |
クラスタ・メンバーをホストするコンピュータに接続できないことを決定するために使用するタイムアウトを指定します。マシンに接続できないメンバーを削除する必要があることを決定する前に、指定した回数の接続を試行できます。有効な値は、時間間隔を表す文字列です。タイムアウトを
この機能は、 |
|
オプション |
クラスタ・メンバーをホストするコンピュータが使用できなくなり、これらのクラスタ・メンバーを削除する必要があることを決定する前に試行する接続の回数を指定します。
|
|
オプション |
TCP/IPサーバー・ソケットのバックログ・キューのサイズを指定します。有効値は正の整数です。デフォルト値は、オペレーティング・システムに依存します。 |
< |
必須 |
TCPリング・リスナーの実行スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は6です。 |
使用場所: federation-config
説明
topology-definitions
要素は、トポロジ構成情報を指定します。選択されたトポロジにより、クラスタ間でデータがどのように同期されるかが決定されます。
要素
表A-88で、topology-definitions
要素のサブ要素を説明します。
表A-88 topology-definitionsのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
アクティブ/パッシブ・トポロジの構成情報を指定します。 |
|
オプション |
ハブおよびスコープのトポロジの構成情報を指定します。 |
|
オプション |
集中型レプリケーション・トポロジの構成情報を指定します。 |
|
オプション |
カスタム・トポロジの構成情報を指定します。 |
使用場所: packet-publisher
説明
traffic-jam
要素は、クライアント・スレッドでパケット・パブリッシャがパケットをエンキューしてネットワークに転送する速度を制御するために使用します。この制限を超えると、未処理のパケット数が指定された制限を下回るまで、任意のクライアント・スレッドは強制的に一時停止されます。パブリッシャのパケット転送速度を制限するには、flow-control
要素を参照してください。
要素
表A-89で、traffic-jam
要素のサブ要素を説明します。
表A-89 traffic-jamのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
パブリッシャが許容する保留パケットの最大数を指定します。この数を超過すると、パブリッシャが渋滞しており、クライアント・リクエスト(ローカルの非システム・スレッドからのリクエスト)のペースを落とす必要があると判断されます。ゼロは制限がないことを示します。このプロパティで再送信キューのサイズを制限することにより、予期しないメモリー不足状態のほとんどは発生しなくなります。デフォルト値は |
< |
必須 |
パブリッシャが渋滞しているときにメッセージを送信しようとするクライアント・スレッドを一時停止する時間(ミリ秒)。パブリッシャは、渋滞が解消されるまでメッセージの送信を許可せず、このプロパティで指定された期間中、スレッドのスリープ処理を繰り返します。デフォルト値は |
使用場所: ssl
説明
<trust-manager>
要素には、javax.net.ssl.TrustManager
インスタンスを初期化するための構成情報を記述します。
トラスト・マネージャは、信頼の決定を行う際に使用されるトラスト・マテリアルを管理し、ピアが提示した資格証明を受け入れるかどうかを決定します。
有効なtrust-manager構成には、少なくとも1つの子要素が記述されます。
使用場所: cluster-config
説明
ユニキャスト・リスナーの構成情報を指定します。この要素は、ポイントツーポイントのクラスタ通信のためにクラスタ・ノードでバインドするアドレスおよびポートを指定するために使用します。
マルチキャストフリーのクラスタリング
デフォルトでは、クラスタの形成時に他のノードを検出するためにマルチキャスト・プロトコルが使用されます。マルチキャスト・ネットワーキングが適さない場合、または環境内で使用できない場合には、well-known-addresses機能を使用するとマルチキャスト・トラフィックを使用する必要がなくなります。
要素
表A-91で、unicast-listener
要素のサブ要素を説明します。
表A-91 unicast-listenerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
ソケット・プロバイダの構成を指定するか、 <socket-provider>ssl</socket-provider> 事前構成済システム・プロパティのオーバーライド値は |
|
|
オプション |
信頼性の高いポイントツーポイント通信を実現するために使用されるトランスポート・プロトコルを指定します。デフォルトでは、すべてのサービスが構成されたプロトコルおよび共有トランスポート・インスタンスを使用します。また、サービスは
事前構成済システム・プロパティのオーバーライド値は |
オプション |
マルチキャスト・ブロードキャストを使用してクラスタ・メンバーを検出するかわりに、クラスタ検出プロトコルで使用されるWell Knownアドレスのリストを記述します。 |
|
< |
必須 |
ユニキャスト・ソケットがリスニングまたは公開を行うIPアドレスを指定します。アドレスはサブネットおよびマスクとしてCIDR注釈を使用して(たとえば 事前構成済システム・プロパティのオーバーライド値は |
< |
必須 |
ユニキャスト・ソケットがリスニングまたは公開を行うポートを指定します。第2ポートは自動的に開かれ、次のポートにデフォルト設定されます。有効な値は0から65535です。デフォルト値は 事前構成済システム・プロパティのオーバーライド値は |
< |
必須 |
指定したポートがすでに使用されているためにバインドできない場合に、ポートを自動的に増分するかどうかを指定します。または、 事前構成済システム・プロパティのオーバーライド値は |
必須 |
オペレーティング・システムがバッファリングを要求される受信パケットの量を指定します。この値はパケット数またはバイト数で表します。 |
|
< |
必須 |
ユニキャスト・リスナーの実行スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は |
使用場所: packet-speaker
説明
スピーカー・デーモンの起動に必要な送信パケットの最小量を指定します。
パフォーマンスへの影響
要素
表A-92で、packet-speaker
要素のサブ要素を説明します。
表A-92 packet-speakerのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
< |
必須 |
スピーカー・デーモンを起動するために送信の準備を整える必要のあるパケットの最小数を指定します。値を0に指定するとスピーカーが常に強制的に使用され、高い値を指定すると使用されなくなります。指定しない場合(デフォルト)は、 |
使用場所: unicast-listener
注意:
これは、セキュリティ関連の機能ではなく、クラスタに参加できるアドレスを制限するものではありません。クラスタ・メンバーシップの制限の詳細は、authorized-hosts要素を参照してください。
マルチキャストを使用する際のクラスタの構築に問題がある場合は、『Oracle Coherenceの管理』でマルチキャスト接続テストの実行方法を参照してください。
説明
デフォルトでは、クラスタの形成時に他のメンバーを検出するためにマルチキャスト・プロトコルが使用されます。マルチキャスト・ネットワーキングが適さない場合、または環境内で使用できない場合には、Well Knownアドレス(WKA)機能を使用すると、マルチキャスト・トラフィックを使用する必要がなくなります。使用中は、クラスタの開始が許可され、クラスタの存続期間を通して使用できる見込みのあるメンバーの比較的小さなリストでクラスタが構成されます。どの時点でも、すべてのWKAマシンを同時にアクティブにする必要はありませんが、他のメンバーがクラスタに参加するには、少なくとも1つのWKAマシンを実行している必要があります。
例
次の例では、参加メンバーがクラスタを検出または形成するのに使用する2つのWell Knownアドレスを構成します。
<cluster-config> <unicast-listener> <well-known-addresses> <address id="1">192.168.0.100</address> <address id="2">192.168.0.101</address> </well-known-addresses> </unicast-listener> </cluster-config>
要素
表A-93で、well-known-addresses
要素のサブ要素を説明します。
表A-93 well-known-addressesのサブ要素
要素 | 必須/ オプション | 説明 |
---|---|---|
オプション |
マルチキャスト・ブロードキャストを使用するかわりにクラスタ検出プロトコルで使用されるWKAのリストを指定します。また、すべてのクラスタ通信はユニキャストを使用して実行されます。空の場合または指定していない場合は、マルチキャスト通信が使用されます。 事前構成のシステム・プロパティのオーバーライド値は |
|
|
オプション |
マルチキャスト・ブロードキャストを使用するかわりに、クラスタ検出プロトコルで使用されるWKAマシン・アドレス(IPアドレスまたはDNS名)のリストを指定します。一意の値に設定されている 事前構成済システム・プロパティのオーバーライド値は |
オプション |
WKAマシン・リストを提供する |
表A-94で、オペレーション・デプロイメント・ディスクリプタで使用可能な属性を説明します。
表A-94 オペレーション・デプロイメント・ディスクリプタの属性
属性 | 必須/ オプション | 説明 |
---|---|---|
|
オプション |
この属性で参照されるオーバーライドXMLドキュメントは、存在しなくてもかまいません。ただし、存在する場合は、そのルート要素の名前が、オーバーライドする要素の名前と同じである必要があります。名前の同じ要素が複数ある場合(例、< 次の要素は、自身のXMLオーバーライド・ファイルでオーバーライドできます。
|
|
オプション |
|
|
オプション |
この属性は、任意の要素のシステム・プロパティ名を指定するために使用します。システム・プロパティは、Javaコマンド行から要素の値をオーバーライドする際に使用します。この機能により、すべてのクラスタ・ノードで同じオペレーション・ディスクリプタ(およびオーバーライド・ファイル)を使用し、システム・プロパティで各ノードをカスタマイズできます。この機能の詳細は、システム・プロパティのオーバーライドを参照してください。 |