Requirements 

• Tomcat 8.5.5 was tested, so it is the recommended version to run. There are known issues with Tomcat 7.
• 4GB of RAM
• 1 CPU
• JDK - refer to http://tomcat.apache.org/whichversion.html for selecting. Tomcat 8.5.5 was tested with JDK 1.8.60.

Tomcat Setup

If FlexDeploy is being installed for first time, setup Tomcat server and a Data Source as explained in following steps. If only updating, jump to installing the War. 

Install Tomcat

• Download the version of Tomcat Core built for your environment from this link: http://tomcat.apache.org/download-80.cgi#8.5.5
  
• Install a supported version of the JDK following the install procedures provided with the JDK
• Set the JAVA_HOME variable to the location the JDK was installed to
• Extract Tomcat to a folder where it will reside and run from.

Install jars into tomcat lib

Some jars are needed to support running an ADF application on Tomcat. Please download the following and put in the lib folder inside where you downloaded Tomcat.

• Copy 12.1.3 adf essentials and 12.1.3 adf essentials-client-ear to the tomcat lib folder from http://www.oracle.com/technetwork/developer-tools/adf/downloads/adf-download-1649592.html
• 
  
  •  Extract zip files in flat structure using unzip -j *.zip (works on Windows and UNIX
  • You should see a large number of jars now in the tomcat/lib folder.
• Download the following jars and place them in tomcat/lib as well please.
  • jta-1.1.jar
  • jackson-core-lgpl-1.9.13
  • jersey-bundle-1.18.jar
  • asm-3.3.1.jar

Configure the Data Source

• Open context.xml for editing. It is located in the conf folder where you extracted Tomcat.
• Add the following text, changing <password for fd_admin> to the actual password.

<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="<password for fd_admin>" maxActive="100" maxIdle="10" maxWait="60" validationQuery="select 1 from dual" testOnBorrow="true"/>

Configure the Tomcat Environment

WINDOWS:

• Create file setenv.bat in the tomcat \ bin folder

• edit the file.

set CATALINA_OPTS=%CATALINA_OPTS% -Xms1024m -Xmx2048m -XX:MaxPermSize=512m -Doracle.mds.cache=simple -Dorg.apache.el.parser.SKIP_IDENTIFIER_CHECK=true -Dflexagon.fd.repository.root=<real path on your server> -Dflexagon.fd.install.root=<real path on your server>

UNIX

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

JAVA_HOME=<Path to your JAVA_HOME>
CATALINA_OPTS='-Xms1024m -Xmx2048m -XX:MaxPermSize=512m -Doracle.mds.cache=simple -Dorg.apache.el.parser.SKIP_IDENTIFIER_CHECK=true -Dflexagon.fd.repository.root=<real path on your server> -Dflexagon.fd.install.root=<real path on your server>'

• Setup Logger Configurations.
  • ???

War installation

• • Put the flexdeploy.war file into the webapps folder.
  • Start Tomcat
  • path to bin /startup.sh on UNIX or double click startup.bat in the tomcat\bin folder if you are on Windows.