Oracle GlassFish Server 3.0.1 Domain File Format 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–36 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 Oracle GlassFish Server 3.0.1 Application Development Guide.

Table 1–37 das-config Attributes

Attribute 

Default 

Description 

dynamic-reload-enabled

true

(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

true

(optional) If true, enables autodeployment, which lets you quickly deploy applications and modules to a running GlassFish 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.

auto-deploy-retry-timeout

4

(optional) Specifies the number of autodeployment retry attempts before autodeployment times out. 

deploy-xml-validation

full

(optional) Specifies the type of XML validation performed on standard and GlassFish 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, application, connector-connection-pool, connector-module, connector-resource, context-param, custom-resource, ejb-module, env-entry, extension-module, external-jndi-resource, j2ee-application, jdbc-connection-pool, jdbc-resource, lifecycle-module, mail-resource, property, system-property, transformation-rule, web-module

Subelements

none - contains data

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–38 domain Subelements

Element 

Required 

Description 

system-applications

zero or one 

Contains system applications. 

applications

zero or one 

Contains deployed Java EE applications, Java EE modules, and applications created using other supported technologies. 

resources

zero or one 

Contains configured resources. 

configs

only one 

Contains configurations. 

servers

only one 

Contains server instances. 

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–39 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. 

version

none; value changes with each major release 

Specifies the version of the GlassFish Server as returned by the fullVersion field of the com.sun.appserv.server.util.Version class.