Versions Compared

Key

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

...

...

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 1531315186Installing WAR Installation. 

Install library jar files to Tomcat lib

...

    • 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_HOME>/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 following jar files from Tomcat_Complete.zip/apache-tomcat-flexdeploy/lib folder and place them in <TOMCAT_HOME>/lib.
    • 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 PostgreSQL, also copy postgresql-42.2.5.jre7.jar
    • If using MySQL, also copy mysql-connector-java-8.0.13.jar

...

Open context.xml for editing. It is located in the <TOMCAT_HOME>/conf folder. Add one of the following into your Update context.xml depending on your database type, see examples below.

Tip
titleExample JDBC URL (CONNECT_STRING)
  • Oracle
    • Localhost XE connection will look like this. jdbc:oracle:thin:@localhost:1521:XE
    • SID based JDBC URL Syntax - jdbc:oracle:thin:@HOSTNAME:PORT:SID
    • Service Name based JDBC URL Syntax - jdbc:oracle:thin:@//HOSTNAME:PORT/SERVICENAME

...

Code Block
languagepowershell
themeRDark
titlesetenv.bat
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 -Djbo.tmpdir=/opt/flexdeploy/application/state

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.

Code Block
languagebash
themeRDark
titlesetenv.sh
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 -Djbo.tmpdir=/opt/flexdeploy/application/state'

Info

Please make sure to modify the arguments for Server working directory (-Dflexagon.fd.install.root) and Artifacts repository (-Dflexagon.fd.repository.root) as per your installation. Be careful in copying details from browser due to potential character changes. Also, change jbo.tmpdir accordingly to Server working directory.

Setup Logger Configuration

...

  • Launch FlexDeploy in your browser
    • http://<hostname>:<port>/flexdeploy
    • If using 4.6.0.2 or later version of FlexDeploy, you 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