付録 C
domain.xml のドット表記名属性
この付録では、Mbean とその属性を指定するために使用可能なドット表記名属性について説明します。domain.xml ファイル内のすべての要素は対応する MBean を持ちます。これらの名前は、「個々の名前をピリオドで区切る」という構文規則に従うため、「ドット表記名」と呼ばれます。
この付録では、次の項目について説明します。
トップレベル要素
domain.xml ファイル内のすべてのトップレベル要素で、次の条件が満たされている必要があります。
- サーバー、設定、クラスタ、またはノードエージェントの名前はそれぞれ一意である必要があります。
- サーバー、設定、クラスタ、またはノードエージェントに「domain」という名前を付けてはいけません。
- サーバーインスタンスに「agent」という名前を付けてもかまいません。
次の表に、トップレベル要素と対応するドット表記名プレフィックスを示します。
表 C-1 トップレベル要素
|
要素名
|
ドット表記名プレフィックス
|
|
applications
|
domain.applications
|
|
resources
|
domain.resources
|
|
configurations
|
domain.configs
|
|
servers
|
domain.servers
この要素に含まれるすべてのサーバーは、server-name としてアクセス可能です。ここで、server-name は、server サブ要素の name 属性の値です。
|
|
clusters
|
domain.clusters
この要素に含まれるすべてのクラスタは、cluster-name としてアクセス可能です。ここで、cluster-name は、cluster サブ要素の name 属性の値です。
|
|
node-agents
|
domain.note-agents
|
|
lb-configs
|
domain.lb-configs
|
|
system-property
|
domain.system-property
|
次の 2 つのレベルの別名が利用可能です。
- 1 つ目のレベルの別名を使えば、プレフィックス domain.servers または domain.clusters を使わずにサーバーインスタンスまたはクラスタの属性にアクセスできます。したがって、たとえば、「server1」という形式のドット表記名は、ドット表記名 domain.servers.server1 にマッピングされます (server1 は特定のサーバーインスタンスを表す)。
- 2 つ目のレベルの別名を使えば、特定のクラスタまたはスタンドアロンサーバーインスタンス (ターゲット) の設定、アプリケーション、およびリソースを参照できます。
次の表に、サーバー名またはクラスタ名で始まるドット表記名と、それらの別名であるドメイン配下のトップレベル名を示します。
表 C-2 ドメイン配下のドット表記名サーバー名
|
ドット表記名
|
別名
|
補足説明
|
|
target.applications.*
|
domain.applications.*
|
この別名の解決結果は、target のみによって参照されるアプリケーションになります。
|
|
target.resources.*
|
domain.resources.*
|
この別名の解決結果は、target によって参照されるすべての jdbc-connection-pool、connector-connection-pool、 resource-adapter-config、およびその他のすべてのリソースになります。
|
次の表に、サーバー名またはクラスタ名で始まるドット表記名と、それらの別名である、そのサーバーまたはクラスタによって参照されている設定内のトップレベル名を示します。
表 C-3 サーバーまたはクラスタによって参照されている設定のドット表記名
|
ドット表記名
|
別名
|
|
target.http-service
|
config-name.http-service
|
|
target.iiop-service
|
config-name.iiop-service
|
|
target.admin-service
|
config-name.admin-service
|
|
target.web-container
|
config-name.web-container
|
|
target.ejb-container
|
config-name.ejb-container
|
|
target.mdb-container
|
config-name.mdb-container
|
|
target.jms-service
|
config-name.jms-service
|
|
target.log-service
|
config-name.log-service
|
|
target.security-service
|
config-name.security-service
|
|
target.transaction-service
|
config-name.transaction-service
|
|
target.monitoring-service
|
config-name.monitoring-service
|
|
target.java-config
|
config-name.java-config
|
|
target.availability-service
|
config-name.availability-service
|
|
target.thread-pools
|
config-name.thread-pools
|
別名を使用しない要素
クラスタ化されたインスタンスでは、別名を使用すべきではありません。クラスタ化されたインスタンスの特定のシステムプロパティを取得する際のドット表記名属性は、domain.servers.clustered-instance-name.system-property のように記述すべきです。clustered-instance-name.system-property のように記述すべきではありません。
