en.help.task-appdeployweb.html Maven / Gradle / Ivy
To Deploy a Web Application
- In the navigation tree, select the Applications node.
The Applications page opens.
- In the Deployed Applications table, click the Deploy button.
The Deploy Applications or Modules page opens.
- Specify the location of the application to deploy.
- If the application is an archive file that resides on or is
accessible from the client machine, select the option Packaged File to Be Uploaded
to the Server.
The client machine is the host on which you are viewing the Administration
Console through a browser.
Click Browse to browse to the file, or type the full path
to the file.
- If the application is an archive file that resides on the server machine,
or is an unpackaged application from an exploded directory, select the option Local
Packaged File or Directory That Is Accessible From the GlassFish Server.
The server machine is the host that is running the domain administration server
(DAS).
Click Browse Files to browse to a file, or Browse Folders to
browse to a directory. Alternatively, type the full path name to the file
or directory. Deploying from an exploded directory is for advanced developers and is
not recommended for production environments.
- From the Type drop-down list, select Web Application.
If you specified either a Packaged File to Be Uploaded to the Server
or a Local Packaged File That Is Accessible From the GlassFish Server, the
application type is detected automatically. If you specified a Directory That Is Accessible From
the GlassFish Server, you must specify the type manually.
- In the Context Root field, type a string that identifies the web application.
In the URL of the web application, the context root immediately follows the
port number (http://host:port/context-root/...). The context root must start with a forward slash, for
example, /hello.
- In the Application Name field, retain the default name, which is the directory
name or the prefix of the file name, or type another name.
The default name appears if you chose to upload a file. The
application name must be unique.
The name can include an optional version identifier, which follows the name and
is separated from the name by a colon (:). The version identifier must
begin with a letter or number. It can contain alphanumeric characters plus underscore (_),
dash (-), and period (.) characters. For more information about module and application
versions, see the Module and Application Versions in Oracle GlassFish Server 3.1 Application Deployment Guide.
- From the Virtual Servers drop-down list, select the virtual server to be associated
with this application.
The Virtual Servers option appears if only the default server instance, server, exists.
If clusters or other stand-alone server instances exist, you can select virtual servers
after deployment. Go to the Edit Application page, select the Target tab, and
select Manage Virtual Servers for the desired target.
- Select the Status Enabled checkbox to enable the application.
This option is selected by default. If this option is disabled, the application
is unavailable.
- Select the Availability Enabled checkbox to enable session persistence for the application.
If the Enabled checkbox is selected, high-availability is enabled for web sessions. If
set to false (default) all web session saving is disabled for the specified
web application. If set to true, the specified web application is enabled for
high-availability. Set this option to true only if high availability is configured and
enabled at higher levels, such as the server and container levels.
This option appears if clusters or stand-alone server instances aside from the default
server instance (server) exist.
- Select the Precompile JSPs checkbox to precompile JavaServer Pages (JSP) files.
If this option is disabled, JSP files are compiled at runtime when they
are first accessed. This option is disabled by default.
- Select the Run Verifier checkbox to verify deployment descriptors before deployment.
If this option is selected and if verification fails, deployment is not performed.
The verifier examines the structure and content of the deployment descriptors. Verification of large
applications is often time-consuming. This option is disabled by default.
Verifier packages must be installed from the Update Tool or a warning is
logged and this option is ignored.
- Select the Force Redeploy checkbox to force redeployment if the application is already
deployed.
If this option is not selected, an attempt to deploy an application that
is already deployed results in an error. This option is disabled by default.
- Select the Keep State checkbox to retain web sessions, SFSB instances, and persistently created
EJB timers between redeployments.
This option is disabled by default. This option is supported only on the
default server instance, named server. It is not supported and ignored for any
other target.
Some changes to an application between redeployments prevent this feature from working properly.
For example, do not change the set of instance variables in the SFSB
bean class.
For web applications, this feature is applicable only if in the glassfish-web-app.xml
file the persistence-type attribute of the session-manager element is file.
For stateful session bean instances, the persistence type without high availability is set
in the server (the SFSB Persistence Type option) and must be set to
file, which is the default and recommended value.
If any active web session, SFSB instance, or EJB timer fails to
be preserved or restored, none of these will be available when the redeployment is
complete. However, the redeployment continues and a warning is logged.
To preserve active state data, GlassFish Server serializes the data and saves it
in memory. To restore the data, the class loader of the newly
redeployed application deserializes the data that was previously saved.
- Select the Preserve Application Scoped Resources checkbox to preserve any application-scoped resources and
restore them during redeployment.
This option is disabled by default.
- In the Libraries field, type a comma-separated list of library JAR files specific
to this module or application.
The paths may be absolute or relative. A relative path is relative to
domain-dir/lib/applibs. If the path is absolute, the path must be accessible to
the domain administration server (DAS), which means it must be under domain-dir. The libraries
are made available to the application in the order in which they are
specified.
- In the Description field, type a description for this application.
- To add target server instances and clusters on which to deploy the module
or application, select them from the Available Targets list and use the Add
button to move them to the Selected Targets list.
The Target option appears if clusters or stand-alone server instances aside from the
default server instance (server) exist. By default, the module or application is deployed to
the default server instance, named server. Use the Add All button to deploy
to all targets. Use the Remove and Remove All buttons to remove targets
from the Selected Targets list.
- Click OK.
See Also
-
-
-
-
-
-
-
-
-
-
-
-
-
Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices