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.

...

    • 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 now see a large number of jars 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.
    • 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)

...