These instructions are for installing FlexDeploy on an existing Tomcat server.  If you are installing a new server, see Installing FlexDeploy with included Tomcat for a simplified installation which includes the Tomcat 8.5.11 server.  If you wish to use an existing Tomcat server, or to use a different version of Tomcat, please continue with this installation.

Requirements 

• Tomcat 8+  Tomcat 8.5.x was rigorously tested, and therefore, recommended. 
  • There are known issues with Tomcat 7.
• 8GB of RAM
• 1 CPU
• JDK - refer to http://tomcat.apache.org/whichversion.html for selecting. Tomcat 8.5.x was tested with JDK  1.7_67, 1.8_60 and 1.8_101.
• If you have not created FlexDeploy Working Directory and Artifact Repository folders are created, we will create in steps below. (See Create Folders for FlexDeploy Server)
• See Installation Instructions - Database Tier for requirements on Database tier.

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 new war file, skip to WAR Installation. 

Install

...

library jar files to 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.

...

Configure Tomcat Environment

WINDOWS

Create file setenv.bat in the <TOMCAT_HOME>/bin folder. Edit the file to have following lines. Update location of JAVA_HOME as appropriate.

set JAVA_HOME=C:/installs/Java/jdk1.8.0_121
set CATALINA_OPTS=%CATALINA_OPTS% -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Xms1024m -Xmx2048m -Xloggc:%CATALINA_BASE%/logs/gc.log -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=2M -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_HOME>/bin folder. Edit the file to have following line. Update location of JAVA_HOME as appropriate.

JAVA_HOME=/usr/jdk1.8.0_60
CATALINA_OPTS='-verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Xms1024m -Xmx2048m -Xloggc:$CATALINA_BASE/logs/gc.log -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=2M -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'

...

Setup Logger Configuration

If you are working with a new Tomcat instance that is only running FlexDeploy, you can simply download the logging.properties file and place it in the tomcat/conf folder.

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

Add the following lines to the file:

.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.

FlexDeploy Application Setup

Install WAR

• Copy Tomcat_Complete.zip/apache-tomcat-flexdeploy/webapps/flexdeploy.war file into <TOMCAT_HOME>/webapps folder.

Copy Plugins

Start Tomcat

• Unix
  • cd <tomcat install>/bin
  • ./startup.sh
• Windows
  • Double click startup.bat in the <tomcat install>\bin folder.

Launch Application

• Launch FlexDeploy in your browser
  • http://<hostname>:<port>/flexdeploy
  • If using 4.6.0.2 or later version of FlexDeploy, you will need to complete Initial Registration process, where you will create admin user for login.
  • If using 4.6.0.1 or prior version of FlexDeploy, default credentials are (note that this is application credentials and not database schema)
    
    • User - fdadmin
    • Password - welcome1