en.help.ref-uploaddev.html Maven / Gradle / Ivy
Deploy Applications or Modules
Use the Deploy Applications or Modules page to deploy an application.
The Deploy Applications or Modules page contains the following options for all applications.
Additional options appear only after you specify the Location field for the application.
- Location
The location of the archive for the application that you are deploying.
The following options specify from where the archive is accessible and whether the archive is a file or a directory.
- Packaged File to Be Uploaded to the Server
The archive is in a file that resides on or is accessible from the client machine.
The client machine is the host on which you are viewing the Administration Console through a browser.
- Local Packaged File or Directory That Is Accessible From the GlassFish Server
The archive is a file that resides on the server machine, or is an unpackaged application in an exploded directory.
The server machine is the host that is running the GlassFish Server domain administration server.
- Type
The type of the application. Available choices are:
Web Application
Enterprise Application
Application Client
Connector Module
EJB Jar
Other
- Targets
Clusters and standalone instances to which to deploy the application or module. Move desired targets to the Selected Targets column using the Add and Add All buttons. Move any unneeded targets to the Available Targets column using the Remove and Remove All buttons.
This option is displayed only if clusters or standalone instances have been created in the domain.
Additional options for the various application types are described in the following sections.
-
-
-
-
-
Additional Options for a Web Application
If the application type is Web Application, the following options appear.
- Context Root
The path to the 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.
- Application Name
The name of the application.
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.
- Virtual Servers
The virtual servers associated with this application.
The Virtual Servers option appears if only the default server instance, server, exists. If clusters or other standalone 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.
- Status
If this option is selected, the application is enabled. This option is selected by default.
- Availability
If the Enabled checkbox is selected, high-availability is enabled for web sessions and for stateful session bean (SFSB) checkpointing and potentially passivation. If set to false (default) all web session saving and SFSB checkpointing is disabled for the specified application, web application, or EJB module. If set to true, the specified application or module 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 standalone server instances aside from the default server instance (server) exist.
- Precompile JSPs
If this option is selected, JavaServer Pages (JSP) files are precompiled. If this option is disabled, JSP files are compiled at runtime when they are first accessed. This option is disabled by default.
- Run Verifier
If this option is selected, deployment descriptors are verified before deployment. 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.
- Force Redeploy
If this option is selected, the application is redeployed if it 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.
- Keep State
This option controls whether web sessions, SFSB instances, and persistently created EJB timers are retained 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.
- Preserve Application Scoped Resources
If checked, preserves any application-scoped resources and restores them during redeployment. This option is not checked by default.
- Libraries
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.
- Description
A description of the application.
Additional Options for an Enterprise Application
If the application type is Enterprise Application, the following options appear.
- Application Name
The name of the application.
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.
- Virtual Servers
The virtual servers associated with this application.
The Virtual Servers option appears if only the default server instance, server, exists. If clusters or other standalone 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.
- Status
If this option is selected, the application is enabled. This option is selected by default.
- Availability
If the Enabled checkbox is selected, high-availability is enabled for web sessions and for stateful session bean (SFSB) checkpointing and potentially passivation. If set to false (default) all web session saving and SFSB checkpointing is disabled for the specified application, web application, or EJB module. If set to true, the specified application or module 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 standalone server instances aside from the default server instance (server) exist.
- Java Web Start
If this option is selected, Java Web Start access is permitted for an application client module. This option is disabled by default.
- Precompile JSPs
If this option is selected, JavaServer Pages (JSP) files are precompiled. If this option is disabled, JSP files are compiled at runtime when they are first accessed. This option is disabled by default.
- Run Verifier
If this option is selected, deployment descriptors are verified before deployment. 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.
- Compatibility
If checked, uses GlassFish Server v2 JAR visibility requirements for applications instead of the stricter Java EE 6 requirements implemented in GlassFish Server v3 releases, including 3.1. This option is not checked by default.
The Java EE 6 platform specification imposes stricter requirements than Java EE 5 did on which JAR files can be visible to various modules within an EAR file. In particular, application clients must not have access to EJB JAR files or other JAR files in the EAR file unless references use the standard Java SE mechanisms (extensions, for example) or the Java EE library-directory mechanism. Checking this box removes these Java EE 6 restrictions.
- Force Redeploy
If this option is selected, the application is redeployed if it 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.
- Keep State
This option controls whether web sessions, SFSB instances, and persistently created EJB timers are retained 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.
- Preserve Application Scoped Resources
If checked, preserves any application-scoped resources and restores them during redeployment. This option is not checked by default.
- Libraries
A comma-separated list of library JAR files specific to this application. Specifies an absolute or relative path. 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.
- Description
A description of the application.
Additional Options for an Application Client
If the application type is Application Client, the following options appear.
- Application Name
The name of the application.
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.
- Java Web Start
If this option is selected, Java Web Start access is permitted for an application client module. This option is disabled by default.
- Run Verifier
If this option is selected, deployment descriptors are verified before deployment. 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.
- Force Redeploy
If this option is selected, the application is redeployed if it 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.
- Description
A description of the application.
Additional Options for a Connector Module
If the application type is Connector Module, the following options appear.
- Application Name
The name of the application.
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.
- Status
If this option is selected, the application is enabled. This option is selected by default.
- Run Verifier
If this option is selected, deployment descriptors are verified before deployment. 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.
- Force Redeploy
If this option is selected, the application is redeployed if it 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.
- Preserve Application Scoped Resources
If checked, preserves any application-scoped resources and restores them during redeployment. This option is not checked by default.
- Description
A description of the application.
Additional Options for an EJB Jar
If the application type is EJB Jar, the following options appear.
- Application Name
The name of the application.
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.
- Status
If this option is selected, the application is enabled. This option is selected by default.
- Availability
If the Enabled checkbox is selected, high-availability is enabled for web sessions and for stateful session bean (SFSB) checkpointing and potentially passivation. If set to false (default) all web session saving and SFSB checkpointing is disabled for the specified application, web application, or EJB module. If set to true, the specified application or module 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 standalone server instances aside from the default server instance (server) exist.
- Run Verifier
If this option is selected, deployment descriptors are verified before deployment. 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.
- Compatibility
If checked, uses GlassFish Server v2 JAR visibility requirements for applications instead of the stricter Java EE 6 requirements implemented in GlassFish Server v3 releases, including 3.1. This option is not checked by default.
The Java EE 6 platform specification imposes stricter requirements than Java EE 5 did on which JAR files can be visible to various modules within an EAR file. In particular, application clients must not have access to EJB JAR files or other JAR files in the EAR file unless references use the standard Java SE mechanisms (extensions, for example) or the Java EE library-directory mechanism. Checking this box removes these Java EE 6 restrictions.
- Force Redeploy
If this option is selected, the application is redeployed if it 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.
- Keep State
This option controls whether web sessions, SFSB instances, and persistently created EJB timers are retained 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.
- Preserve Application Scoped Resources
If checked, preserves any application-scoped resources and restores them during redeployment. This option is not checked by default.
- Libraries
A comma-separated list of library JAR files specific to this module or application. Specifies an absolute or relative path. 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.
- Description
A description of the application.
Additional Options for Applications of Type Other
If the application type is Other, the following options appear.
- Application Name
The name of the application.
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.
- Virtual Servers
The virtual servers associated with this application.
The Virtual Servers option appears if only the default server instance, server, exists. If clusters or other standalone 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.
- Status
If this option is selected, the application is enabled. This option is selected by default.
- Availability
If the Enabled checkbox is selected, high-availability is enabled for web sessions and for stateful session bean (SFSB) checkpointing and potentially passivation. If set to false (default) all web session saving and SFSB checkpointing is disabled for the specified application, web application, or EJB module. If set to true, the specified application or module 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 standalone server instances aside from the default server instance (server) exist.
- OSGI Type
If this option is selected, it specifies a hybrid OSGi/Java-EE module. This option only appears if the Type selected is Other.
- Precompile JSPs
If this option is selected, JavaServer Pages (JSP) files are precompiled. If this option is disabled, JSP files are compiled at runtime when they are first accessed. This option is disabled by default.
- Run Verifier
If this option is selected, deployment descriptors are verified before deployment. 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.
- Force Redeploy
If this option is selected, the application is redeployed if it 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.
- Keep State
This option controls whether web sessions, SFSB instances, and persistently created EJB timers are retained 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.
- Libraries
A comma-separated list of library JAR files specific to this module or application. Specifies an absolute or relative path. 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.
- Description
A description of the application.
Related Tasks
-
-
-
-
-
-
-
-
-
-
-
-
-
Related asadmin Commands
Copyright © 2005, 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices