Versions Compared

Key

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

FlexDeploy provides a file distribution for Tomcat which simplifies the installation process.  This distribution contains Tomcat, the FlexDeploy WAR, and the base configurations, leaving only a few simple steps to complete the install. The distribution contains the following components. 

...

Step 2. Extract the zip file in the desired location (referred to as "FlexDeploy Home" in this document). See example below, where zip was extracted in C:/installs/FlexDeploy folder.

...

Code Block
languagexml
themeRDark
titleOracle
<Resource name="jdbc/flexdbDS" auth="Container"
    type="oracle.jdbc.pool.OracleDataSource"
    factory="oracle.jdbc.pool.OracleDataSourceFactory"
    url="${FLEX_DB_URL}**CONNECT_STRING**"
    user="fd_admin"
    password="${**FD_ADMIN_PWD}PASSWORD**"
    connectionCachingEnabled="true"
    connectionCacheProperties="{InitialLimit=0, MinLimit=0, MaxLimit=100, ConnectionWaitTimeout=60, InactivityTimeout=60, AbandonedConnectionTimeout=60, PropertyCheckInterval=30}"
    validationQuery="select 1 from dual"
    testOnBorrow="true"
    useLocalSessionState="true"
    defaultAutoCommit="false"
/>

...

Code Block
languagexml
themeRDark
titlePostgresql
<Resource name="jdbc/flexdbDS" auth="Container"
    type="javax.sql.DataSource"
    driverClassName="org.postgresql.Driver"
    url="${FLEX_DB_URL}**CONNECT_STRING**"
    username="fd_admin"
    password="${**FD_ADMIN_PWD}PASSWORD**"
    maxTotal="100"
    maxIdle="20"
    validationQuery="select 1"
    testOnBorrow="true"
    useLocalSessionState="true"
    defaultAutoCommit="false"
/>

...

Code Block
languagexml
themeRDark
titleMySQL
<Resource name="jdbc/flexdbDS" auth="Container"
    type="javax.sql.DataSource"
    username="fd_admin"
    password="${**FD_ADMIN_PWD}PASSWORD**"
    driverClassName="com.mysql.jdbc.Driver"
    url="${FLEX_DB_URL}**CONNECT_STRING**"
    maxTotal="100"
    maxIdle="10"
    initialSize="10"
    validationQuery="SELECT 1"
    testOnBorrow="true"
    useLocalSessionState="true"
    defaultAutoCommit="false"
/>

...

Step 8. 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 (ojdbc7.jar) from the Oracle Technology Network site at Oracle 12c drivers. Delete ojdbc6dms.jar from <FlexDeploy Home>/apache-tomcat-flexdeploy/lib and place ojdbc7.jar in that same folder.

...

Step 10. Linux only - set the shell scripts executable with this command: chmod +x <FlexDeploy Home>x <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/*.sh

Step 11. Skip this step if you did not modify setenv.sh or setenv.bat to use non-default Server server side directories in Step 6.

If you are using non-default server side directories, then move all the jar files from <FlexDeploy Home>/application/plugins to FLEXDEPLOY_WORKING_DIR/plugins. At startup, FlexDeploy will load all the plugins.

...

Note
titleNote for Oracle XE Database

After starting your server, check the <FlexDeploy Home>/apache-tomcat-flexdeploy/logs/flexdeploy.0.log file for the following error message:

  • ORA-12519, TNS:no appropriate service handler found

If present, increase the number of processes for the database

  • Using SQLPlus update processes setting.
    • alter system set processes=200 scope=spfile;
  • Stop Tomcat
  • Restart the XE Database
  • Start Tomcat

...

  • http://hostname:8000/flexdeploy
    • Update hostname in URL to indicate host where FlexDeploy is installed.
    • Update port if you had modified server.xml for different port number.
  • 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

Step 14. Go to Administration - Plugins on FlexDeploy. Verify that Plugins are loaded. You should not see any files remaining in FLEXDEPLOY_WORKING_DIR/plugins folder after few minutes.