Sun GlassFish Enterprise Server 2.1 Administration Reference

D

das-config

Defines a domain administration server configuration. The domain administration server runs the Administration Console.

Superelements

admin-service

Subelements

The following table describes subelements for the das-config element.

Table 1–42 das-config Subelements


Element	Required	Description
property	zero or more	Specifies a property or a variable.

Attributes

The following table describes attributes for the das-config element. For more information about deployment topics such as dynamic reloading and autodeployment, see the Sun GlassFish Enterprise Server 2.1 Developer’s Guide.

Table 1–43 das-config Attributes


Attribute	Default	Description
`dynamic-reload-enabled`	`false`	(optional) If `true`, checks the timestamp on a `.reload` file at every module and application directory level, to trigger dynamic reloading.
`dynamic-reload-poll-interval-in-seconds`	`2`	(optional) Controls the polling frequency of dynamic reloading.
`autodeploy-enabled`	`false`	(optional) If `true`, enables autodeployment, which lets you quickly deploy applications and modules to a running Enterprise Server without performing an explicit server instance restart or a separate deployment operation.
`autodeploy-polling-interval-in-seconds`	`2`	(optional) Controls the polling frequency of autodeployment.
`autodeploy-dir`	`autodeploy`	(optional) Specifies the source directory (absolute or relative to `domain-dir`) in which autodeployment looks for deployable components.
`autodeploy-verifier-enabled`	`false`	(optional) If `true`, the verifier is run before autodeployment. If verification fails, deployment is not performed.
`autodeploy-jsp-precompilation-enabled`	`false`	(optional) If `true`, JSP pages are precompiled during autodeployment.
`deploy-xml-validation`	`full`	(optional) Specifies the type of XML validation performed on standard and Enterprise Server deployment descriptors: `full` - If XML validation fails, deployment fails. `parsing` - XML validation errors are reported but deployment occurs. `none` - No XML validation is performed.
`admin-session-timeout-in-minutes`	`sun-web.xml` `timeoutSeconds` property value or `web.xml` `session-timeout` attribute value	(optional) Specifies the Administration Console timeout.

description

Contains a text description of the parent element.

Superelements

admin-object-resource, appclient-module, connector-connection-pool, connector-module, connector-resource, custom-resource, ejb-module, event, extension-module, external-jndi-resource, j2ee-application, jdbc-connection-pool, jdbc-resource, lifecycle-module, mail-resource, management-rule, mbean, persistence-manager-factory-resource, property, system-property, transformation-rule, web-module

Subelements

none - contains data

diagnostic-service

Configures the Diagnostic Service, which lets you generate a diagnostic report for troubleshooting in case of Enterprise Server malfunctioning such as exceptions, performance bottlenecks, or unexpected results.

Superelements

config

Subelements

The following table describes subelements for the diagnostic-service element.

Table 1–44 diagnostic-service Subelements


Element	Required	Description
property	zero or more	Specifies a property or a variable.

Attributes

The following table describes attributes for the diagnostic-service element.

Table 1–45 diagnostic-service Attributes


Attribute	Default	Description
`compute-checksum`	`true`	(optional) If `true`, computes a checksum of binaries.
`verify-config`	`true`	(optional) If `true`, captures the output of the `asadmin verify-domain-xml` command.
`capture-install-log`	`true`	(optional) If `true`, captures the log generated during Enterprise Server installation.
`capture-system-info`	`true`	(optional) If `true`, collects operating system level information.
`capture-hadb-info`	`true`	(optional) If `true`, collects HADB related data. Applicable if HADB is installed and you have selected the enterprise profile. For more information about the HADB, see the Sun GlassFish Enterprise Server 2.1 High Availability Administration Guide.
`capture-app-dd`	`true`	(optional) If `true`, captures application deployment descriptors in plain text. If any deployment descriptors contain confidential information, you should set it to `false`.
`min-log-level`	`INFO`	(optional) Specifies the log level for the diagnostic report. See module-log-levels for a description of log levels. If set to `OFF`, log contents are not captured.
`max-log-entries`	`500`	(optional) Specifies the maximum number of log entries captured.

domain

Defines a domain. This is the root element; there can only be one domain element in a domain.xml file.

Superelements

none

Subelements

The following table describes subelements for the domain element.

Table 1–46 domain Subelements


Element	Required	Description
applications	zero or one	Contains deployed Java EE applications, Java EE modules, and lifecycle modules.
resources	zero or one	Contains configured resources.
configs	only one	Contains configurations.
servers	only one	Contains server instances.
clusters	zero or one	Contains clusters.
node-agents	zero or one	Contains node agents.
lb-configs	zero or one	Contains load balancing configurations.
load-balancers	zero or one	Contains load balancers.
system-property	zero or more	Specifies a system property.
property	zero or more	Specifies a property or a variable.

Attributes

The following table describes attributes for the domain element.

Table 1–47 domain Attributes


Attribute	Default	Description
`application-root`	`domain-dir/applications`	(optional) Specifies the absolute path where deployed applications reside for this domain.
`log-root`	`domain-dir/logs`	(optional) Specifies where the domain’s log files are kept. The directory in which the log is kept must be writable by whatever user account the server runs as. See the log-service description for details about logs.
`locale`	operating system default	(optional) Specifies the domain’s language.