Sun GlassFish Enterprise Server v2.1.1 Administration Guide

Appendix B Dotted Name Attributes for domain.xml

This appendix describes the dotted name attributes that can be used to address the MBean and its attributes. Every element in the domain.xml file has a corresponding MBean. Because the syntax for using these names involves separating names between periods, these names are called dotted names.

This appendix contains the following topics:

Top Level Elements

The following conditions must be adhered to for all top level elements in the domain.xml file:

The following table identifies the top level elements and the corresponding dotted name prefix.

Element Name  

Dotted Name Prefix  

applications 

domain.applications

resources 

domain.resources

configurations 

domain.configs

servers 

domain.servers

Every server contained in this element is accessible as server-name. Where server-name is the value of the name attribute for the server subelement.

clusters 

domain.clusters

Every cluster contained in this element is accessible as cluster-name. Where cluster-name is the value of the name attribute for the cluster subelement.

node-agents 

domain.node-agents

lb-configs 

domain.lb-configs

Applicable only for Sun GlassFish Enterprise Server 

system-property 

domain.system-property

converged-lb-configs 

domain.converged-lb-configs

Applicable only for Sun GlassFish Communications Server 

Two levels of aliasing are available:

  1. The first level of alias allows access to attributes of server instances or clusters without going through the domain.servers or domain.clusters prefix. So, for example, a dotted name of the form server1 maps to the dotted name domain.servers.server1 (where server1 is a server instance).

  2. The second level of alias is used to refer to configurations, applications, and resources of a cluster or a standalone server instance (target).

The following table identifies dotted names beginning with the server name, or cluster name, that are aliased to top level names under the domain:

Dotted Name  

Aliased to  

Comments  

target.applications.*

domain.applications.*

The alias resolves to applications referenced by the target only.

target.resources.*

domain.resources.*

The alias resolves to all jdbc-connection-pool, connector-connection-pool, resource-adapter-config, and all other resources referenced by the target.

The following table identifies some of the dotted names beginning with the server name, or cluster name, that are aliased to top level names within the configuration referenced by the server or cluster. For a complete list, use the asadmin list target.* command.

Dotted Name  

Aliased to  

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.sip-container

config-name.sip-container

Applicable only for Sun GlassFish Communications Server 

target.ejb-container

config-name.ejb-container

target.mdb-container

config-name.mdb-container

target.jms-service

config-name.jms-service

target.sip-service

config-name.sip-service

Applicable only for Sun GlassFish Communications Server 

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

Elements Not Aliased

A clustered instance should not be aliased. To get a system property for a clustered instance, the dotted name attribute you should use is as follows: domain.servers.clustered-instance-name.system-property , not clustered-instance-name.system-property.