D システム・プロパティのオーバーライド

システム・プロパティ・リファレンスでは、Coherenceのシステム・プロパティのオーバーライド機能について説明し、Coherenceのデフォルト設定を変更するために使用される多くの事前定義済システム・プロパティをリストしています。

この付録の内容は次のとおりです。

• システム・プロパティのオーバーライドの概要
  Coherenceオペレーション構成とCoherenceキャッシュ構成の両方のデプロイメント・ディスクリプタでは、ディスクリプタで定義されているすべての要素にシステム・プロパティを割り当てることができます。
• オーバーライドの例
  デフォルトのlocalhostの値をオーバーライドする例を検討することで、システム・プロパティのオーバーライド機能の使用方法を学習します。
• 事前構成されているオーバーライド値
  Coherenceのシステム・プロパティのオーバーライド・リファレンスには、事前構成済のシステム・プロパティおよびオーバーライドされた設定がすべてリストされます。

D.1 システム・プロパティのオーバーライドの概要

Coherenceオペレーション構成とCoherenceキャッシュ構成の両方のデプロイメント・ディスクリプタでは、ディスクリプタで定義されているすべての要素にシステム・プロパティを割り当てることができます。一部の要素には、事前定義されたオーバーライドがあります。オーバーライドは独自に作成することも、事前定義されたものを変更することもできます。

この機能は、単一のJVMの設定を変更する必要がある場合や、別のディスクリプタを使用しないで設定の異なる別のアプリケーションを起動できるようにする場合に役立ちます。最も一般的なアプリケーションでは、マルチキャストの別のアドレスを渡すことによって、別のアプリケーションで別のクラスタを作成できるようにします。

コマンド行設定オーバーライドを作成するには、system-property属性を追加して、オーバーライドを作成する要素にJavaコマンド行オプションの名前として割り当てる文字列を指定します。次に、Javaコマンド行で先頭を-Dとして指定します。

D.2 オーバーライドの例

デフォルトのlocalhostの値をオーバーライドする例を検討することで、システム・プロパティのオーバーライド機能の使用方法を学習します。この例では、インタフェースでデフォルトのlocalhostの値を使用しないように、マルチホーム・サーバーのIPアドレスを変更するために使用する、システム・プロパティのオーバーライドを構成しています。

まず、cluster-config要素、unicast-listener要素またはaddress要素にsystem-propertyを追加します。たとえば:

<address system-property="coherence.localhost">localhost</address>

ここでは、デフォルトのlocalhostのかわりに、システム・プロパティを使用してIPアドレスを指定します。

java -Dcoherence.localhost=192.168.0.301 -jar coherence.jar

D.3 事前構成されているオーバーライド値

Coherenceのシステム・プロパティのオーバーライド・リファレンスには、事前構成済のシステム・プロパティおよびオーバーライドされた設定がすべてリストされます。

表D-1 事前構成されているシステム・プロパティのオーバーライド値

システム・プロパティ	設定
coherence.cacheconfig	キャッシュ構成ディスクリプタのファイル名。configurable-cache-factory-configを参照してください。
coherence.cluster	クラスタ名。member-identityを参照してください。
coherence.clusteraddress	クラスタ(マルチキャスト)のIPアドレス。multicast-listenerの<address>サブ要素を参照してください。
coherence.clusterport	クラスタ(マルチキャスト)のIPポート。multicast-listenerの<port>サブ要素を参照してください。
coherence.distributed.backup	データ・バックアップ記憶域の場所。DistributedCacheサービスのパラメータのbackup-storage/typeサブ要素を参照してください。
coherence.distributed.backupcount	データ・バックアップの数。DistributedCacheサービスのパラメータのbackup-countサブ要素を参照してください。
coherence.distributed.localstorage	有効化されているローカル・パーティション管理。DistributedCacheサービスのパラメータのlocal-storageサブ要素を参照してください。
coherence.distributed.threads	スレッド・プールのサイズ。DistributedCacheサービスのパラメータのthread-countサブ要素を参照してください。
coherence.distributed.transfer	パーティション送信のしきい値。DistributedCacheサービスのパラメータのtransfer-thresholdサブ要素を参照してください。
coherence.edition	製品のエディション。license-configを参照してください。
coherence.invocation.threads	起動サービスのスレッド・プールのサイズ。起動サービスのパラメータのthread-countサブ要素を参照してください。
coherence.localhost	ユニキャストのIPアドレス。unicast-listenerの<address>サブ要素を参照してください。
coherence.localport	ユニキャストのIPポート。unicast-listenerの<port>サブ要素を参照してください。
coherence.localport.adjust	ユニキャストのIPポートの自動割当て。unicast-listenerの<port-auto-adjust>サブ要素を参照してください。
coherence.log	ロギング先。logging-configの<logging-config-destination>サブ要素を参照してください。
coherence.log.level	ロギング・レベル。logging-configの<logging-config-level>サブ要素を参照してください。
coherence.log.limit	ログ出力文字制限。logging-configの<logging-config-limit>サブ要素を参照してください。
coherence.machine	machine-name要素で定義されているコンピュータの名前。member-identityを参照してください。
coherence.management	JMX管理のモード。management-configを参照してください。
coherence.management.readonly	JMX管理の読取り専用フラグ。management-configを参照してください。
coherence.management.remote	リモートJMX管理の有効フラグ。management-configを参照してください。
coherence.member	メンバー名。member-identityを参照してください。
coherence.mode	操作モード。license-configを参照してください。
coherence.override	デプロイメント構成のオーバーライド・ファイル名。
coherence.priority	優先度。member-identityを参照してください。
coherence.process	プロセス名。member-identityを参照してください。
coherence.proxy.threads	Coherence*Extendサービスのスレッド・プールのサイズ。プロキシ・サービスのパラメータのthread-countサブ要素を参照してください。
coherence.rack	ラック名。member-identityを参照してください。
coherence.role	ロール名。member-identityを参照してください。
coherence.security	キャッシュ・アクセス・セキュリティの有効フラグ。security-configを参照してください。
coherence.security.keystore	セキュリティ・アクセス・コントローラのキーストア・ファイル名。security-configを参照してください。
coherence.security.permissions	セキュリティ・アクセス・コントローラの権限ファイル名。security-configを参照してください。
coherence.shutdownhook	シャットダウン・リスナー・アクション。shutdown-listenerを参照してください。
coherence.site	サイト名。member-identityを参照してください。
coherence.tcmp.enabled	TCMPの有効フラグ。packet-publisherの<packet-publisher-enabled>サブ要素を参照してください。
coherence.ttl	マルチキャスト・パケットの有効時間(TTL)。multicast-listenerの<mulitcast-listener-ttl>サブ要素を参照してください。
coherence.wka	既知のIPアドレス。well-known-addressesを参照してください。