JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server 3.1 Application Deployment Guide
search filter icon
search icon

Document Information


1.  Overview of Oracle GlassFish Server 3.1 Application Deployment

2.  Deploying Applications

A.  The asadmin Deployment Subcommands

B.  GlassFish Server Deployment Descriptor Files

About the GlassFish Server Deployment Descriptors

The glassfish-application.xml File

The glassfish-web.xml File

The glassfish-ejb-jar.xml File

The sun-cmp-mappings.xml File

The glassfish-application-client.xml file

The sun-acc.xml File

The glassfish-resources.xml File

WebLogic Server Deployment Descriptor Support in GlassFish Server

C.  Elements of the GlassFish Server Deployment Descriptors


About the GlassFish Server Deployment Descriptors

Each deployment descriptor XML file has a corresponding Document Type Definition (DTD) file, which defines the elements, data, and attributes that the deployment descriptor file can contain. For example, the glassfish-application_6_0-1.dtd file defines the structure of the glassfish-application.xml file. The DTD files for the GlassFish Server deployment descriptors are located in the as-install/lib/dtds directory.

The GlassFish Server deployment descriptor files must be readable and writable by the file owners. In each deployment descriptor file, subelements must be defined in the order in which they are listed under each Subelements heading, unless otherwise noted. For general information about DTD files and XML, see the XML specification at

Note - Do not edit the DTD files; their contents change only with new versions of GlassFish Server.

The following table lists the GlassFish Server deployment descriptors and their DTD files.

Table B-1 GlassFish Server Deployment Descriptors and DTDs

Deployment Descriptor
DTD File
Configures an entire Java EE application (EAR file).
Configures a web application (WAR file).
Configures an enterprise bean (EJB JAR file).
Configures container-managed persistence for an EJB 2.0 or 2.1 entity bean.
Configures an Application Client Container (ACC) client (JAR file).
Configures the Application Client Container. This is more of a configuration file than a deployment descriptor. GlassFish Server provides a default file in the domain-dir/config directory. Specifying a different file is optional.
Configures application-scoped resources.

Note - The sun-application.xml, sun-web.xml, sun-ejb-jar.xml, sun-application-client.xml, and sun-resources.xml deployment descriptors are supported for backward compatibility.