Requirements
- GlassFish 3.1.2 (GlassFish 4 is NOT supported at this time)
- 4GB of RAM
- 1 CPU
- JDK – refer to 3.1.2 Certification Matrix
GlassFish Setup
If FlexDeploy is being installed for first time, setup GlassFish server and Data Source as explained in following steps.
Install GlassFish
- Download Glassfish 3.1.2 from this link: http://www.oracle.com/technetwork/middleware/glassfish/downloads/index.html
- Install a supported version of the JDK following the install procedures provided with the JDK
- Set the JAVA_HOME to the location the JDK was install into
- Launcher the installer using a utility like vnc (change
$JAVA_HOME
to JDK install location):
./glassfish-3.1.2.2-unix.sh -j $JAVA_HOME
- Follow the install dialog to complete the base GlassFish install
- When prompted, recommend setting DOMAIN NAME to fddomain
Install ADF Essentials
- Download the ADF Essentials 12.1.3 from this link - http://www.oracle.com/technetwork/developer-tools/adf/downloads/index.html
- Unzip the file to a temporary location: unzip -j adf-essentials.zip -d /oracle/adf
- Copy all of the files from /oracle/adf to the
$GLASSFISH_HOME
/glassfish/domains/$DOMAINNAME
/lib directory. - From the extracted zip directory, navigate to the GlassFish directory and locate these directories:
- lib
- modules
- Copy the files (do not copy the lib folder itself) in the lib directory to
$GLASSFISH_HOME
/glassfish/domains/$DOMAINNAME
/lib - Copy the files (do not copy the modules folder itself) in modules directory to
$GLASSFISH_HOME
/glassfish/modules
Configure GlassFish Server
- Start glassfish:
- cd
$GLASSFISH_HOME
/glassfish/bin - asadmin
- start-domain
$DOMAIN_NAME
- Set GLASSFISH_HOME to the install location of glassfish
- Set DOMAIN_NAME to the name of your domain (like fddomain)
- Login into GlassFish Administration Console (http://hostname:4848)
- Create Data Source
- Go to Resources – JDBC - JDBC Connection Pools
- Set following values, then next
- Pool Name: FlexDBDSPool
- Resource Type: javax.sql.DataSource
- Database Driver Vendor: Oracle
- Scroll down to properties
- Set the following values, then Save
- Name: URL Value: jdbc URL for database
- Name: User Value: fd_admin
- Name: PasswordValue: <password for fd_admin>
- Go to General tab and then Save
- Go to Resources – JDBC - JDBC Resources
- Set following values, then Save
- JNDI Name: jdbc/flexdbDS
- Pool Name: FlexDBDSPool
- Add the following options JVM arguments on the server (click on Configurations, server-config, JVM Settings, JVM Options)
-verbose:gc -Xms1024m -Xmx2048m -Dflexagon.fd.install.root=/opt/flexdeploy/application -Dflexagon.fd.repository.root=/opt/flexdeploy/repository -Doracle.jdbc.autoCommitSpecCompliant=false -Doracle.mds.cache=simple
Please make sure to modify the arguments for Server working directory (-Dflexagon.fd.install.root) and Artifacts repository (-Dflexagon.fd.repository.root) as per your installation.
NOTE: be careful in copying arguments due to potential character changes.
- Setup Logger Configurations.
- From the extracted zip directory, navigate to the GlassFish directory and locate this file:
- FDGlassFishLogFormatter.jar
- Copy the FDGlassFishLogFormatter.jar to the lib sub-directory of the domain.
EAR installation
From the extracted directory, navigate to the GlassFish directory. The ear will be located in this directory.
Install the EAR:
- Login into GlassFish Administration Console
- http://<hostname>:4848
- Click on Applications.
- If FlexDeploy_GlassFish_[version] is already installed.
- Select the FlexDeploy_GlassFish_[version].
- Click on Undeploy and click on OK.
- Click on Applications and then click Deploy.
- Click on Choose File.
- Find your downloaded EAR file and select it.
- Click OK, EAR will be installed.
- Recycle the GlassFish server.
- Go to server (Admin Server).
- Click Restart and OK.