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

About Application Deployment

General Deployment Functionality

Deployment Descriptors and Annotations

Modules and Applications

Types of Modules

Module-Based Deployment

Application-Based Deployment

Access to Shared Framework Classes

Naming Standards

Portable Naming

JNDI Naming

Directory Structure

JSR 88 Naming

Module and Application Versions

Version Identifiers and Expressions

Choosing the Enabled Version

Versioning Restrictions and Limitations

About Assembly and Deployment Events

About Deployment Tools

Administration Console

The asadmin Utility

NetBeans IDE

Eclipse IDE

JSR 88 Client

Additional Information on Application Deployment

2.  Deploying Applications

A.  The asadmin Deployment Subcommands

B.  GlassFish Server Deployment Descriptor Files

C.  Elements of the GlassFish Server Deployment Descriptors


About Deployment Tools

GlassFish Server provides tools for assembling and deploying a module or application.

The following topics are addressed here:

Administration Console

The GlassFish Server Administration Console is a browser-based utility that features a graphical interface that includes extensive online help for the administrative tasks. The format for starting the Administration Console in a web browser is http://hostname:port. For example:


Step-by-step instructions for using the Administration Console for deployment are provided in the Administration Console online help. You can display the help material for a page by clicking the Help button. The initial help page describes the functions and fields of the page itself. To find instructions for performing associated tasks, click a link in the See Also list.

The asadmin Utility

The GlassFish Server asadmin utility is a command-line tool that invokes subcommands for identifying the operation or task that you want to perform. You can run asadmin commands either from a command prompt or from a script. The format for starting the asadmin utility on the command line is as-install/bin/asadmin subcommand --option. For example:

asadmin list-applications --type web

Application deployment commands are listed in Appendix A, The asadmin Deployment Subcommands. All GlassFish Server asadmin commands are documented in Oracle GlassFish Server 3.1-3.1.1 Reference Manual.

For the most part, you can perform the same administrative tasks by using either the graphical Administration Console or the asadmin command-line utility, however, there are exceptions. Procedures for using the command-line utilities are provided in this guide and in the command-line help pages, which are similar to man pages. You can display the help material for a command by typing help followed by the subcommand. For example:

asadmin help list-applications

For additional information on the asadmin utility, see Using the asadmin Utility in Oracle GlassFish Server 3.1 Administration Guide and the asadmin(1M) help page.

NetBeans IDE

You can use the NetBeans Integrated Development Environment (IDE), or another IDE, to assemble Java EE applications and modules. The NetBeans IDE is included in the tools bundle of the Java EE Software Development Kit (SDK). To download, see For additional information, see

Eclipse IDE

In addition to the bundled NetBeans IDE, a plug-in for the Eclipse IDE extends GlassFish to the Eclipse community. To download, see

JSR 88 Client

The syntax of the URI entry for the getDeploymentManager method is as follows:


For example: