Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

  • 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.
  • FlexDeploy Working Directory and Artifact Repository folders are created.

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. 

...

    • 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.
  • 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.
    • Oracle JDBC driver matching your version of Java and database.  You can download the drivers from the Oracle Technology Network site.
  • FDLogFormatter.jar is found in Tomcat_Complete.zip /apache-tomcat-flexdeploy/lib folder. Please copy that file into the <TOMCAT_HOME>/lib folder as well.
  • 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)

...