This appendix contains the following sections:
GlassFish Server is an application server that can be configured to run Oracle ADF applications. You can use JDeveloper to deploy ADF applications directly to the GlassFish Server, or indirectly to an archive file as the deployment target, and then install this archive file to the target GlassFish Server.
If you do not have a GlassFish Server installation, you can download GlassFish Server from the web. Before you can run ADF applications in a GlassFish Server, you need to configure GlassFish with the Oracle ADF Runtime libraries.
For a list of the supported Oracle ADF features for GlassFish, go to the Oracle Technology Network (OTN) site at
For information about the GlassFish Server version supported by JDeveloper and ADF, see the Certification Information link for your JDeveloper release on OTN at
For instructions on obtaining and installing GlassFish, see
For information about developing ADF applications for GlassFish, see the Deploying ADF Applications to GlassFish appendix in the Developing Fusion Web Applications with Oracle Application Development Framework.
For a GlassFish Server to support Oracle ADF features, you must install Oracle ADF Essentials and ADF runtime libraries.
Oracle ADF Essentials supports the Open Source and commercial versions of GlassFish Server. With either version, you will need the Full Platform distribution. The Web Profile distribution is not supported. After you have installed the GlassFish Server, you need to obtain the ADF Essentials
adf-essentials.zip file from OTN and follow the instructions in this appendix to install the ADF Runtime libraries.
For information on how to start and stop the server and other application server tasks, see GlassFish documentation at the GlassFish website.
You will need to perform the following tasks, as described in the following topics:
You can download the open source version of the GlassFish Server from the GlassFish website:
You must download Java EE 7 Full Platform (not Java EE 7 Web Profile) since it includes enterprise class features like JMS.
Follow the instructions and documentation at the GlassFish site to install and configure a GlassFish Server.
Before installing ADF Essentials, your installation of GlassFish Server at
/glassfish–4.1/glassfish/modules/javax.el.jar must be patched with
javax.el–3.0.1-b08.jar available for download from a Java repository, such as
In order for a GlassFish Server to run Oracle ADF applications, you must install the ADF Runtime library files into the GlassFish installation directory.
You can download the Oracle ADF Essentials
adf-essentials.zip file from the Oracle Technology Network at
After you have downloaded the
adf-essentials.zip file, you can extract the files to a flat-structured temporary directory which you can use to copy the required files into the GlassFish installation directories.
For instance, if you are using
unzip, you can add the
-j option to create a flat directory structure that has no hierarchical folders.
unzip -j <file> -d <destination>
GlassFish Server can be configured to run Oracle ADF applications. Before you can run ADF applications on a GlassFish Server, you need to configure GlassFish with the Oracle ADF Runtime libraries.
The ADF Runtime libraries consists of the following:
ADF Share libraries
ADF Certified Compatible JSF Implementation
ADF Model libraries
ADF Controller libraries
ADF View libraries
The ADF Share libraries and ADF Certified Compatible JSF Implementation must be manually installed into the GlassFish installation. You use your operating system commands or tools to copy the files into GlassFish. For instructions, see Installing ADF Share Libraries Manually.
The ADF Model, ADF Controller, and ADF View libraries are loaded into GlassFish with the deployed application. When you use JDeveloper to develop the application, you will reference the required libraries before you package the application into an EAR file for deployment.
The steps for installing the ADF Runtime libraries are:
Copy the ADF Share libraries from
adf-essentials.zip into the GlassFish installation.
It may be helpful to have an understanding of the options that are available to you when you are mapping ADF Share for GlassFish. For more information, see Configuring GlassFish with ADF Runtime Libraries.
You will need to complete these tasks:
Install the GlassFish Server
adf-essentials.zip file and unzip it to a temporary directory
Obtain the ADF Certified Compatible JSF implementation version 2.2.8-11 from Maven Central at https://repo.maven.apache.org/maven2/org/glassfish/javax.faces/2.2.8-11/javax.faces-2.2.8-11.jar
To install the ADF Share Runtime libraries:
Copy or move the ADF Share library files from the temporary directory to the
The ADF Share files should be in the temporary directory where you had unzip the
adf-essentials.zip file as described in Obtaining Oracle ADF Runtime This directory should be
You must copy the following JAR files into the
oracle.adf.share.ca_12.2.1/adf-share-base.jar oracle.adf.share.ca_12.2.1/adf-share-ca.jar oracle.adf.share_12.2.1/commons-el.jar oracle.adf.share_12.2.1/adf-share-support.jar oracle.adf.share_12.2.1/adfsharembean.jar oracle.adf.share_12.2.1/jsp-el-api.jar oracle.adf.share_12.2.1/adflogginghandler.jar oracle.adf.share_12.2.1/oracle-el.jar oracle.mds_12.2.1/mdsrt.jar oracle.bali.share_12.2.1/share.jar oracle.xmlef_12.2.1/xmlef.jar oracle.javatools_12.2.1/resourcebundle.jar oracle.javatools_12.2.1/javamodel-rt.jar oracle.javatools_12.2.1/javatools-nodeps.jar oracle.javatools_12.2.1/oicons.jar oracle.adf.security_12.2.1/adf-share-security.jar oracle.adf.security_12.2.1/adf-controller-security.jar oracle.xdk_12.2.1/xmlparserv2_sans_jaxp_services.jar oracle.xdb_11.1.0.jar oracle.jrf_12.2.1/jrf-api.jar oracle.jdbc_11.2/ojdbc6dms.jar oracle.dms_12.2.1/dms.jar oracle.odl_12.2.1/ojdl.jar oracle.odl_12.2.1/ojdl2.jar oracle.classloader_11.1.1.jar oracle.logging-utils_11.1.1.jar oracle.web-common_12.2.1.jar org.apache.bcel_5.1.jar oracle.nlsrtl_11.2.0/orai18n-mapping.jar org.apache.commons.beanutils_1.8.3 org.apache.commons.logging_1.1.1 oracle.jsp_12.2.1/globaltldcache oracle.mds_12.2.1/mdsrt com.oracle.webservices.fmw.oc4j-ws-support-impl_12.2.1 oracle.http_client_12.2.1 oracle.web-common_12.2.1 oracle.web-common-schemas_12.2.1
Verify the libraries.
To install the ADF Certified Compatible JSF Implementation:
javax.faces-2.2.8-11.jarfile from Maven Central.
glassfish4/glassfish/modules/directory to overwrite the
javax.faces.jarfile in the target directory.
The ADF Certified Compatible JSF Implementation is backward compatible with the one which is already present in GlassFish 4.1.
GlassFish Server can be configured to create a datasource and JVM cache after the installation of ADF runtime libraries. Use the GlassFish Server Administration Console to perform the additional configuration tasks.
After you have installed the ADF Runtime into the GlassFish Server, you need to perform additional configuration tasks on GlassFish.
The configuration tasks are:
You can use the GlassFish Administration Console to configure the GlassFish Server including managing applications, JDBC pools, and other resources. If you are using GlassFish 3.1.2, the secure console is disabled by default. You would need to enable secure console to access the admin page remotely or only access the page from the same machine where the GlassFish server is running.
The GlassFish Administration Console is at:
It may be helpful to have an understanding of the options that are available to you when you are creating a datasource for GlassFish. For more information, see Additional Configuration Tasks.
You can use the GlassFish console or use asadmin commands to create the datasource. For using the GlassFish console to create a datasource, see GlassFish documentation.
To create a datasource for GlassFish using asadmin commands:
asadmincommand to create a datasource for GlassFish.
For instance, the following command creates a datasource for an application:
asadmin> create-jdbc-connection-pool --datasourceclassname oracle.jdbc.pool.SampleDataSource --restype javax.sql.XADataSource --property user=xyz :password=xyz:url=jdbc:oracle:thin:@machine.com:1521:machine --target=server SampleDSPool asadmin> ping-connection-pool sampleDSPool asadmin> create-jdbc-resource --connectionpoolid SampleDSPool jdbc/OracleDS
You need to configure the JVM settings to
simple and increase the memory size from 192 Mb to 512 Mb.
It may be helpful to have an understanding of the options that are available to you when you are configuring JVM for GlassFish. For more information, see Additional Configuration Tasks.
To configure JVM Cache for MDS:
Start the GlassFish Administration Console.
Choose Configurations > server-config > JVM Settings.
Select JVM Options and specify
Or, open the
/domains/domain1/config/domain.xml file and edit the following entries:
You can deploy an ADF application to a GlassFish Server after you have referenced the libraries in the application.
For more information, see the Deploying ADF Applications to GlassFish appendix in the Developing Fusion Web Applications with Oracle Application Development Framework.