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 - consider 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 or MySQL. The default context.xml file included is for Oracle database.
- Replace URL and Password with the actual values.
...
Tip | ||
---|---|---|
| ||
|
Include Page | ||||
---|---|---|---|---|
|
...
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<Resource name="jdbc/flexdbDS" auth="Container"
type="javax.sql.DataSource"
factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
driverClassName="org.postgresql.Driver"
url="**CONNECT_STRING**"
username="fd_admin"
password="**FD_ADMIN_PASSWORD**"
maxTotal="100"
maxIdle="20"
validationQuery="select 1"
testOnBorrow="true"
defaultTransactionIsolation="READ_COMMITTED"
useLocalSessionState="true"
defaultAutoCommit="false"/> | ||||||
Code Block | ||||||
| ||||||
<Resource name="jdbc/flexdbDS" auth="Container" type="javax.sql.DataSource" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" driverClassName="com.mysql.jdbc.Driver" url="**CONNECT_STRING**" username="fd_admin" password="**FD_ADMIN_PASSWORD**" maxTotal="100" maxIdle="10" initialSize="10" validationQuery="SELECT 1" testOnBorrow="true" defaultTransactionIsolation="READ_COMMITTED" useLocalSessionState="true" defaultAutoCommit="false"/> |
...
Step 6. (Optional) Modify Tomcat Environment script (setenvsetenvoverride.sh or setenvsetenvoverride.bat) for FlexDeploy server side directories.
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/setenvsetenvoverride.sh (setenvsetenvoverride.bat on windows)
- Configure -Dflexagon.fd.install.root variable FD_APPLICATION_DIRECTORY with directory to use as the FlexDeploy working directory (See Create Folders for FlexDeploy Server - FlexDeploy Working Directory)
- Configure -Dflexagon.fd.repository.root Configure variable FD_REPOSITORY_DIRECTORY with the directory to host the FlexDeploy artifact repository (See Create Folders for FlexDeploy Server - FlexDeploy Artifact Repository)
Below are default artifact and working directories created under FlexDeploy Home when you extracted zip file. If you want to use different directories then modify setenvsetenvoverride.sh or setenvsetenvoverride.bat file, otherwise skip this step.
Default setenvsetenvoverride.sh is shown below.
Here is example of setenvsetenvoverride.sh which is modified to use non-default folders.
...
Step 7. (Optional) Modify Tomcat Environment script (setenvsetenvoverride.sh or setenvsetenvoverride.bat) for JAVA_HOME.
File - <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/setenvsetenvoverride.sh (setenvsetenvoverride.bat on windows)
Tip |
---|
If JAVA_HOME is already set in your environment, you can skip this step. Unix Example - export JAVA_HOME=/u01/java/jdk1.8.0_121 Windows Example - set JAVA_HOME=c:/installs/Java/jdk1.8.0_121 |
If you were also setting JAVA_HOME, this file would look like this.
...
Step 8. (Only if using Oracle Database)
- Download the latest Oracle JDBC driver from https://www.oracle.com/database/technologies/appdev/jdbc-ucp-19c-downloads.html. For . Click on the driver link matching your Oracle database version, and download the driver compatible with JDK8. For example,
ojdbc8-full.tar.gz
.
Note | ||
---|---|---|
Be sure to download the JDBC driver matching your Oracle Database version and one which is compiled and compatible with JDK8. If you download the driver which is compiled with a newer JDK you will get errors on server startup similar to the following:
|
- Remove ojdbc jar files like ojdbc*.jar or ojdbc*dms.jar from <FlexDeploy Home>/apache-tomcat-flexdeploy/lib.
Copy all jar files (for example, ojdbc8.jar, ons.jar
and, ucp.jar and other jars) from
download archivedownloaded archive ojdbc8-full.tar.gz 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.
...
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.
...
Step 11. (Optional) Only if running FlexDeploy on a MySQL database.
...
.
...
Step 12. Start tomcat by running the following script.
...
Note | ||
---|---|---|
| ||
After starting your server, check the <FlexDeploy Home>/apache-tomcat-flexdeploy/logs/flexdeploy.0.log file for the following error message:
If present, increase the number of processes for the database
|
...
Step 1312. Launch FlexDeploy in your browser.
- 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.
- You will need to complete Initial Registration process, where you will create admin user for login.
...
Step 1413. 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.
...
Step 1514. Now that you have installed FlexDeploy, let's get start with configuration. You can do this in matter of minutes by using Blueprints concept, which is very simple configuration wizard for most common usecases.
Related Topics
Child pages (Children Display) |
---|