diff --git a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Class Loaders.adoc b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Class Loaders.adoc index cc15061d1..f19dc6356 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Class Loaders.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Class Loaders.adoc @@ -270,6 +270,9 @@ It's possible to disable class loading delegation directly at the application le [[disabling-classloading-delegation-on-webapps]] For *Web* applications, you can include `` element in the `payara-web.xml`/`glassfish-web.xml` deployment descriptors. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + Here's an example: [source, xml] @@ -302,6 +305,9 @@ It's possible to configure an extreme isolation level on the class loading deleg To configure whitelist packaging you can use the `` element on the `payara-web.xml` / `glassfish-web.xml` (for WAR artifacts) or the `glassfish-application.xml` (for EAR artifacts) deployment descriptors. This element can be included multiple times to whitelist multiple packages. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + Here is an example of whitelisting both the *Google Guava*, *Jackson* and *Faces Config* packages for a WAR application: [source, xml] diff --git a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing Connectors.adoc b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing Connectors.adoc index a4541f203..021f6e059 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing Connectors.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing Connectors.adoc @@ -220,6 +220,9 @@ To disable connection pooling, set the _Pooling_ attribute to `false`. The defau You can define an application-scoped connector or other resource for an enterprise application, web module, EJB module, connector module, or application client module by supplying a `payara-resources.xml` or `glassfish-resources.xml` deployment descriptor file. For details, see "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Deploying Applications.adoc#application-scoped-resources[Application-Scoped Resources]" in the Payara Server Application Deployment section. +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + [[inbound-communication-support]] == Inbound Communication Support diff --git a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing SOAP Webservices.adoc b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing SOAP Webservices.adoc index eae5487cb..163e23dcb 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing SOAP Webservices.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing SOAP Webservices.adoc @@ -25,6 +25,9 @@ IMPORTANT: For complex services with dependent classes, user specified WSDL file The Payara Server deployment descriptor files `glassfish-web.xml`/`payara-web.xml` and `glassfish-ejb-jar.xml` provide optional web service enhancements in the `webservice-endpoint` and `webservice-description` elements, including a `debugging-enabled` sub-element that enables the creation of a test page. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + The test page feature is enabled by default and described in xref:#the-web-service-uri-wsdl-file-and-test-page[The Web Service URI, WSDL File, and Test Page]. [[the-web-service-uri-wsdl-file-and-test-page]] @@ -40,6 +43,9 @@ http://${host}:${port}/${context-root}/${servlet-mapping-url-pattern} The context-root is defined in the `application.xml` or `web.xml` file, and can be overridden in the `glassfish-application.xml` or `glassfish-web.xml`/`payara-web.xml` file. The servlet-mapping-url-pattern is defined in the `web.xml` file. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + In the following example, the context-root is `my-ws` and the servlet-mapping-url-pattern is `/simple` for local deployment in the default port: [source,text] diff --git a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing Web Applications.adoc b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing Web Applications.adoc index 959a22548..67e919d2c 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing Web Applications.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Developing Web Applications.adoc @@ -24,6 +24,9 @@ Whether to cache results and how to cache them depends on the data involved. For To define how a web application handles response caching, you'll have to modify specific attributes in the `glassfish-web.xml` or `payara-web.xml` deployment descriptor file. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + WARNING: A servlet that uses caching is not portable. For information about JSP caching, see xref:#jsp-caching[JSP Caching]. @@ -119,6 +122,9 @@ Here is an example cache element in the `glassfish-web.xml`/`payara-web.xml` fil For more information about the `glassfish-web.xml`/`payara-web.xml` caching settings, see "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache[cache]" in the Payara Server Application Deployment section. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + [[the-cachekeygenerator-interface]] ==== The CacheKeyGenerator Interface @@ -128,6 +134,9 @@ The name of the context attribute is configurable as the `value` of the `cacheKe For more information, see "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#default-helper[default-helper]" in the Payara Server Application Deployment section. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + [[about-the-servlet-engine]] === About the Servlet Engine @@ -360,6 +369,9 @@ This section describes how to create and manage HTTP sessions that allows users To configure whether and how HTTP sessions use cookies and URL rewriting, edit the `session-properties` and `cookie-properties elements in the `glassfish-web.xml` or `payara-web.xml` file for an individual web application. For more details about the properties you can configure, see "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-properties[session-properties]" "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cookie-properties[cookie-properties]" and in the Payara Server Application Deployment section. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + For information about configuring default session properties for the entire web container, see xref:#using-the-default-web.xml-file[Using the `default-web.xml` File]. @@ -379,6 +391,9 @@ NOTE: This option is not supported and ignored for other targets (clusters and d For web applications, this feature is applicable only if in the `payara-web.xml` / `glassfish-web.xml` deployment descriptor files when the `persistence-type` attribute of the `session-manager` element is set to `file`. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + If any active web session fails to be preserved or restored, none of the sessions will be available when the redeployment is complete. However, the redeployment continues and a warning is logged. The new class loader of the redeployed application is used to deserialize any sessions previously saved. The usual restrictions about serialization and deserialization apply. For example, any application-specific class referenced by a session attribute may evolve only in a backward-compatible fashion. @@ -456,6 +471,9 @@ A session manager automatically creates new session objects whenever a new sessi The Payara Platform offers these session management options, determined by the `session-manager` element's `persistence-type` attribute in the `glassfish-web.xml`/`payara-web.xml` file: +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + * xref:#the-memory-persistence-type[The `memory` Persistence Type] * xref:#the-file-persistence-type[The `file` Persistence Type], which uses a file to store session data * xref:#the-hazelcast-persistence-type[The `hazelcast` Persistence Type], which uses the Data Grid to store session data @@ -484,6 +502,9 @@ To specify the `memory` persistence type for a specific web application, edit th ---- +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + The only manager property that the `memory` persistence type supports is `sessionFilename`, which is listed under "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#manager-properties[manager-properties]" in the Payara Server Application Deployment section. @@ -513,6 +534,9 @@ To specify the `file` persistence type for a specific web application, edit the ---- +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + The `file` persistence type supports all the manager properties listed under "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#manager-properties[manager-properties]" in the Payara Server Application Deployment section except `sessionFilename`, and supports the `directory` store property listed under "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#store-properties[store-properties]" in the same document. [[the-hazelcast-persistence-type]] @@ -672,6 +696,9 @@ When processing a servlet request, the server uses the following order of preced * The `default-charset` attribute of the `parameter-encoding` element in the `glassfish-web.xml` or `payara-web.xml` deployment descriptor * The default encoding, which is `ISO-8859-1` +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + For details about the `parameter-encoding` element, see "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#parameter-encoding[parameter-encoding]" in the Payara Server Application Deployment section. [[servlet-response]] @@ -778,6 +805,9 @@ In the `glassfish-web.xml`/`payara-web.xml` deployment descriptor, valve and lis ---- +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + You can define these same properties for a virtual server configuration. For more information, see xref:#virtual-server-properties[Virtual Server Properties]. [[using-a-context.xml-file]] @@ -818,6 +848,9 @@ NOTE: Not all context definitions are supported by the Payara Platform. To enable WebDav in Payara Server, you edit the `web.xml` and `glassfish-web.xml`/`payara-web.xml` files as follows. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + First, enable the WebDav servlet in your `web.xml` file: [source,xml] @@ -885,6 +918,9 @@ Then define a security role mapping in your `glassfish-web.xml` or `payara-web.x ---- +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + Enable the security manager as described in xref:Technical Documentation/Application Development/Securing Applications.adoc#enabling-and-disabling-the-security-manager[Enabling and Disabling the Security Manager]. You can now use any WebDav client by connecting to the WebDav servlet URL, which has this format: @@ -1047,6 +1083,9 @@ For example, the following properties specify three `glassfish-web.xml`/ `payara ---- +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + The `value` of each alternate document root has two components: The first component, `from`, specifies the alternate document root's URI pattern, and the second component, `dir`, specifies the alternate document root's physical location (directory). diff --git a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Securing Applications.adoc b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Securing Applications.adoc index 01bf7c57f..df9956587 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Securing Applications.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Securing Applications.adoc @@ -79,6 +79,9 @@ For an individually deployed web or EJB module, you define roles using `@Declare To map roles to principals and groups, define matching `security-role-mapping` elements in the `glassfish-application.xml`, `glassfish-ejb-jar.xml`, or `glassfish-web.xml`/`payara-web.xml` file for each `role-name` used by the application. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + By default, group principal names are mapped to roles of the same name. Accordingly, the *Default Principal To Role Mapping* setting is enabled by default on the _Security_ page of the Payara Server Administration Console. @@ -91,6 +94,9 @@ Component level security encompasses web components and EJB components. A secure web container authenticates users and authorizes access to a servlet or JSP by using the security policy laid out in the servlet XML deployment descriptors (`web.xml`, `glassfish-web.xml` and `payara-web.xml` files). +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + The EJB container is responsible for authorizing access to a bean method by using the security policy laid out in the EJB XML deployment descriptors (`ejb-jar.xml` and `glassfish-ejb-jar.xml` files). [[programmatic-security]] @@ -141,6 +147,9 @@ For example, a `payara-web.xml` file for an individually deployed web module mig ---- +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + A role can be mapped to either specific principals or to groups (or both). The principal or group names used must be valid principals or groups in the realm for the application or module. Note that the `role-name` in this example must match the `@DeclareRoles` annotations or the `role-name` in the `security-role` element of the corresponding `web.xml` file. @@ -1543,6 +1552,9 @@ After you install and configure the SAM, you can bind it for use by the containe TIP: You can find a description of the functionality of an `AuthConfigProvider` and of the registration facilities provided by an `AuthConfigFactory` in the Jakarta Authentication specification. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead.s + [[advanced-group-configuration]] == Advanced Groups Configuration diff --git a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Using Jakarta Faces Technology.adoc b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Using Jakarta Faces Technology.adoc index 0689e1444..190e91c31 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Using Jakarta Faces Technology.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Using Jakarta Faces Technology.adoc @@ -94,6 +94,9 @@ To configure this feature, you need to indicate within the `payara-web.xml` / `g ---- +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + By specifying these options, the bundled Jakarta Faces implementation within your web application will be used instead of the default implementation included within the server. IMPORTANT: If deploying a EAR application you must bundle the Jakarta Faces implementation library within the embedded WAR component. You cannot add an alternative Jakarta Faces implementation as an EAR library. diff --git a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Using the Java Naming and Directory Interface.adoc b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Using the Java Naming and Directory Interface.adoc index 88b79a8fd..ad24e501b 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Application Development/Using the Java Naming and Directory Interface.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Application Development/Using the Java Naming and Directory Interface.adoc @@ -160,6 +160,9 @@ Object o = ic.lookup("corbaname:iiop:host:port#a/b/Foo"); IMPORTANT: Objects stored in the interoperable naming context and component-specific (`java:comp/env`) naming contexts are transient. On each server startup or application reloading, all relevant objects are re-bound to the namespace. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + [[naming-environment-for-lifecycle-modules]] === Naming Environment for Lifecycle Modules @@ -210,6 +213,9 @@ Payara Server provides built-in factories for the following types of custom reso It is possible to create custom resources by using a `payara-resources.xml` or `glassfish-resources.xml` deployment descriptor. To this effect, several `glassfish-resources.xml` template files for these built-in factories and a `README` file are available at `as-install/lib/install/templates/resources/custom/`. +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + [[javabeanfactory]] ==== *JavaBeanFactory* @@ -286,6 +292,9 @@ For the third constructor, define a property named `spec` and assign it the valu You can define an application-scoped JNDI resource for an enterprise application, web module, EJB module, connector module, or application client module by supplying a `glassfish-resources.xml` or `payara-resources.xml` deployment descriptor file. +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + For details, see "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Deploying Applications.adoc#application-scoped-resources[Application-Scoped Resources]" in the Application Deployment section. [[using-a-custom-jndi.properties-file]] @@ -310,6 +319,9 @@ In this case, `mycompany.pkging.pkgingEJB.MyEJB` would be the JNDI name for an E These elements are part of the `glassfish-web.xml`/`payara-web.xml`, `glassfish-application-client.xml`, `glassfish-ejb-jar.xml`, and `glassfish-application.xml` deployment descriptor files. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + For more information about how these elements behave in each of the deployment descriptor files, see "xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#elements-of-the-payara-platform-deployment-descriptors[Elements of the Payara Server Deployment Descriptors]" in the Payara Server Application Deployment section. The following is an example of a JDBC resource lookup to showcase how to reference resource factories. The same principle is applicable to all resources (such as JMS destinations, JavaMail sessions, and so on). diff --git a/docs/modules/ROOT/pages/Technical Documentation/Ecosystem/Connector Suites/Arquillian Containers/Payara Server Managed.adoc b/docs/modules/ROOT/pages/Technical Documentation/Ecosystem/Connector Suites/Arquillian Containers/Payara Server Managed.adoc index 2f5ba6562..82f4f5c2b 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Ecosystem/Connector Suites/Arquillian Containers/Payara Server Managed.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Ecosystem/Connector Suites/Arquillian Containers/Payara Server Managed.adoc @@ -143,6 +143,9 @@ If the component is packaged as a regular archive, do not set this option. The context root that will be used to run the tests is also retrieved automatically from the DAS server. If the deployed application does have a `sun-web.xml`, `glassfish-web.xml` or `payara-web.xml` deployment descriptor, the container will use the name of your deployment without the extension as context root. + The same rule is applied for enterprise applications if there is no `application.xml` file. The JAR test-deployments are treated as a web application. +IMPORTANT: glassfish-web.xml and sun-web.xml are deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + [[examples]] == Examples diff --git a/docs/modules/ROOT/pages/Technical Documentation/Ecosystem/Connector Suites/Arquillian Containers/Payara Server Remote.adoc b/docs/modules/ROOT/pages/Technical Documentation/Ecosystem/Connector Suites/Arquillian Containers/Payara Server Remote.adoc index 2fd260030..9b6823bf2 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Ecosystem/Connector Suites/Arquillian Containers/Payara Server Remote.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Ecosystem/Connector Suites/Arquillian Containers/Payara Server Remote.adoc @@ -113,6 +113,9 @@ If the component is packaged as a regular archive, do not set this option. The context root that will be used to run the tests is also retrieved automatically from the DAS server. If the deployed application does have a `sun-web.xml`, `glassfish-web.xml` or `payara-web.xml` deployment descriptor, the container will use the name of your deployment without the extension as context root. + The same rule is applied for enterprise applications if there is no `application.xml` file. The JAR test-deployments are treated as a web application. +IMPORTANT: glassfish-web.xml and sun-web.xml are deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + [[examples]] == Examples diff --git a/docs/modules/ROOT/pages/Technical Documentation/MicroProfile/JWT.adoc b/docs/modules/ROOT/pages/Technical Documentation/MicroProfile/JWT.adoc index 882aa5ae0..3d5557b66 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/MicroProfile/JWT.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/MicroProfile/JWT.adoc @@ -282,6 +282,6 @@ With `base` being the context where the application is deployed, e.g. `http://ex [[switch-off-rolesallowed-support]] == Switching off @RolesAllowed Support -The out-of-the-box support of `@RolesAllowed` for Jakarta REST Services resources can be switched off by setting the `` tag in `WEB-INF/glassfish-web.xml` to `false`. +The out-of-the-box support of `@RolesAllowed` for Jakarta REST Services resources can be switched off by setting the `` tag in `WEB-INF/payara-web.xml` to `false`. For more information see the documentation for the xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#jaxrs-roles-allowed-enabled[jaxrs-roles-allowed-enabled] element. diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Micro Documentation/Payara Micro Configuration and Management/Micro Management/Configuring An Instance.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Micro Documentation/Payara Micro Configuration and Management/Micro Management/Configuring An Instance.adoc index a45bfc0e4..a826d75e6 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Micro Documentation/Payara Micro Configuration and Management/Micro Management/Configuring An Instance.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Micro Documentation/Payara Micro Configuration and Management/Micro Management/Configuring An Instance.adoc @@ -201,7 +201,10 @@ http://localhost:9080/test -------------------------- Currently, this is *always* the case; including when a context root is specified -in a `glassfish-web.xml` deployment descriptor. +in a `payara-web.xml`/`glassfish-web.xml` deployment descriptor. + +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. If the WAR file is renamed to `ROOT.war` and packaged as an Uber JAR, it will be deployed to the root context: diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Deploying Applications.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Deploying Applications.adoc index d45c3bb47..52d144f99 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Deploying Applications.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Deploying Applications.adoc @@ -901,12 +901,16 @@ For example: + [source,xml] ---- - + - + ---- + +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + + If you include this property when you deploy the WAR file, the generated source is kept in `domain-dir/generated/jsp/app-name/module-name` for an application, or `domain-dir/generated/jsp/module-name` for an individually-deployed web module. + @@ -971,6 +975,9 @@ The following topics are addressed here: As an alternative to Step 3 through Step 6, you can define application-scoped resources in the `glassfish-resources.xml` or `payara-resources.xml` deployment descriptor. +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + For more information, see xref:Technical Documentation/Payara Server Documentation/Application Deployment/Deploying Applications.adoc#application-scoped-resources[Application-Scoped Resources]. . Ensure that the server is running. @@ -1154,6 +1161,9 @@ If the deployed application or module has a web service endpoint, the endpoint i + The Payara Server specific deployment descriptor files, `glassfish-web.xml`, `payara-web.xml` and `glassfish-ejb-jar.xml`, provide optional web service enhancements in their xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] and xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-description[`webservice-description`] elements. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + * *Web Service Management*. Web service management is fully supported in the Administration Console. After the application or module is deployed, click the Web Service component. The table in the right frame lists deployed web service endpoints. For more information about web services, see "xref:Technical Documentation/Application Development/Developing SOAP Webservices.adoc#developing-web-services[Developing Web Services]" in the Application Development section. @@ -1189,6 +1199,9 @@ If this property exists and has a positive value, it is enabled. You can set this property in the `glassfish-resources.xml` or `payara-resources.xml` file. For more information, see the property descriptions under xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#jdbc-connection-pool[`jdbc-connection-pool`]. +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + For JDBC connection pools that are not application-scoped, use the `set` subcommand to set this property. For example, to configure `mypool` on `myserver`, type the following all on one line: [source,shell] @@ -1228,6 +1241,9 @@ If any submodule archives of an enterprise application archive have their own `g For more information about the `glassfish-resources.xml` and `payara-resources.xml` file, see xref:Technical Documentation/Payara Server Documentation/Application Deployment/Deployment Descriptor Files.adoc#the-glassfish-resources.xml-file[Payara Server Deployment Descriptor Files] and xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc[Elements of the Payara Server Deployment Descriptors]. +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + *Naming*: Application-scoped resource JNDI names begin with `java:app` or `java:module`. If one of these prefixes is not specified in the JNDI name, it is added. For example, application-scoped databases have JNDI names in the following format: `java:app/jdbc/DataSourceName` or `java:module/jdbc/DataSourceName`. *Errors*: Application-scoped resource definitions with same resource name, resource type, attributes, and properties are duplicates. These generate `WARNING` level log messages and deployment continues. diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Deployment Descriptor Files.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Deployment Descriptor Files.adoc index 8d973754d..b39969ff6 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Deployment Descriptor Files.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Deployment Descriptor Files.adoc @@ -31,7 +31,7 @@ The following table lists the Payara Platform deployment descriptors and their D | Configures an entire Jakarta EE application (EAR file). | -`glassfish-web.xml` +`glassfish-web.xml` (deprecated) `payara-web.xml` | `glassfish-web-app_3_0-1.dtd` @@ -46,7 +46,7 @@ The following table lists the Payara Platform deployment descriptors and their D | Configures an Application Client Container (ACC) client (JAR file). | -`glassfish-resources.xml` +`glassfish-resources.xml` (deprecated) `payara-resources.xml` | `glassfish-resources_1_5.dtd` @@ -163,6 +163,9 @@ The `glassfish-web.xml` file configures a web application (WAR file). It is an o The `payara-web.xml` is a matching Payara Platform variant which is recommended to be used whenever possible. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + Their element hierarchy is as follows: [source,text] @@ -648,6 +651,9 @@ glassfish-application-client [[the-glassfish-resources.xml-file]] == The `glassfish-resources.xml` and `payara-resources.xml` Files +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + The `glassfish-resources.xml` file configures application-scoped resources. It is an original Eclipse GlassFish deployment descriptor. The `payara-resources.xml` is a matching Payara Platform variant that supports additional elements. @@ -965,6 +971,9 @@ The only element in `weblogic-application.xml` that Payara Server supports is `s The elements of `weblogic.xml` that Payara Server supports are explained in the following table. +IMPORTANT: weblogic.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + .`weblogic.xml` Support in Payara Server [cols="2,6",options="header"] diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc index b6a18c7bf..a316add42 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc @@ -104,7 +104,7 @@ Defines an administered object for an inbound resource adapter. [[superelements-4]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-4]] === Subelements @@ -237,7 +237,7 @@ As a prerequisite to gaining access to any web resources protected by an authori [[superelements-7]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#login-config[`login-config`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#login-config[`login-config`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#as-context[`as-context`] (`glassfish-ejb-jar.xml`) [[subelements-7]] @@ -314,7 +314,7 @@ Specifies the user name and password required by the Enterprise Information Syst [[superelements-9]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-map[`security-map`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-map[`security-map`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-9]] === Subelements @@ -465,7 +465,7 @@ Configures caching for web application components. [[superelements-12]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-12]] === Subelements @@ -558,7 +558,7 @@ Specifies a class that implements the com.sun.appserv.web.cache.CacheHelper inte [[superelements-13]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache[`cache`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache[`cache`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-13]] === Subelements @@ -600,7 +600,7 @@ Specifies the `name` of the xref:Technical Documentation/Payara Server Document [[superelements-14]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-14]] === Subelements @@ -633,7 +633,7 @@ Maps a URL pattern or a servlet name to its cacheability constraints. [[superelements-16]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache[`cache`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache[`cache`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-16]] === Subelements @@ -691,7 +691,7 @@ Specifies JAX-RPC property values that can be set on a `javax.xml.rpc.Call` obje [[superelements-17]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-17]] === Subelements @@ -863,7 +863,7 @@ Configures the class loader for the web module. [[superelements-25]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-23]] === Subelements @@ -949,7 +949,7 @@ For more information about how class delegation can be configured on Payara Serv [[superelements-223]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`payara-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`payara-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-application[`glassfish-application`] (`glassfish-application.xml`) [[subelements-214-2]] @@ -1483,7 +1483,7 @@ Defines a connector connection pool. [[superelements-39]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-37]] === Subelements @@ -1674,7 +1674,7 @@ Defines the connection factory object of a specific connection definition in a c [[superelements-40]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-38]] === Subelements @@ -1779,7 +1779,7 @@ All `constraint-field` constraints must pass for a response to be cached. If the [[superelements-42]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-40]] === Subelements @@ -1837,7 +1837,7 @@ Specifies a value to be matched to the input parameter value. The matching is ca [[superelements-43]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#constraint-field[`constraint-field`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#constraint-field[`constraint-field`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-41]] === Subelements @@ -1883,7 +1883,7 @@ If you are setting up load balancing, web module context roots must be unique wi === Superelements xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#web[`web`] (`glassfish-application.xml`), -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#java-web-start-access[`java-web-start-access`] (`glassfish-application-client.xml`) [[subelements-42]] @@ -1902,7 +1902,7 @@ If cookie settings are defined programmatically using `jakarta.servlet.SessionCo [[superelements-45]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-config[`session-config`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-config[`session-config`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-43]] === Subelements @@ -1995,7 +1995,7 @@ Such object factories implement the `javax.naming.spi.ObjectFactory` interface. [[superelements-47]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-45]] === Subelements @@ -2079,7 +2079,7 @@ Specifies whether the debugging servlet is enabled for this web service endpoint [[superelements-49]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-47]] === Subelements @@ -2109,7 +2109,7 @@ Passes property values to the built-in `default` xref:Technical Documentation/Pa [[superelements-51]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache[`cache`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache[`cache`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-49]] === Subelements @@ -2158,7 +2158,7 @@ If this element is used in conjunction with a JMS Connection Factory resource, t [[superelements-52]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-ref[`resource-ref`] (`glassfish-web.xml` and `payara-web.xml`, +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-ref[`resource-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cmp-resource[`cmp-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#mdb-connection-factory[`mdb-connection-factory`] (`glassfish-ejb-jar.xml`) @@ -2193,7 +2193,7 @@ Specifies a text description of the containing element. === Superelements xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-attributes[`property` (with attributes)], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#valve[`valve`] -(`glassfish-web.xml` and `payara-web.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#activation-config[`activation-config`], +(`glassfish-web.xml` (deprecated) and `payara-web.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#activation-config[`activation-config`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#method[`method`] (`glassfish-ejb-jar.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#target-server[`target-server`] (`sun-acc.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#admin-object-resource[`admin-object-resource`], @@ -2202,7 +2202,7 @@ xref:Technical Documentation/Payara Server Documentation/Application Deployment/ xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#external-jndi-resource[`external-jndi-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#jdbc-connection-pool[`jdbc-connection-pool`], xref:jdbc-resource[`jdbc-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#mail-resource[`mail-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-attributes[`property` (with attributes)], -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-adapter-config[`resource-adapter-config`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-adapter-config[`resource-adapter-config`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-51]] === Subelements @@ -2239,7 +2239,7 @@ If this element is not specified, the default is `REQUEST`. See `6.2.5` of the S [[superelements-55]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-53]] === Subelements @@ -2506,7 +2506,7 @@ The `ejb-ref` element is used for the declaration of a reference to an EJB's hom [[superelements-59]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb[`ejb`] (`glassfish-ejb-jar.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-application-client[`glassfish-application-client`] (`glassfish-application-client.xml`) @@ -2538,7 +2538,7 @@ Specifies the `ejb-ref-name` in the corresponding Jakarta EE deployment descript [[superelements-60]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb-ref[`ejb-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb-ref[`ejb-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-58]] === Subelements @@ -2609,7 +2609,7 @@ If the web service endpoint is a servlet that implements only a single endpoint [[superelements-62]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-60]] === Subelements @@ -2834,7 +2834,7 @@ javax.naming.spi.InitialContextFactory interface. [[superelements-67]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-65]] === Subelements @@ -3341,7 +3341,7 @@ a| xref:Technical Documentation/Payara Server Documentation/Application Deployme [[glassfish-web-app]] == `glassfish-web-app` or `payara-web-app` -Defines Payara Server specific configuration for a web module. This is the root element; there can only be one `glassfish-web-app` element in a `glassfish-web.xml` and `payara-web.xml` file. +Defines Payara Server specific configuration for a web module. This is the root element; there can only be one `glassfish-web-app` element in a `glassfish-web.xml` (deprecated) and `payara-web.xml` file. See xref:Technical Documentation/Payara Server Documentation/Application Deployment/Deployment Descriptor Files.adoc#the-glassfish-web.xml-file[The glassfish-web.xml and payara-web.xml Files]. @@ -3620,7 +3620,7 @@ Maps an EIS group to a group defined in the Payara Server domain. [[superelements-77]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#work-security-map[`work-security-map`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#work-security-map[`work-security-map`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-75]] === Subelements @@ -3651,7 +3651,7 @@ Specifies a group name in the current realm. [[superelements-78]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-role-mapping[`security-role-mapping`] (`glassfish-application.xml`, `glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-role-mapping[`security-role-mapping`] (`glassfish-application.xml`, `glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-76]] === Subelements @@ -3666,7 +3666,7 @@ Specifies an HTTP method that is eligible for caching. The default is `GET`. [[superelements-79]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-77]] === Subelements @@ -3681,7 +3681,7 @@ Specifies a URL pattern for idempotent requests. [[superelements-80]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-78]] === Subelements @@ -3806,7 +3806,7 @@ Specifies a method. [[superelements-86]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message[`message`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message[`message`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-82]] === Subelements @@ -3911,7 +3911,7 @@ Defines the attributes and properties that are required for creating a JDBC conn [[superelements-88]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-84]] === Subelements @@ -4168,7 +4168,7 @@ Defines a JDBC (javax.sql.DataSource) resource. [[superelements-89]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-85]] === Subelements @@ -4264,7 +4264,7 @@ For more information about JMS resources, see "xref:Technical Documentation/Appl === Superelements xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb-ref[`ejb-ref`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-destination[`message-destination`], -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-env-ref[`resource-env-ref`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-ref[`resource-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-env-ref[`resource-env-ref`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-ref[`resource-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cmp-resource[`cmp-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb[`ejb`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#mdb-connection-factory[`mdb-connection-factory`] (`glassfish-ejb-jar.xml`) [[subelements-88]] @@ -4324,7 +4324,7 @@ Specifies JSP configuration information. [[superelements-94]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-90]] === Subelements @@ -4471,7 +4471,7 @@ If this element is not present, the web container uses the Servlet Path (the pat [[superelements-96]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-92]] === Subelements @@ -4553,7 +4553,7 @@ xref:Technical Documentation/Payara Server Documentation/Application Deployment/ [[superelements-100]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-96]] === Subelements @@ -4599,7 +4599,7 @@ For encodings, see `https://docs.oracle.com/javase/8/docs/technotes/guides/intl/ [[superelements-101]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#locale-charset-info[`locale-charset-info`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#locale-charset-info[`locale-charset-info`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-97]] === Subelements @@ -4661,7 +4661,7 @@ Specifies the local part of a QNAME. [[superelements-102]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-qname[`service-qname`],xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#wsdl-port[`wsdl-port`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-qname[`service-qname`],xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#wsdl-port[`wsdl-port`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-98]] === Subelements @@ -4744,7 +4744,7 @@ Specifies the authentication configuration for an EJB web service endpoint. Not [[superelements-106]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-101]] === Subelements @@ -4774,7 +4774,7 @@ Defines a Jakarta Mail (`jakarta.mail.Session`) resource. [[superelements-107]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-102]] === Subelements @@ -4861,6 +4861,9 @@ For example, to define the property `mail.password` in a Jakarta Mail Session ob ---- +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + After getting the Jakarta Mail `Session` object, get the `mail.password` property to retrieve the value `adminadmin`, as follows: [source, java] @@ -4883,7 +4886,7 @@ Specifies session manager properties. [[superelements-108]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-manager[`session-manager`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-manager[`session-manager`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-103]] === Subelements @@ -5093,7 +5096,7 @@ Specifies the methods or operations to which message security requirements apply [[superelements-115]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-security[`message-security`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-security[`message-security`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-108]] === Subelements @@ -5125,7 +5128,7 @@ Use when the message destination reference in the corresponding Jakarta EE deplo [[superelements-116]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#enterprise-beans[`enterprise-beans`] (`glassfish-ejb-jar.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-application-client[`glassfish-application-client`] (`glassfish-application-client.xml`) @@ -5157,7 +5160,7 @@ Specifies the name of a logical message destination defined within the correspon [[superelements-117]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-destination[`message-destination`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-destination[`message-destination`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-110]] === Subelements @@ -5173,7 +5176,7 @@ Use only when the message destination reference in the corresponding Jakarta EE [[superelements-118]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb[`ejb`] (`glassfish-ejb-jar.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-application-client[`glassfish-application-client`] (`glassfish-application-client.xml`) @@ -5205,7 +5208,7 @@ Specifies the name of a physical message destination defined within the correspo [[superelements-119]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-destination-ref[`message-destination-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-destination-ref[`message-destination-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-112]] === Subelements @@ -5223,7 +5226,7 @@ Specifies message security requirements. [[superelements-120]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-security-binding[`message-security-binding`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-security-binding[`message-security-binding`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-113]] === Subelements @@ -5260,7 +5263,7 @@ Specifies a custom authentication provider binding for a parent xref:Technical D [[superelements-121]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-114]] === Subelements @@ -5409,7 +5412,7 @@ Specifies a method name or `*` (an asterisk) for all methods. If a method is ove [[superelements-125]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#java-method[`java-method`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#finder[`finder`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#query-method[`query-method`] , xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#method[`method`] (`glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#java-method[`java-method`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#finder[`finder`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#query-method[`query-method`] , xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#method[`method`] (`glassfish-ejb-jar.xml`) [[subelements-118]] === Subelements @@ -5431,7 +5434,7 @@ Specifies the fully qualified Java type name of a method parameter. [[superelements-126]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#method-params[`method-params`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#method-params[`method-params`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-119]] === Subelements @@ -5446,7 +5449,7 @@ Specifies fully qualified Java type names of method parameters. [[superelements-127]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#java-method[`java-method`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#java-method[`java-method`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#query-method[`query-method`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#method[`method`] (`glassfish-ejb-jar.xml`) [[subelements-120]] @@ -5473,7 +5476,7 @@ Specifies the name of the entity. [[superelements-128]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#call-property[`call-property`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#default-resource-principal[`default-resource-principal`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#stub-property[`stub-property`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#enterprise-beans[`enterprise-beans`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#principal[`principal`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-subelements[`property` (with subelements)] (`glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#call-property[`call-property`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#default-resource-principal[`default-resource-principal`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#stub-property[`stub-property`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#enterprise-beans[`enterprise-beans`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#principal[`principal`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-subelements[`property` (with subelements)] (`glassfish-ejb-jar.xml`) [[subelements-121]] === Subelements @@ -5504,7 +5507,7 @@ Specifies the namespace URI. [[superelements-130]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-qname[`service-qname`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#wsdl-port[`wsdl-port`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-qname[`service-qname`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#wsdl-port[`wsdl-port`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-123]] === Subelements @@ -5560,7 +5563,7 @@ Specifies the WSDL name of an operation of a web service. [[superelements-133]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message[`message`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message[`message`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-126]] === Subelements @@ -5578,7 +5581,7 @@ For encodings, see `https://docs.oracle.com/javase/8/docs/technotes/guides/intl/ [[superelements-134]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#locale-charset-info[`locale-charset-info`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#locale-charset-info[`locale-charset-info`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-127]] === Subelements @@ -5645,7 +5648,7 @@ Specifies the password for the principal. [[superelements-136]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#default-resource-principal[`default-resource-principal`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#default-resource-principal[`default-resource-principal`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-129]] === Subelements @@ -5706,7 +5709,7 @@ Specifies a unique name for a port component within a web or EJB module. [[superelements-140]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-132]] === Subelements @@ -5727,7 +5730,7 @@ If a `service-endpoint-interface` is using container-managed port selection, its [[superelements-141]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-133]] === Subelements @@ -5796,7 +5799,7 @@ Defines a user name on the platform. === Superelements xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb[`ejb`] (`glassfish-ejb-jar.xml`); -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-map[`security-map`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-map[`security-map`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-135]] === Subelements @@ -5822,7 +5825,7 @@ Maps an EIS principal to a principal defined in the Payara Server domain. [[superelements-144]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#work-security-map[`work-security-map`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#work-security-map[`work-security-map`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-136]] === Subelements @@ -5855,7 +5858,7 @@ In an enterprise bean, specifies the principal username that has the `run-as` ro [[superelements-145]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-role-mapping[`security-role-mapping`] (`glassfish-application.xml`, `glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#servlet[`servlet`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-role-mapping[`security-role-mapping`] (`glassfish-application.xml`, `glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#servlet[`servlet`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-137]] === Subelements @@ -5892,7 +5895,7 @@ xref:Technical Documentation/Payara Server Documentation/Application Deployment/ xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#default-helper[`default-helper`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#manager-properties[`manager-properties`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-properties[`session-properties`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#store-properties[`store-properties`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#valve[`valve`], -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` and `payara-web.xml`); +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#auth-realm[`auth-realm`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#client-container[`client-container`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#client-credential[`client-credential`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#log-service[`log-service`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#provider-config[`provider-config`] (`sun-acc.xml`); @@ -5901,8 +5904,8 @@ xref:Technical Documentation/Payara Server Documentation/Application Deployment/ xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#connector-resource[`connector-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#custom-resource[`custom-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#external-jndi-resource[`external-jndi-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#jdbc-connection-pool[`jdbc-connection-pool`], xref:jdbc-resource[`jdbc-resource`], -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#mail-resource[`mail-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-adapter-config[`resource-adapter-config`] (`glassfish-resources.xml` and `payara-resources.xml`), -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`/`payara-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#mail-resource[`mail-resource`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-adapter-config[`resource-adapter-config`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`/`payara-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-138]] === Subelements @@ -6180,7 +6183,7 @@ Specifies a field that gives the application component a programmatic way to ref [[superelements-156]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-148]] === Subelements @@ -6316,7 +6319,7 @@ Defines the authentication policy requirements of the application's request proc [[superelements-162]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-security[`message-security`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-security[`message-security`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-154]] === Subelements @@ -6364,7 +6367,7 @@ The `res-ref-name` element specifies the name of a resource manager connection f [[superelements-164]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-ref[`resource-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-ref[`resource-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-156]] === Subelements @@ -6416,7 +6419,7 @@ Defines a connector (resource adapter) configuration. Stores configuration infor [[superelements-166]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-158]] === Subelements @@ -6488,7 +6491,7 @@ Maps the `res-ref-name` in the corresponding Jakarta EE deployment descriptor fi [[superelements-168]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb[`ejb`] (`glassfish-ejb-jar.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-application-client[`glassfish-application-client`] (`glassfish-application-client.xml`) @@ -6531,7 +6534,7 @@ Specifies the `res-ref-name` in the corresponding Jakarta EE deployment descript [[superelements-169]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-env-ref[`resource-env-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resource-env-ref[`resource-env-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-161]] === Subelements @@ -6551,7 +6554,7 @@ When `resource-ref` specifies a JMS connection factory for the Open Message Queu [[superelements-170]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb[`ejb`] (`glassfish-ejb-jar.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-application-client[`glassfish-application-client`] (`glassfish-application-client.xml`) @@ -6595,6 +6598,9 @@ a| xref:Technical Documentation/Payara Server Documentation/Application Deployme Defines application-scoped resources for an enterprise application, web module, EJB module, connector module, or application client module. This is the root element; there can only be one `resources` element in a `glassfish-resources.xml` or `payara-resources.xml` file. +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + See xref:Technical Documentation/Payara Server Documentation/Application Deployment/Deployment Descriptor Files.adoc#the-glassfish-resources.xml-file[The glassfish-resources.xml and payara-resources Files]. NOTE: You must specify a Java Naming and Directory Interface (JNDI) name for each resource. To avoid collisions with names of other enterprise resources in JNDI, and to avoid portability problems, all names in a Payara Server application should begin with the string `java:app/`. @@ -6697,7 +6703,7 @@ Defines the authentication policy requirements of the application's response pro [[superelements-173]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-security[`message-security`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#message-security[`message-security`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-165]] === Subelements @@ -6728,7 +6734,7 @@ Contains the `role-name` in the `security-role` element of the corresponding Jak [[superelements-174]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-role-mapping[`security-role-mapping`] (`glassfish-application.xml`, `glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-role-mapping[`security-role-mapping`] (`glassfish-application.xml`, `glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-166]] === Subelements @@ -6783,7 +6789,7 @@ In the above example, all JARs will be excluded by default, then all JARs beginn === Superelements xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-application[`glassfish-application`] (`glassfish-application.xml`), -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-167]] === Subelements @@ -6977,7 +6983,7 @@ This is different from a xref:Technical Documentation/Payara Server Documentatio [[superelements-180]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#connector-connection-pool[`connector-connection-pool`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#connector-connection-pool[`connector-connection-pool`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-172]] === Subelements @@ -7031,7 +7037,7 @@ To be useful, there must be at least one user in that realm who belongs to that === Superelements xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-application[`glassfish-application`] (`glassfish-application.xml`), -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-ejb-jar[`glassfish-ejb-jar`] (`glassfish-ejb-jar.xml`) [[subelements-173]] @@ -7066,7 +7072,7 @@ Specifies the web service reference name relative to `java:comp/env`. [[superelements-182]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-174]] === Subelements @@ -7081,7 +7087,7 @@ Specifies the name of the generated service implementation class. [[superelements-183]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-175]] === Subelements @@ -7096,8 +7102,8 @@ Specifies the WSDL service element that is being referred to. [[superelements-184]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-176]] === Subelements @@ -7131,7 +7137,7 @@ Specifies runtime settings for a web service reference. Runtime information is o [[superelements-185]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb[`ejb`] (`glassfish-ejb-jar.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-application-client[`glassfish-application-client`] (`glassfish-application-client.xml`) @@ -7179,7 +7185,7 @@ Specifies the web service reference name relative to `java:comp/env`. [[superelements-186]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-178]] === Subelements @@ -7194,7 +7200,7 @@ Specifies a principal name for a servlet. Used for the `run-as` role defined in [[superelements-187]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-179]] === Subelements @@ -7228,7 +7234,7 @@ Specifies the automatically generated name of the servlet implementation class. [[superelements-188]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-180]] === Subelements @@ -7243,7 +7249,7 @@ Specifies the name of a servlet, which is matched to a `servlet-name` in `web.xm [[superelements-189]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#servlet[`servlet`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#servlet[`servlet`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-181]] === Subelements @@ -7258,7 +7264,7 @@ Specifies session configuration information. Overrides the web container setting [[superelements-190]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-182]] === Subelements @@ -7292,7 +7298,7 @@ Specifies session manager information. [[superelements-191]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-config[`session-config`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-config[`session-config`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-183]] === Subelements @@ -7337,7 +7343,7 @@ Specifies session properties. [[superelements-192]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-config[`session-config`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-config[`session-config`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-184]] === Subelements @@ -7450,7 +7456,7 @@ Specifies session persistence (storage) properties. [[superelements-195]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-manager[`session-manager`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#session-manager[`session-manager`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-187]] === Subelements @@ -7511,7 +7517,7 @@ Specifies JAX-RPC property values that are set on a `javax.xml.rpc.Stub` object [[superelements-196]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-188]] === Subelements @@ -7709,7 +7715,7 @@ Specifies the automatically generated name of a tie implementation class for a p [[superelements-201]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-193]] === Subelements @@ -7725,7 +7731,7 @@ If not specified, the default is the value of the `timeout` attribute of the xre [[superelements-202]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-194]] === Subelements @@ -7801,7 +7807,7 @@ In most cases, a value of `INTEGRAL` or `CONFIDENTIAL` indicates that the use of [[superelements-204]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-endpoint[`webservice-endpoint`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-196]] === Subelements @@ -7832,7 +7838,7 @@ Specifies a servlet URL pattern for which caching is enabled. See the Servlet 6. [[superelements-206]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#cache-mapping[`cache-mapping`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-198]] === Subelements @@ -7847,7 +7853,7 @@ Contains the group to which the principal belongs. [[superelements-207]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-map[`security-map`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#security-map[`security-map`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-199]] === Subelements @@ -7877,7 +7883,7 @@ Specifies the value of the entity. [[superelements-209]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#call-property[`call-property`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#stub-property[`stub-property`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-subelements[`property` (with subelements)] (`glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#call-property[`call-property`], xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#stub-property[`stub-property`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`); xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-subelements[`property` (with subelements)] (`glassfish-ejb-jar.xml`) [[subelements-201]] === Subelements @@ -7893,7 +7899,7 @@ Specifies a custom valve for this web application. You can define a valve for al [[superelements-210]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) [[subelements-202]] Subelements @@ -8184,7 +8190,7 @@ Specifies a name and optional publish location for a web service. [[superelements-216]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` and `payara-web.xml`), +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#glassfish-web-app[`glassfish-web-app`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#enterprise-beans[`enterprise-beans`] (`glassfish-ejb-jar.xml`) [[subelements-208]] @@ -8215,7 +8221,7 @@ Specifies a unique name for the web service within a web or EJB module. [[superelements-217]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-description[`webservice-description`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-description[`webservice-description`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-209]] === Subelements @@ -8230,7 +8236,7 @@ Specifies information about a web service endpoint. [[superelements-218]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#servlet[`servlet`] (`glassfish-web.xml` and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb[`ejb`] (`glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#servlet[`servlet`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`), xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#ejb[`ejb`] (`glassfish-ejb-jar.xml`) [[subelements-210]] === Subelements @@ -8278,7 +8284,7 @@ a| xref:Technical Documentation/Payara Server Documentation/Application Deployme |zero or one |Specifies whether the debugging servlet is enabled for this web service endpoint. Allowed values are `true` and `false` (the default). -a| xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-attributes[`property` (with attributes)] (`glassfish-web.xml` and `payara-web.xml`) xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-subelements[`property` (with subelements)] (`glassfish-ejb-jar.xml`) +a| xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-attributes[`property` (with attributes)] (`glassfish-web.xml` (deprecated) and `payara-web.xml`) xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#property-with-subelements[`property` (with subelements)] (`glassfish-ejb-jar.xml`) |zero or more |Specifies a property, which has a name and a value. @@ -8313,7 +8319,7 @@ This is different from a xref:Technical Documentation/Payara Server Documentatio [[superelements-219-2]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` and `payara-resources.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#resources[`resources`] (`glassfish-resources.xml` (deprecated) and `payara-resources.xml`) [[subelements-211]] === Subelements @@ -8363,7 +8369,7 @@ Specifies a valid URL pointing to a final WSDL document. If not specified, the W [[superelements-220]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#service-ref[`service-ref`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-212]] === Subelements @@ -8393,7 +8399,7 @@ Specifies the WSDL port. [[superelements-221]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#port-info[`port-info`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`, `glassfish-application-client.xml`) [[subelements-213]] === Subelements @@ -8424,7 +8430,7 @@ Any required files are published to this directory, preserving their location re [[superelements-222]] === Superelements -xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-description[`webservice-description`] (`glassfish-web.xml` and `payara-web.xml`, `glassfish-ejb-jar.xml`) +xref:Technical Documentation/Payara Server Documentation/Application Deployment/Elements of Deployment Descriptors.adoc#webservice-description[`webservice-description`] (`glassfish-web.xml` (deprecated) and `payara-web.xml`, `glassfish-ejb-jar.xml`) [[subelements-214-1]] === Subelements diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/create-virtual-server.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/create-virtual-server.adoc index 1b7e26073..e9ea7a52b 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/create-virtual-server.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/create-virtual-server.adoc @@ -74,6 +74,10 @@ asadmin-options:: ---- + +IMPORTANT: sun-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + The default value is `true`. `accessLogWriteInterval`;; diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploy-remote-archive.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploy-remote-archive.adoc index 6083555b2..3acd9869a 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploy-remote-archive.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploy-remote-archive.adoc @@ -103,7 +103,7 @@ asadmin-options:: `--altdd`:: Deploys the application using a Jakarta EE standard deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--altdd` option overrides `application.xml`. For a standalone module, the `--altdd` option overrides the top-level module descriptor such as `web.xml`. `--runtimealtdd`:: - Deploys the application using a Payara Server runtime deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--runtimealtdd` option overrides `glassfish-application.xml`. For a standalone module, the `--runtimealtdd` option overrides the top-level module descriptor such as `glassfish-web.xml` or `payara-web.xml`. Applies to Payara Server deployment descriptors only (`glassfish-*.xml`/`payara-*.xml`); the name of the alternate deployment descriptor file must begin with `glassfish-` (or `payara-` in specific cases). Does not apply to `sun-*.xml` deployment descriptors, which are deprecated. + Deploys the application using a Payara Server runtime deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--runtimealtdd` option overrides `glassfish-application.xml`. For a standalone module, the `--runtimealtdd` option overrides the top-level module descriptor such as `glassfish-web.xml` (deprecated) or `payara-web.xml`. Applies to Payara Server deployment descriptors only (`glassfish-*.xml`/`payara-*.xml`); the name of the alternate deployment descriptor file must begin with `glassfish-` (or `payara-` in specific cases). Does not apply to `sun-*.xml` deployment descriptors, which are deprecated. `--deploymentorder`:: Specifies the deployment order of the application. This is useful if the application has dependencies and must be loaded in a certain order at server startup. The deployment order is specified as an integer. The default value is 100. Applications with lower numbers are loaded before applications with higher numbers. For example, an application with a deployment order of 102 is loaded before an application with a deployment order of 110. If a deployment order is not specified, the default value of 100 is assigned. If two applications have the same deployment order, the first application to be deployed is the first application to be loaded at server startup. + The deployment order is typically specified when the application is first deployed but can also be specified or changed after initial deployment using the `set` subcommand. You can view the deployment order of an application using the `get` subcommand. diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploy.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploy.adoc index 18d5b6ef8..85b7170eb 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploy.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploy.adoc @@ -101,7 +101,7 @@ asadmin-options:: `--altdd`:: Deploys the application using a Jakarta EE standard deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--altdd` option overrides `application.xml`. For a standalone module, the `--altdd` option overrides the top-level module descriptor such as `web.xml`. `--runtimealtdd`:: - Deploys the application using a Payara Server runtime deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--runtimealtdd` option overrides `glassfish-application.xml`. For a standalone module, the `--runtimealtdd` option overrides the top-level module descriptor such as `glassfish-web.xml` or `payara-web.xml`. Applies to Payara Server deployment descriptors only (`glassfish-*.xml`/`payara-*.xml`); the name of the alternate deployment descriptor file must begin with `glassfish-` (or `payara-` in specific cases). Does not apply to `sun-*.xml` deployment descriptors, which are deprecated. + Deploys the application using a Payara Server runtime deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--runtimealtdd` option overrides `glassfish-application.xml`. For a standalone module, the `--runtimealtdd` option overrides the top-level module descriptor such as `glassfish-web.xml` (deprecated) or `payara-web.xml`. Applies to Payara Server deployment descriptors only (`glassfish-*.xml`/`payara-*.xml`); the name of the alternate deployment descriptor file must begin with `glassfish-` (or `payara-` in specific cases). Does not apply to `sun-*.xml` deployment descriptors, which are deprecated. `--deploymentorder`:: Specifies the deployment order of the application. This is useful if the application has dependencies and must be loaded in a certain order at server startup. The deployment order is specified as an integer. The default value is 100. Applications with lower numbers are loaded before applications with higher numbers. For example, an application with a deployment order of 102 is loaded before an application with a deployment order of 110. If a deployment order is not specified, the default value of 100 is assigned. If two applications have the same deployment order, the first application to be deployed is the first application to be loaded at server startup. + The deployment order is typically specified when the application is first deployed but can also be specified or changed after initial deployment using the `set` subcommand. You can view the deployment order of an application using the `get` subcommand. diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploydir.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploydir.adoc index 0de704ab7..6872f0436 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploydir.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/deploydir.adoc @@ -92,7 +92,7 @@ asadmin-options:: `--altdd`:: Deploys the application using a Jakarta EE standard deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--altdd` option overrides `application.xml`. For a standalone module, the `--altdd` option overrides the top-level module descriptor such as `web.xml`. `--runtimealtdd`:: - Deploys the application using a Payara Server runtime deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--runtimealtdd` option overrides `glassfish-application.xml`. For a standalone module, the `--runtimealtdd` option overrides the top-level module descriptor such as `glassfish-web.xml` or `payara-web.xml`. Applies to Payara Server deployment descriptors only (`glassfish-*.xml`/`payara-*.xml`); the name of the alternate deployment descriptor file must begin with `glassfish-` (or `payara-` in specific cases). Does not apply to `sun-*.xml` deployment descriptors, which are deprecated. + Deploys the application using a Payara Server runtime deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--runtimealtdd` option overrides `glassfish-application.xml`. For a standalone module, the `--runtimealtdd` option overrides the top-level module descriptor such as `glassfish-web.xml` (deprecated) or `payara-web.xml`. Applies to Payara Server deployment descriptors only (`glassfish-*.xml`/`payara-*.xml`); the name of the alternate deployment descriptor file must begin with `glassfish-` (or `payara-` in specific cases). Does not apply to `sun-*.xml` deployment descriptors, which are deprecated. `--deploymentorder`:: Specifies the deployment order of the application. This is useful if the application has dependencies and must be loaded in a certain order at server startup. The deployment order is specified as an integer. The default value is 100. Applications with lower numbers are loaded before applications with higher numbers. For example, an application with a deployment order of 102 is loaded before an application with a deployment order of 110. If a deployment order is not specified, the default value of 100 is assigned. If two applications have the same deployment order, the first application to be deployed is the first application to be loaded at server startup. + The deployment order is typically specified when the application is first deployed but can also be specified or changed after initial deployment using the `set` subcommand. You can view the deployment order of an application using the `get` subcommand diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/flush-connection-pool.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/flush-connection-pool.adoc index 52221aceb..daa43ce2b 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/flush-connection-pool.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/flush-connection-pool.adoc @@ -24,6 +24,9 @@ Application Scoped Resources The `flush-connection-pool` subcommand can target resources that are scoped to a specific application or module, as defined in the `glassfish-resources.xml` or `payara-resources.xml` for the Payara Server domain. +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + * To reference the `jndi-name` for an application scoped resource, perform the lookup using the `java:app` prefix. * To reference the `jndi-name` for a module scoped resource, perform the lookup using the `java:module` prefix. diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/ping-connection-pool.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/ping-connection-pool.adoc index 6253d132b..a337b95de 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/ping-connection-pool.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/ping-connection-pool.adoc @@ -28,6 +28,9 @@ Application Scoped Resources The `ping-connection-pool` subcommand can target resources that are scoped to a specific application or module, as defined in the `glassfish-resources.xml` or `payara-resources.xml` for the Payara Server domain. +IMPORTANT: glassfish-resources.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-resources.xml instead. + * To reference the `jndi-name` for an application scoped resource, perform the lookup using the `java:app` prefix. * To reference the `jndi-name` for a module scoped resource, perform the lookup using the `java:module` prefix. diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/redeploy.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/redeploy.adoc index af12a06f2..f6c8d8a52 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/redeploy.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Command Reference/redeploy.adoc @@ -116,7 +116,7 @@ asadmin-options:: descriptor packaged in the archive. For example, for an EAR, the `--altdd` option overrides `application.xml`. For a standalone module, the `--altdd` option overrides the top-level module descriptor such as `web.xml`. -`-runtimealtdd`:: - Deploys the application using a Payara Server runtime deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--runtimealtdd` option overrides `glassfish-application.xml`. For a standalone module, the `--runtimealtdd` option overrides the top-level module descriptor such as `glassfish-web.xml` or `payara-web.xml`. Applies to Payara Server deployment descriptors only (`glassfish-*.xml`/`payara-*.xml`); the name of the alternate + Deploys the application using a Payara Server runtime deployment descriptor that resides outside of the application archive. Specify an absolute path or a relative path to the alternate deployment descriptor file. The alternate deployment descriptor overrides the top-level deployment descriptor packaged in the archive. For example, for an EAR, the `--runtimealtdd` option overrides `glassfish-application.xml`. For a standalone module, the `--runtimealtdd` option overrides the top-level module descriptor such as `glassfish-web.xml` (deprecated) or `payara-web.xml`. Applies to Payara Server deployment descriptors only (`glassfish-*.xml`/`payara-*.xml`); the name of the alternate deployment descriptor file must begin with `glassfish-` (or `payara-` in specific cases). Does not apply to `sun-*.xml` deployment descriptors, which are deprecated. `--deploymentorder`:: Specifies the deployment order of the application. This is useful if the application has dependencies and must be loaded in a certain order diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Administering HTTP Connectivity.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Administering HTTP Connectivity.adoc index e2db683e1..6d2ad0e75 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Administering HTTP Connectivity.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Administering HTTP Connectivity.adoc @@ -1066,11 +1066,14 @@ Can be overridden for an individual application in the `glassfish-web.xml`/`paya [source, xml] ---- - + - + ---- +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + NOTE: Setting this property to `true` on Windows systems exposes JSP source code. | false | *accessLogWriteInterval* | The number of seconds between each time the log is written to disk. The access log is written when the buffer is full or when the interval expires. If the value is 0, the buffer is always written even if it's not full. | 300 diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Administering Web Applications.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Administering Web Applications.adoc index 64fd8a27b..2a56b91b8 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Administering Web Applications.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Administering Web Applications.adoc @@ -25,7 +25,7 @@ http://server:port/context-root/servlet-mapping?name=value | The IP address (or host name) and optional port number. To access the default web module for a virtual server, specify only this URL section. You do not need to specify the context-root or servlet-name unless you also wish to specify name-value parameters. | context-root -| For an application, the context root is defined in the `context-root` element of the `application.xml`, `sun-application.xml`, or `sun-web.xml` file. For an individually deployed web module, the context root is specified during deployment. For both applications and individually deployed web modules, the default context root is the name of the WAR file minus the `.war` suffix. +| For an application, the context root is defined in the `context-root` element of the `application.xml`, `sun-application.xml`, or `payara-web.xml`/`sun-web.xml` (deprecated) file. For an individually deployed web module, the context root is specified during deployment. For both applications and individually deployed web modules, the default context root is the name of the WAR file minus the `.war` suffix. | servlet-mapping | The `servlet-mapping` as configured in the `web.xml` file. diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Configuration Variables Reference.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Configuration Variables Reference.adoc index 4dcbf8276..51e7213c0 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Configuration Variables Reference.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/General Administration/Configuration Variables Reference.adoc @@ -79,10 +79,10 @@ Variable references can be used inside text values in the following configuratio Variable references can be used inside text values also in the following places within deployed applications and modules: * Package descriptors: -** web.xml / glassfish-web.xml +** web.xml / payara-web.xml / glassfish-web.xml (deprecated) ** ejb-jar.xml / glassfish-ejb-jar.xml ** application.xml / glassfish-application.xml -** glassfish-resources.xml +** payara-resources.xml / glassfish-resources.xml (deprecated) * Framework descriptors: ** persistence.xml ** faces-config.xml diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/High Availability/Configuring HA Session Persistence and Failover.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/High Availability/Configuring HA Session Persistence and Failover.adoc index b2f9bb845..cd67a6d41 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/High Availability/Configuring HA Session Persistence and Failover.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/High Availability/Configuring HA Session Persistence and Failover.adoc @@ -221,6 +221,9 @@ It must be set to `hazelcast` (as this is the default persistence mode) to enabl ---- +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + [[configuring-replication-and-multi-threaded-concurrent-access-to-httpsessions]] === Configuring DataGrid Replication and Multi-Threaded Concurrent Access to `HttpSessions` @@ -235,6 +238,9 @@ In these situations, most browsers will optimize the loading of these resources The solution in such cases is to use the `relaxVersionSemantics` property in the `glassfish-web.xml` or `payara-web.xml` deployment descriptor file for the application. +IMPORTANT: glassfish-web.xml is deprecated and support will be removed in Payara 7. +It is recommended to use payara-web.xml instead. + This enables the web container to return for each requesting thread whatever version of the session that is in the active cache regardless of the version number. This is critical when multiple threads are interacting in an essentially non-deterministic fashion with the container. diff --git a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Security Guide/Administering Message Security.adoc b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Security Guide/Administering Message Security.adoc index 7c5573ad2..23db84e64 100644 --- a/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Security Guide/Administering Message Security.adoc +++ b/docs/modules/ROOT/pages/Technical Documentation/Payara Server Documentation/Security Guide/Administering Message Security.adoc @@ -423,7 +423,7 @@ You can configure a Jakarta Authentication Server Authentication Module (SAM) as . Create the message security provider by using the xref:Technical Documentation/Payara Server Documentation/Command Reference/create-message-security-provider.adoc#create-message-security-provider[`create-message-security-provider`] subcommand. . Bind the message security provider for use with your application. + -You do this by defining the `httpservlet-security-provider` attribute in the `glassfish-web.xml` or `payara-web.xml` deployment descriptor corresponding to your application. +You do this by defining the `httpservlet-security-provider` attribute in the `glassfish-web.xml` (deprecated) or `payara-web.xml` deployment descriptor corresponding to your application. + Set the value of the attribute to the provider name you assigned to the message security provider. For example, if you use MySAM when you create the message security provider the entry would be `httpservlet-security-provider="MySAM"`. . Restart the server instance.