Versions Compared

Old Version 151

changes.mady.by.user Chandresh Patel

Saved on

compared with

New Version 152

changes.mady.by.user Chandresh Patel

Saved on

Key

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

The FlexDeploy distribution for Tomcat includes the binaries for Tomcat, the FlexDeploy WAR, and the base configurations, leaving only a few simple steps to complete the install. The distribution contains the following components. 

...

Requirements 

  • 8GB of RAM
  • 1 CPU
  • At least 20GB of available space, may need additional space based on purge criteria and usageWe recommend approximately 125GB total disk space should be sufficient for application tier. See FlexDeploy System Requirements, which explains requirements for application and database tier.
  • 64 bit Java 8 JDK.
    Include Page
    JDK Options
    JDK Options
  • If you have not created FlexDeploy Working Directory and Artifact Repository folders, we will create in steps below. (See Create Folders for FlexDeploy Server)
  • See Installation Instructions - Database Tier for requirements on Database tier.
  • Optional Requirements
    • Consider Java Cryptography Extension (JCE) unlimited strength policy files to avoid SSH issues when using strong ciphers. This is not necessary for newer JDK versions, if you see limited and unlimited folders under jre/lib/security/policy, then your JDK is generally setup for it.
    • If you are using Git repository for source code, please install Git client on FlexDeploy server as well as some development servers. See Git Plugin Guide.
    • If you are planning to use JDeveloper plugin to build ADF/Java applications, consider additional server requirements. See Oracle JDeveloper Plugin Guide.
    • To enable https or HSTS, see Related Topics at the end of this document.

Installation Instructions

...

  • Replace the contents of context.xml with the contents the context-<type>.xml if using PostgreSQL.   The default context.xml file included is for Oracle database. 
  • Replace URL and Password with the actual values.

...

Tip
titleExample JDBC URL (CONNECT_STRING)
  • Oracle
    • The JDBC short format of host:sid:port should not be used. URL must be in the format listed below as we are recommending user of UCP based connection pooling.
      • Example - jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=tcp)(HOST=**HOSTNAME**)(PORT=**PORT**)))(CONNECT_DATA=(SERVICE_NAME=**SERVICE_NAME**)))
      • If RAC is used for the database, multiple nodes can be listed in the address list of the URL or it can point to the scan listener for the cluster. See below sample URL for a RAC implementation that has a primary and secondary scan listener connecting to to a service name GOLD-CLOUD. This includes connection timeout, retry, and retry delay settings.
      • Example - jdbc:oracle:thin:@(DESCRIPTION = CONNECT_TIMEOUT=120) (RETRY_COUNT=20) (RETRY_DELAY=3) (TRANSPORT_CONNECT_TIMEOUT=3) (ADDRESS_LIST =(LOAD_BALANCE=on) (ADDRESS = (PROTOCOL = TCP) (HOST=primary-scan) (PORT=1521))) (ADDRESS_LIST =(LOAD_BALANCE=on) (ADDRESS = (PROTOCOL = TCP) (HOST=secondary-scan) (PORT=1521))) (CONNECT_DATA=(SERVICE_NAME = gold-cloud)))
    • For more information about using UCP please check here.
  • PostgreSQL

...

Tip

If you are setting up FlexDeploy for Trial purposes, it is good idea to leave directories as default,  but if you are setting up FlexDeploy for production use, then we recommend to modify to use directory structure outside of FlexDeploy installation.

For previous FlexDeploy versions, these changes were directly done in setenv.sh or setenv.bat files.

File - <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/setenvoverride.sh (setenvoverride.bat on windows)

...

  • Download the latest Oracle JDBC driver from https://www.oracle.com/database/technologies/appdev/jdbc-ucp-19c-downloads.html. For example, ojdbc8-full.tar.gz.
  • Remove ojdbc jar files like ojdbc*.jar or ojdbc*dms.jar from <FlexDeploy Home>/apache-tomcat-flexdeploy/lib.

  • Copy all jars downloaded with ojdbc8-full.tar.gz (for example, ojdbc8.jar, ons.jar anducp.jar. All other jars are needed if you are using Oracle Database Cloud services) to <FlexDeploy Home>/apache-tomcat-flexdeploy/libext.

    Note

    This has changed with FlexDeploy 5.6.0.1. Please put any extra libraries required inside of <FlexDeploy Home>/apache-tomcat-flexdeploy/libext not <FlexDeploy Home>/apache-tomcat-flexdeploy/lib. You will need to create this directory.


  • UCP is now required for Oracle Database connections. See Implementing UCP connections with Tomcat and Oracle for more info.

...

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

...