...

• • Extract zip files in flat structure using unzip -j (works on Windows and UNIX)
    • cd <TOMCAT_HOME>/lib
    • unzip -j <path to temp folder>/adf-essentials.zip
    • unzip -j <path to temp folder>/adf-essentials-client-ear.zip
  • You should see a large number of jars now in the tomcat/lib folder.
  • ADF Essentials comes with the JDBC driver for Oracle 11g database (ojdbc6dms.jar).  If you are using Oracle 12c database, you can download the driver from the Oracle Technology Network site.
    • Oracle 12c drivers

      
      

      Note

      If adding another JDBC driver, be sure to remove the default one which comes with the ADF Essentials libraries (ojdbc6dms.jar).  If you leave multiple JDBC drivers in the lib folder, you could encounter the following exception on startup: java.lang.SecurityException: sealing violation: package oracle.jdbc is sealed                 at java.net.URLClassLoader.getAndVerifyPackage(Unknown Source)                 at java.net.URLClassLoader.definePackageInternal(Unknown Source)                 at java.net.URLClassLoader.defineClass(Unknown Source)                 at java.net.URLClassLoader.access$100(Unknown Source)                 at java.net.URLClassLoader$1.run(Unknown Source)

      
      

• Copy the jars with the following names from the Tomcat_Complete.zip /apache-tomcat-flexdeploy/lib folder and place them in <TOMCAT_HOME>/lib as well.
  • jta-1.1.jar
  • jackson-core-lgpl-1.9.13.jar
  • jersey-bundle-1.18.jar
  • asm-3.3.1.jar
  • mail-1.4.7.jar
  • ant-salesforce.jar - If you will be using the Salesforce integration.

• If using IBM ClearCase, you will need to copy some jar files from your ClearCase server or ClearTeam Explorer installation to the FlexDeploy installation
  • Copy all of the jar files found in the com.ibm.rational.teamapi_8.0.1.vxxx folder of your ClearCase server or ClearTeam Explorer to <TOMCAT_HOME>/lib. (commons-codec-1.3.jar, commons-lang-2.3.jar, icu4j-4_8.jar, remote_core.jar, stpclientws.jar, stpcq.jar, teamapiextensions.jar, unicodetypemgr.jar, commons-httpclient-3.0.jar, commons-logging-1.0.4.jar, icu4j-charset-4_8.jar, stpcc.jar, stpcmmn.jar, stpwvcm.jar, ucleardiffmerge.jar)

Configure context.xml

Open context.xml for editing. It is located in the conf folder where you extracted Tomcat.

Add the following text inside of the <Context> </Context> tags. change <password for fd_admin> to the actual password, and if necessary, changing your jdbc url as well.

<!-- Prevent unnecessary warnings in the log.                                   -->
<JarScanner scanManifest="false"/>


<!-- Database Connection for the FlexDeploy Application                                   -->
<Resource name="jdbc/flexdbDS" auth="Container" type="oracle.jdbc.pool.OracleDataSource" factory="oracle.jdbc.pool.OracleDataSourceFactory"              
url="jdbc:oracle:thin:@localhost:1521:xe" user="fd_admin" password="put password for fd_admin" maxActive="100" maxIdle="10" maxWait="60" validationQuery="select 1 from dual" testOnBorrow="true"/>

Configure Tomcat Environment

WINDOWS

Create file setenv.bat in the tomcat \ bin folder

edit the file.

set CATALINA_OPTS=%CATALINA_OPTS% -verbose:gc -Xms1024m -Xmx2048m -Doracle.mds.cache=simple -Dorg.apache.el.parser.SKIP_IDENTIFIER_CHECK=true -Dflexagon.fd.repository.root=/opt/flexdeploy/repository -Dflexagon.fd.install.root=/opt/flexdeploy/application -Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom

UNIX

Create file setenv.sh in the tomcat / bin folder.

edit the file.

JAVA_HOME=/usr/jdk1.8.0_60
CATALINA_OPTS='-verbose:gc -Xms1024m -Xmx2048m -Doracle.mds.cache=simple -Dorg.apache.el.parser.SKIP_IDENTIFIER_CHECK=true -Dflexagon.fd.repository.root=/opt/flexdeploy/repository -Dflexagon.fd.install.root=/opt/flexdeploy/application -Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom'

...

If you are running multiple applications on Tomcat, you will want to edit the logging.properties file as suggested below.

Edit logging.properties in the Tomcat/conf folder. 

Add a new handler to the handlers line (starts with handlers=) by adding an additional handler to the end of the list.

, 5fd.org.apache.juli.AsyncFileHandler

...

.handlers = 5fd.org.apache.juli.AsyncFileHandler


5fd.org.apache.juli.AsyncFileHandler.level = ALL
5fd.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
5fd.org.apache.juli.AsyncFileHandler.prefix = flexdeploy.
5fd.org.apache.juli.AsyncFileHandler.formatter = flexagon.fd.logging.FlexDeployLogFormatter

org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/flexdeploy].level = INFO
org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/flexdeploy].handlers = 5fd.org.apache.juli.AsyncFileHandler


.level=INFO
flexagon.level=INFO
org.apache.jasper.servlet.level = WARNING
oracle.adf.share.security.level=SEVERE
oracle.adf.share.jndi.ReferenceStoreHelper.level=SEVERE

WAR Installation

Put the flexdeploy.war file into the webapps folder. It is found in the FlexDeploy-Tomcat.zip file /apache-tomcat-flexdeploy/webapps folder.

If you will be using the Salesforce integration, copy ant-salesforce.jar from the Tomcat_Complete.zip file /apache-tomcat-flexdeploy/lib folder and place it in <TOMCAT_HOME>/lib

Start Tomcat.

Unix

cd <tomcat install>/bin

./startup.sh

Windows

Double click startup.bat in the <tomcat install>\bin folder.