この章の内容は次のとおりです。
COHERENCE_HOME
\lib\coherence.jar
ライブラリに用意されています。tangosol-coherence.xml
にはオペレーション設定とランタイム設定が用意されており、クラスタ、通信、およびデータ管理の各サービスの作成と構成に使用されます。coherence-cache-config.xml
は、クラスタ内で使用できる様々な種類のキャッシュを指定するために使用されます。pof-config.xml
は、POF (Portable Object Format)を使用したシリアライズでのカスタムのユーザー定義型の指定に使用されます。coherence.jar
にあるデフォルトのtangosol-coherence.xml
オペレーション・デプロイメント・ディスクリプタを編集することなく、オペレーション設定を変更できます。親トピック: はじめに
COHERENCE_HOME
\lib\coherence.jar
ライブラリに用意されています。これらのファイルおよび関連するスキーマについては、Coherenceのライブラリをディレクトリに解凍すれば簡単に確認できます。構成ファイルにはデフォルト値が設定されており、Coherenceを最小の変更ですぐに使用できます。これらのファイルは実例を示すことのみを目的としたものであり、再利用したり、特定のアプリケーションやソリューションで必要とされる変更を加えたりできます。ただし、構成ファイルを別に作成して、デフォルトの構成ファイルをオーバーライドすることをお薦めします。
デフォルトの構成ファイルの内容は、次のとおりです。
tangosol-coherence.xml
- このファイルにはオペレーション設定とランタイム設定が含まれており、クラスタ、通信、およびデータ管理の各サービスの作成と構成に使用されます。このファイルは一般にオペレーション・デプロイメント・ディスクリプタと呼ばれます。このファイルのスキーマは、coherence-operational-config.xsd
ファイルです。オペレーション構成の要素を参照してください。
tangosol-coherence-override-dev.xml
- Coherenceが開発者モードで起動されると、このファイルによってtangosol-coherence.xml
ファイルのオペレーション設定がオーバーライドされます。Coherenceはデフォルトで開発者モードで起動され、このファイルの設定が使用されます。このファイルの設定は開発環境に適しています。このオーバーライド・ファイルのスキーマ・ファイルとオペレーション・デプロイメント・ディスクリプタのスキーマは同一です。
tangosol-coherence-override-eval.xml
- Coherenceが評価モードで起動されると、このファイルによってtangosol-coherence.xml
ファイルのオペレーション設定がオーバーライドされます。このファイルの設定はCoherenceの評価に適しています。このオーバーライド・ファイルのスキーマ・ファイルとオペレーション・デプロイメント・ディスクリプタのスキーマは同一です。
tangosol-coherence-override-prod.xml
- Coherenceが本番モードで起動されると、このファイルによってtangosol-coherence.xml
ファイルのオペレーション設定がオーバーライドされます。このファイルの設定は本番環境に適しています。このオーバーライド・ファイルのスキーマ・ファイルとオペレーション・デプロイメント・ディスクリプタのスキーマは同一です。
coherence-cache-config.xml
- このファイルを使用して、クラスタ内で使用できる様々な種類のキャッシュを指定します。このファイルは一般にキャッシュ構成デプロイメント・ディスクリプタと呼ばれます。このファイルのスキーマは、coherence-cache-config.xsd
ファイルです。キャッシュ構成の要素を参照してください。
coherence-pof-config.xml
- このファイルは、POF (Portable Object Format)を使用してオブジェクトをシリアライズするときにカスタムのデータ型を指定するために使用します。このファイルは一般にPOF構成デプロイメント・ディスクリプタと呼ばれます。このファイルのスキーマは、coherence-pof-config.xsd
ファイルです。POFユーザー定義型の構成要素を参照してください。
管理構成ファイル - Coherence管理レポートを構成するために使用される一連のファイルです。これらのファイルは、coherence.jar
の中の/reports
ディレクトリ内にあります。これらのファイルには、任意の数のレポート定義ファイルを参照するレポート・グループ構成ファイル(デフォルトではreport-group.xml
)が含まれます。各レポート定義ファイルにより、特定メトリックのセットに基づいて管理情報を表示するレポート・ファイルが作成されます。これらのファイルのスキーマは、それぞれcoherence-report-config.xsd
ファイルおよびcoherence-report-group-config.xsd
ファイルです。Oracle Coherenceの管理のレポート・ファイル構成要素およびレポート・グループ構成要素を参照してください。
親トピック: 構成の理解
tangosol-coherence.xml
にはオペレーション設定とランタイム設定が用意されており、クラスタ、通信、およびデータ管理の各サービスの作成と構成に使用されます。Coherenceは、実行時に、クラスパスで最初に見つかったtangosol-coherence.xml
ファイルを使用します。Coherenceで提供されるデフォルトのオペレーション・デプロイメント・ディスクリプタはcoherence.jar
ライブラリのルートにあります。このファイルは必要に応じて変更できます。ただし、オペレーション・ランタイム構成時には、このファイルをオーバーライドすることをお薦めします。XMLオーバーライド機能の理解を参照してください。
Coherenceクラスタの使用も参照してください。
この項には次のトピックが含まれます:
親トピック: 構成の理解
デフォルトのtangosol-coherence.xml
ファイルの要素は、実行時のクラスパスにtangosol-coherence-override.xml
という名前のオペレーション・オーバーライド・ファイルを置くことによりオーバーライドされます。オーバーライド・ファイルの構造は、すべての要素がオプションであることを除き、オペレーション・デプロイメント・ディスクリプタと同一です。オーバーライド・ファイルには変更される要素のみが含まれます。欠落している要素は、tangosol-coherence.xml
ファイルからロードされます。
一般的に、オペレーション・オーバーライド・ファイルは、オペレーション・ランタイムを構成するための最も包括的な方法を提供し、開発環境と本番環境の両方で使用されます。
デフォルトのオペレーション・オーバーライド・ファイルを使用するには:
親トピック: オペレーション構成ファイルの指定
coherence.override
システム・プロパティでは、デフォルトのtangosol-coherence-override.xml
ファイルのかわりに使用されるオペレーション・オーバーライド・ファイルを指定します。指定するファイルの構造は、すべての要素がオプションであることを除き、オペレーション・デプロイメント・ディスクリプタと同一です。欠落している要素は、tangosol-coherence.xml
ファイルからロードされます。
coherence.override
システム・プロパティを使用すると、異なるオペレーション構成間での切り替えを簡単に行えるため、開発およびテストの際に便利です。
オペレーション・オーバーライド・ファイルを指定するには:
親トピック: オペレーション構成ファイルの指定
オーバーライド・ファイルを作成すると、特定のオペレーション要素の内容をオーバーライドできます。オーバーライド・ファイルは、ルート要素とオーバーライドされる要素が一致している必要があることを除き、オペレーション・デプロイメント・ディスクリプタと同一構造です。カスタムのオーバーライド・ファイルの定義を参照してください。
一般的に、特定のオペレーション要素のためのオーバーライド・ファイルを使用すると、オペレーション・デプロイメント・ディスクリプタの修正可能な箇所を詳細に制御して、デプロイメント・シナリオごとに異なる構成を作成できます。
特定のオペレーション要素のためのオーバーライド・ファイルを定義するには:
親トピック: オペレーション構成ファイルの指定
Coherenceノードの出力に、起動時にロードされるオペレーション構成ファイルの場所と名前が示されます。オペレーション構成メッセージは、プロセスを起動するときに発行される最初のメッセージです。この出力は、複数のオーバーライド・ファイルを使用するときに特に有用ですが、Coherenceのアプリケーションやソリューションを開発およびテストするときにも役立ちます。
次の出力例は、発行される典型的なメッセージを示しています。
Loaded operational configuration from resource "jar:file:/D:/coherence/lib/ coherence.jar!/tangosol-coherence.xml" Loaded operational overrides from resource "jar:file:/D:/coherence/lib/ coherence.jar!/tangosol-coherence-override-dev.xml" Loaded operational overrides from resource "file:/D:/coherence/ tangosol-coherence-override.xml" Optional configuration override "/cluster-config.xml" is not specified Optional configuration override "/custom-mbeans.xml" is not specified
前述の出力は、coherence.jar
に含まれるオペレーション・デプロイメント・ディスクリプタがロードされたこと、およびこのファイルの設定が2つのロードされたオーバーライド・ファイルtangosol-coherence-override-dev.xml
およびtangosol-coherence-override.xml
によってオーバーライドされることを示しています。また、2つのオーバーライド・ファイルは、特定のオペレーション要素のために定義されましたが、実行時には見つかることもロードされることもありませんでした。
親トピック: オペレーション構成ファイルの指定
coherence-cache-config.xml
は、クラスタ内で使用できる様々な種類のキャッシュを指定するために使用されます。coherence-cache-config.xml
ファイルが使用されます。Coherenceでは、サンプルのcoherence-cache-config.xml
ファイルが提供されており、coherence.jar
ライブラリのルートに配置されています。このサンプル・ファイルは、デモ用のものです。サンプル・ファイルは必要に応じて変更または再利用できますが、サンプル・ファイルを使用するかわりにカスタムのキャッシュ構成デプロイメント・ディスクリプタを作成することをお薦めします。ノート:
クラスタ内のすべてのキャッシュ・サーバー・ノードで同一のキャッシュ構成ディスクリプタを使用することをお薦めします(必須ではありません)。
Coherenceでは、キャッシュ構成デプロイメント・ディスクリプタを起動させる必要があります。実行時にキャッシュ構成デプロイメント・ディスクリプタが起動していないと、構成リソースのロードに失敗したことを伝えるエラー・メッセージが表示され、見つからなかったファイルの名前と場所も示されます。
キャッシュの使用も参照してください。
この項には次のトピックが含まれます:
親トピック: 構成の理解
Coherenceは、初期状態では、クラスパスで最初に見つかったcoherence-cache-config.xml
ファイルを使用するように構成されています。coherence-cache-config.xml
ファイルを使用するには、このファイルが、クラスパスの、coherence.jar
ライブラリよりも上位にある必要があります。そうでない場合は、coherence.jar
にあるサンプルのcoherence-cache-config.xml
ファイルが使用されます。
デフォルトのキャッシュ構成ファイルを使用するには:
親トピック: キャッシュ構成ファイルの指定
キャッシュ構成デプロイメント・ディスクリプタのデフォルトの名前と場所は、<configurable-cache-factory-config>
要素のオペレーション・デプロイメント・ディスクリプタに指定されています。この要素をオーバーライドして、デフォルトのキャッシュ構成ファイルとは異なる名前と場所が使用されるように指定できます。
デフォルトのキャッシュ構成ファイルをオーバーライドするには:
親トピック: キャッシュ構成ファイルの指定
coherence.cacheconfig
システム・プロパティを使用して、構成されたデフォルトのキャッシュ構成デプロイメント・ディスクリプタのかわりに使用するカスタムのキャッシュ構成デプロイメント・ディスクリプタを指定します。システム・プロパティを使用すると、異なる構成間での切替えを簡単に行えるため、開発およびテストの際に便利です。
カスタムのキャッシュ構成ファイルを指定するには、coherence.cacheconfig
システム・プロパティの値としてファイルの名前を入力します。これは、通常、Coherenceノードの起動時にJavaオプション-D
を使用して指定されます。クラスパスにファイルがない場合は、ファイルのフルパス(または相対パス)と名前を入力します。このシステム・プロパティでキャッシュ構成ファイルの場所を指定するときには、URLを使用することもできます。
次の例では、キャッシュ・サーバーを起動し、COHERENCE_HOME
にあるキャッシュ構成デプロイメント・ディスクリプタMyConfig.xml
を指定します。
java -Dcoherence.cacheconfig=MyConfig.xml -cp COHERENCE_HOME;COHERENCE_HOME\lib\coherence.jar com.tangosol.net.DefaultCacheServer
親トピック: キャッシュ構成ファイルの指定
Coherenceノードの出力に、起動時にロードされるキャッシュ構成デプロイメント・ディスクリプタの場所と名前が示されます。構成メッセージはCoherenceの著作権情報の後に最初に表示されるメッセージです。Coherenceのアプリケーションやソリューションを開発およびテストするときには、この出力が特に役立ちます。
次の出力例は、キャッシュ構成デプロイメント・ディスクリプタMyconfig.xml
がロードされたことを示すキャッシュ構成メッセージを示しています。
Loaded cache configuration from resource "file:/D:/coherence/Myconfig.xml"
親トピック: キャッシュ構成ファイルの指定
pof-config.xml
は、POF (Portable Object Format)を使用したシリアライズでのカスタム・ユーザー型の指定に使用されます。pof-config.xml
ファイルを使用します。ノート:
クラスタ内のすべてのノードで同一のPOF構成デプロイメント・ディスクリプタを使用することをお薦めします。
POFシリアライザがキャッシュ・スキームの一部として構成されている場合や、すべてのキャッシュ・スキームに対してグローバルに構成されている場合にかぎり、POF構成デプロイメント・ディスクリプタがロードされます。
Portable Object Formatの使用も参照してください。
この項には次のトピックが含まれます:
デフォルトのpof-config.xml
POF構成ファイルは、coherence.jar
ライブラリのルートにあります。Coherenceは、初期状態では、クラスパスで最初に見つかったpof-config.xml
ファイルを使用するように構成されています。別のpof-config.xml
ファイルを使用するには、このファイルが、クラスパスの、coherence.jar
ライブラリよりも上位にある必要があります。そうでない場合は、coherence.jar
ライブラリにあるデフォルトのpof-config.xml
ファイルが使用されます。
POF構成ファイルは、個別のアプリケーションにあわせてカスタマイズする必要があります。デフォルトのPOF構成ファイルは、coherence-pof-config.xml
ファイルを参照してください。これには、Coherence固有のユーザー型が定義されており、POF構成ファイルを作成するときには常に必要となります。
デフォルトのPOF構成ファイルをオーバーライドするには:
親トピック: POF構成ファイルの指定
coherence.pof.config
システム・プロパティを使用して、デフォルトのpof-config.xml
ファイルのかわりに使用するカスタムのPOF構成デプロイメント・ディスクリプタを指定します。システム・プロパティを使用すると、異なる構成間での切替えを簡単に行えるため、開発およびテストの際に便利です。
カスタムのPOF構成ファイルを指定するには:
親トピック: POF構成ファイルの指定
<include>
要素は、POF構成デプロイメント・ディスクリプタ内で、定義済のユーザー型を別のPOF構成デプロイメント・ディスクリプタ内に含めるために使用されます。これにより、ユーザー型をわかりやすく編成できるようになります(アプリケーション別や開発グループ別など)。
ノート:
複数のPOF構成ファイルを組み合せる場合は、定義済の各ユーザー型が一意の<type-id>
を持つ必要があります。型IDが含まれていない場合には、コンポジット構成ファイル内でのそのユーザー型の出現順序に基づいて型IDが指定されます。
複数のPOF構成ファイルを組み合せるには:
親トピック: POF構成ファイルの指定
Coherenceノードの出力に、起動時にロードされるPOF構成デプロイメント・ディスクリプタの場所と名前が示されます。構成メッセージは、Coherenceの著作権情報の後に表示されるメッセージの一部であり、POFを使用するように構成されたキャッシュ・サービスと関連付けられています。Coherenceのアプリケーションやソリューションを開発およびテストするときには、この出力が特に役立ちます。
次の出力例は、4つのPOF構成デプロイメント・ディスクリプタがロードされたことを示すPOF構成メッセージです。
Loading POF configuration from resource "file:/D:/coherence/my-pof-config.xml" Loading POF configuration from resource "file:/D:/coherence/coherence-pof-config.xml" Loading POF configuration from resource "file:/D:/coherence/hr-pof-config.xml" Loading POF configuration from resource "file:/D:/coherence/crm-pof-config.xml"
親トピック: POF構成ファイルの指定
デフォルトの管理構成ファイルの内容は、次のとおりです。
レポート・グループ構成ファイル - レポート・グループ構成ファイルは、レポート定義ファイルの名前と場所、およびレポートが書き込まれる出力ディレクトリのリストを示すために使用されます。このファイルの名前と場所は、オペレーション・デプロイメント・ディスクリプタに定義されます。デフォルトでは、report-group.xml
ファイルが使用され、このファイルはcoherence.jar
の/reports
ディレクトリに存在します。必要に応じて、追加のレポート・グループ構成ファイルを指定して、カスタム・レポート・グループ・ファイルを作成することもできます。
レポート構成ファイル - レポート構成ファイルでは、レポートを定義し、特定メトリックのセットに基づいて管理情報を表示するレポート・ファイルが作成されます。レポート構成ファイルは、実行時に使用されるレポート・グループ構成ファイルで参照される必要があります。デフォルトのレポート構成ファイルはcoherence.jar
の/reports
ディレクトリにあり、デフォルトのレポート・グループ構成ファイルによって参照されます。カスタムのレポート構成ファイルも必要に応じて作成できます。
custom-mbeans.xml
- デフォルトのMBean構成オーバーライド・ファイルです。このファイルを使用してCoherenceのJMX管理およびモニタリング・フレームワーク内でカスタムMBean(アプリケーション・レベルのMBean)を定義します。これにより、クラスタ内のどのノードからでも任意のアプリケーション・レベルのMBeanを管理およびモニターできます。カスタムMBeanはオペレーション・オーバーライド・ファイル内に定義できます。ただし、一般的にはカスタムMBeanではなくMBean構成オーバーライド・ファイルが使用されます。
Oracle Coherence管理の概要も参照してください。
この項には次のトピックが含まれます:
デフォルトのレポート・グループ構成ファイルの名前と場所は、<management-config>
ノード内のオペレーション構成デプロイメント・ディスクリプタに指定されています。カスタムのレポート・グループ構成ファイルは、オペレーション・オーバーライド・ファイルまたはシステム・プロパティを使用して指定できます。
ノート:
レポート・グループ構成ファイルは、JMX管理が有効な場合にかぎりロードされます。次の例では、MBeanサーバーをホストするノード上でJMX管理を有効にします。
この項には次のトピックが含まれます:
カスタムのレポート・グループ構成ファイルの名前と場所は、オペレーション・オーバーライド・ファイルを使用して指定できます。このメカニズムによって、レポート・グループ構成ファイルのデフォルトの名前と場所がオーバーライドされます。
デフォルトのレポート・グループ構成ファイルをオーバーライドするには:
親トピック: カスタムのレポート・グループ構成ファイルの指定
coherence.management.report.configuration
システム・プロパティを使用して、デフォルトのreport-group.xml
ファイルのかわりに使用するカスタムのレポート・グループ構成ファイルを指定します。システム・プロパティを使用すると、異なる構成間での切替えを簡単に行えるため、開発およびテストの際に便利です。
カスタムのレポート・グループ構成ファイルを指定するには、システム・プロパティcoherence.management.report.configuration
の値としてファイルの名前を入力します。これは、通常、Coherenceノードの起動時にJavaオプション-D
を使用して指定されます。クラスパスにファイルがない場合は、ファイルのフルパス(または相対パス)と名前を入力します。このシステム・プロパティでレポート・グループ構成ファイルの場所を指定するときには、URLを使用することもできます。
次の例では、キャッシュ・サーバーを起動し、JMX管理を有効にして、COHERENCE_HOME
にあるレポート・グループ構成ファイルmy-group.xml
を指定します。
java -Dcoherence.management=all -Dcoherence.management.report.configuration=my-group.xml -cp COHERENCE_HOME;COHERENCE_HOME\lib\coherence.jar com.tangosol.net.DefaultCacheServer
親トピック: カスタムのレポート・グループ構成ファイルの指定
オペレーション・デプロイメント・ディスクリプタtangosol-coherence.xml
は、オペレーション・オーバーライド・ファイルcustom-mbeans.xml
を定義するため(特に、カスタムのMBeansを定義するため)に使用されます。オーバーライド・ファイルの名前と場所は、MBean構成ファイルのシステム・プロパティを使用して指定することもできます。
この項には次のトピックが含まれます:
カスタムMBeansは、オーバーライド・ファイルcustom-mbeans.xml
内に定義されます。Coherenceは、実行時に、クラスパスで最初に見つかったcustom-mbeans.xml
ファイルが使用されます。
デフォルトのMBean構成オーバーライド・ファイルを使用するには:
親トピック: MBean構成ファイルの指定
coherence.mbeans
システム・プロパティでは、デフォルトのオーバーライド・ファイルcustom-mbeans.xml
のかわりに使用されるMBean構成オーバーライド・ファイルを指定します。システム・プロパティを使用すると、異なるMBean構成間での切替えを簡単に行えるため、開発およびテストの際に便利です。
MBean構成オーバーライド・ファイルを指定するには、coherence.mbeans
システム・プロパティの値としてファイルの名前を入力します。これは、通常、Coherenceノードの起動時にJavaオプション-D
を使用して指定されます。クラスパスにファイルがない場合は、ファイルのフルパス(または相対パス)と名前を入力します。このシステム・プロパティでMBean構成オーバーライド・ファイルの場所を指定するときには、URLを使用することもできます。
次の例では、キャッシュ・サーバーを起動し、COHERENCE_HOME
にあるMBean構成オーバーライド・ファイルmy-mbeans.xml
を指定します。
java -Dcoherence.mbeans=my-mbeans.xml -cp COHERENCE_HOME;COHERENCE_HOME\lib\coherence.jar com.tangosol.net.DefaultCacheServer
親トピック: MBean構成ファイルの指定
Coherenceノードの出力に、起動時にロードされるレポート・グループ構成ファイルおよびMBean構成ファイルの場所と名前が示されます。Coherenceのアプリケーションやソリューションを開発およびテストするときには、この出力が特に役立ちます。
レポート・グループ構成ファイル
レポート・グループ構成メッセージは、Coherenceの著作権情報の後に表示されるメッセージの一部です。
次の出力例は、my-group.xml
ファイルがロードされたことを示すレポート・グループ構成メッセージを示しています。
Loaded Reporter configuration from "file:/D:/coherence/my-group.xml
MBean構成オーバーライド・ファイル
MBean構成メッセージは、他のオペレーション・オーバーライド・メッセージとともに表示されるものであり、プロセスの起動時に最初に表示されるメッセージの一部です。この出力は、オーバーライド・ファイルを使用するときには特に有用ですが、Coherenceのアプリケーションやソリューションを開発およびテストするときにも役立ちます。
次の出力例は、デフォルトのMBean構成オーバーライド・ファイルがロードされたことを示すオペレーション・オーバーライド・メッセージを示しています。
Loaded operational overrides from resource "file:/D:/coherence/custom-mbeans.xml"
親トピック: 管理構成ファイルの指定
スキーマ検証は、必要に応じて無効化できます。スキーマ検証を無効化するには、構成ファイルからxsi:schemaLocation
属性を削除します。次の例では、スキーマ参照を含まず、ロード時に検証されないtangosol-coherence-override.xml
ファイルを作成します。
<?xml version='1.0'?> <coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"> ... </coherence>
ノート:
スキーマ検証を無効にすると、XMLが不正な場合にCoherenceは失敗します。構文エラーは無視されるため、すぐに判明しない場合があります。
親トピック: 構成の理解
coherence.jar
にあるデフォルトのtangosol-coherence.xml
オペレーション・デプロイメント・ディスクリプタを編集することなく、オペレーション設定を変更できます。Coherenceのオペレーション・ランタイムを構成するには、この方法をお薦めします。XMLオーバーライド機能は、特定のオペレーションXML要素を持つXMLドキュメント(通称、オーバーライド・ファイル)を関連付けることによって有効になります。XML要素とそのいずれのサブ要素も、後から必要に応じてオーバーライド・ファイル内で修正されます。実行時に、Coherenceによりオーバーライド・ファイルがロードされ、その要素によってtangosol-coherence.xml
ファイル内の要素が置換または追加されます。
オーバーライド・ファイルは実行時に存在している必要はありません。ただし、オーバーライド・ファイルが存在する場合は、そのファイルのルート要素とファイルによりオーバーライドされる要素が一致している必要があります。また、サブ要素はオプションです。サブ要素は、オーバーライド・ファイルに定義されていない場合、tangosol-coherence.xml
ファイルからロードされます。通常、変更または追加されるサブ要素のみがオーバーライド・ファイルに追加されます。
この項には次のトピックが含まれます:
複数のオーバーライド・ファイルが事前定義されており、オペレーション・デプロイメント・ディスクリプタ内の要素をオーバーライドできます。これらのファイルは手動で作成され、クラスパスに保存されます。
tangosol-coherence-override.xml
- このオーバーライド・ファイルは<coherence>
ルート要素用に定義され、オペレーション・デプロイメント・ディスクリプタ内の任意の要素をオーバーライドするために使用されます。このファイルのルート要素は<coherence>
要素である必要があります。
custom-mbeans.xml
- このオーバーライド・ファイルは<mbeans>
要素用に定義され、オペレーション・デプロイメント・ディスクリプタにカスタムのMBeanを追加するために使用されます。このファイルのルート要素は<mbeans>
要素である必要があります。
cache-factory-config.xml
- このオーバーライド・ファイルは<configurable-cache-factory-config>
要素に定義されており、構成キャッシュ・ファクトリをカスタマイズするために使用されます。このオーバーライド・ファイルは通常コンテナの統合をサポートするためにのみ使用されます。一般的に、<configurable-cache-factory-config>
要素をオーバーライドすることはありません。
cache-factory-builder-config.xml
- このオーバーライド・ファイルは<cache-factory-builder-config>
要素に対して定義されており、キャッシュ・ファクトリ・ビルダーをカスタマイズするために使用されます。このオーバーライド・ファイルは通常コンテナの統合をサポートするためにのみ使用されます。一般的に、<cache-factory-builder-config>
要素をオーバーライドすることはありません。
次の例では、tangosol-coherence-override.xml
ファイルを使用してデフォルトのクラスタ名をオーバーライドします。その他のオペレーション設定はすべてtangosol-coherence.xml
ファイルからロードされます。
<?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"> <cluster-config> <member-identity> <cluster-name system-property="coherence.cluster">MyCluster </cluster-name> </member-identity> </cluster-config> </coherence>
次の例では、tangosol-coherence-override.xml
ファイルを使用して、このノード上の分散キャッシュ・サービスのローカル・ストレージを無効にします。複数出現する要素を区別するためにid
属性が使用されます。id
属性は、オーバーライドされる要素のid
属性と一致している必要があります。
<?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"> <cluster-config> <services> <service id="3"> <init-params> <init-param id="4"> <param-name>local-storage</param-name> <param-value system-property="coherence.distributed. localstorage">false</param-value> </init-param> </init-params> </service> </services> </cluster-config> </coherence>
次の例では、custom-mbean.xml
ファイルを使用して標準のMBean定義をMBeanのリストに追加します。
<mbeans 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"> <mbean id="100"> <mbean-class>com.oracle.customMBeans.Query</mbean-class> <mbean-name>type=Query</mbean-name> <enabled>true</enabled> </mbean> </mbeans>
親トピック: XMLオーバーライド機能の理解
tangosol-coherence.xml
デプロイメント・ディスクリプタ内の要素はすべて、事前定義されたtangosol-coherence-override.xml
ファイルを使用してオーバーライドできます。ただし、より詳細な構成の管理が必要な場合があります。たとえば、ソリューションでオペレーション・デプロイメント・ディスクリプタの特定の要素のみを変更できるようにして、全体を変更することはできないようにする必要がある場合があります。また別の例として、様々なユースケースに基づいた様々な構成が必要となるソリューションもあります。そうした状況に対応するには、カスタムのオーバーライド・ファイルを使用します。
xml-overrideおよびid属性の使用
オーバーライド・ファイルはxml-override
属性とid属性(必要な場合)を使用して定義されます。これらの属性はいずれもオプションで指定されるものであり、オーバーライドされるオペレーション要素に追加されます。オペレーション構成属性リファレンスを参照してください。
xml-override
属性の値は、ClassLoader.getResourceAsStream(String name)
メソッドを使用してcoherence.jar
ライブラリに含まれるクラスにアクセス可能なドキュメントの名前です。一般的には、ファイルの名前には/
という接頭辞が付いており、ファイルは実行時のクラスパスにあります。属性でオーバーライド・ファイルの場所を指定するときには、URLを使用することもできます。
たとえば、<cluster-config>
要素をオーバーライドするために使用されるオーバーライド・ファイルcluster-config.xml
を定義するには、次のようにtangosol-coherence-override.xml
ファイル内の<cluster-config>
要素にxml-override
属性を追加します。
<?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"> <cluster-config xml-override="/cluster-config.xml"> ... </cluster-config> </coherence>
このオーバーライド・ファイルを使用するには、cluster-config.xml
という名のドキュメントを作成し、そのドキュメントとベース・ドキュメント(この場合はtangosol-coherence-override.xml
)が実行時のクラスパス内のディレクトリにあることを確認します。この例の場合、次に示すように、オーバーライド・ファイルのルート要素は<cluster-config>
である必要があります。
<?xml version='1.0'?> <cluster-config 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"> <multicast-listener> <join-timeout-milliseconds>4000</join-timeout-milliseconds> </multicast-listener> </cluster-config>
id
属性は、複数回出現する要素を識別するために使用します。
たとえば、分散キャッシュ・サービスの<service>
要素をオーバーライドするために使用されるカスタムのオーバーライド・ファイルdist-service-config.xml
を定義するには、次のようにid
が3
の<service>
要素にxml-override
属性を追加します。
<?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"> <cluster-config> <services> <service id="3" xml-override="/dist-service-config.xml"> </service> </services> </cluster-config> </coherence>
このオーバーライド・ファイルを使用するには、dist-service-config.xml
という名前のドキュメントを作成し、そのドキュメントが実行時のクラスパス内のディレクトリにあることを確認します。この例の場合、次に示すように、オーバーライド・ファイルのルート要素は<service>
である必要があります。
<?xml version='1.0'?> <service id="3" 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"> <init-params> <init-param id="1"> <param-name>standard-lease-milliseconds</param-name> <param-value>2</param-value> </init-param> </init-params> </service>
ノート:
オーバーライド・ドキュメント内の要素のid
に一致する要素がベース・ドキュメントにないと、その要素はベース・ドキュメントに追加されます。
親トピック: XMLオーバーライド機能の理解
同一要素に対して複数のオーバーライド・ファイルを定義して、オペレーション・オーバーライド・ファイルを連鎖化できます。これによりステージングや本番などの様々なデプロイメント・シナリオに応じたオペレーション構成が可能になります。
たとえば、coherence.jar
にあるオペレーション・デプロイメント・ディスクリプタtangosol-coherence.xml
では、次のように<coherence>
要素のためのオペレーション・オーバーライド・ファイルを定義します。
<?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" xml-override="{coherence.override/tangosol-coherence-override-{mode} .xml}"> ... </coherence>
モード固有のオーバーライド・ファイルもcoherence.jar
にあり、Coherence起動モード(<license-mode>
要素の値)に基づいて使用されます。モード固有の各オペレーション・オーバーライド・ファイルは、次のようにデフォルトのオペレーション・オーバーライド・ファイルを定義します。
<?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" xml-override="/tangosol-coherence-override.xml"> ... </coherence>
tangosol-coherence-override.xml
ファイルの<coherence>
要素に対して4つのオーバーライド・ファイルを定義できます。たとえば:
<?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" xml-override="/tangosol-coherence-override-staging.xml"> ... </coherence>
必要に応じて連鎖を継続できます。これらのファイルはすべて、クラスパス内のディレクトリに置かれていれば実行時にロードされます。連鎖内の上位にあるファイルが常に下位のファイルをオーバーライドします。
親トピック: XMLオーバーライド機能の理解
-D
オプションを使用してJavaコマンド行で指定されます。これによりクラスタ内のすべてのノードで同一のオペレーション構成ファイルおよびキャッシュ構成ファイルを使用しながらノードごとに構成をカスタマイズできるようになります。システム・プロパティを使用すると、開発中の設定を簡単かつ迅速に変更することもできます。この項には次のトピックが含まれます:
Coherenceでは、様々なオペレーション設定およびキャッシュ設定をオーバーライドするために使用される多数のシステム・プロパティが事前構成されています。表D-1に事前構成されたすべてのシステム・プロパティを示してあります。事前構成されたシステム・プロパティは、デフォルトのデプロイメント・ディスクリプタtangosol-coherence.xml
およびcoherence-cache-config.xml
にそれぞれsystem-property
属性を使用して定義されています。
たとえば、事前構成されたcoherence.log.level
システム・プロパティは、次のようにtangosol-coherence.xml
ファイル内に定義されています。
<logging-config>
...
<severity-level system-property="coherence.log.level">5
</severity-level>
...
</logging-config>
事前構成されたシステム・プロパティを使用するには、起動時にJavaの -D
オプションを使用してシステム・プロパティを追加します。前述の例では、キャッシュ・サーバーの起動時に次のようにログ・レベル・システム・プロパティが指定されます。
java -Dcoherence.log.level=3 -cp COHERENCE_HOME\lib\coherence.jar com.tangosol.net.DefaultCacheServer
ノート:
オペレーション・オーバーライド・ファイルを使用する場合、およびカスタム・キャッシュ構成ファイルを作成する場合、事前構成されたシステム・プロパティは常にオーバーライドされる要素とともに配置する必要があります。そうしないと、そのプロパティは使用できなくなります。
親トピック: システム・プロパティを使用した構成の変更
任意のオペレーション構成要素またはキャッシュ構成要素に対してカスタムのシステム・プロパティを作成できます。事前構成されたシステム・プロパティの名前は必要に応じて変更することもできます。
システム・プロパティは、オーバーライドする要素にsystem-property
属性を追加することによって定義されます。system-property
属性の値には任意のユーザー定義名を使用できます。カスタムのシステム・プロパティは通常、オペレーション・オーバーライド・ファイル(tangosol-coherence-override.xml
など)およびカスタムのキャッシュ構成ファイルに定義されます。
オペレーション要素に対するシステム・プロパティの定義
次の例では、オペレーション要素<join-timeout-milliseconds>
に対してシステム・プロパティmulticast.join.timeout
を定義し、オペレーション・オーバーライド・ファイルに追加します。
<?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"> <cluster-config> <multicast-listener> <join-timeout-milliseconds system-property="multicast.join.timeout">30000 </join-timeout-milliseconds> </multicast-listener> </cluster-config> </coherence>
キャッシュ構成要素に対するシステム・プロパティの定義
次の例では、<cache-name>
要素に対してシステム・プロパティcache.name
を定義し、カスタムのキャッシュ構成ファイルに追加します。
<?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"> <caching-scheme-mapping> <cache-mapping> <cache-name system-property="cache.name"></cache-name> ...
事前定義されたシステム・プロパティの変更
次の例では、オペレーション要素<cluster-name>
の事前定義されたシステム・プロパティ名を変更し、オペレーション・オーバーライド・ファイルに追加します。
<?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"> <cluster-config> <member-identity> <cluster-name system-property="myapp.cluster.name"></cluster-name> </member-identity> </cluster-config> </coherence>
ノート:
システム・プロパティを削除するには、要素からシステム・プロパティ属性を削除します。実行時にシステム・プロパティを使用するときにそれが存在しないと、無視されます。
親トピック: システム・プロパティを使用した構成の変更