FlexDeploy provides a zip 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.
- A tomcat 8.5.11 server with required libraries, and base configurations
- The FlexDeploy WAR
- The FlexDeploy database installation scripts
- The FlexDeploy plugins
Requirements
- Windows Operating System
- 8GB of RAM
- 1 CPU
- At least 20GB of available space, may need additional space based on purge criteria and usage.
- 64 bit Java 8 JDK which can be downloaded from http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html. (Open JDK 8 is also fine)
- Optional - consider Java Cryptography Extension (JCE) unlimited strength policy files to avoid SSH issues when using strong ciphers.
Installation Instructions
Step 1. Ensure Java 8 is installed on the server.
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.
Step 3. (Optional) Modify Tomcat server.xml for port if necessary.
File - <FlexDeploy Home>/apache-tomcat-flexdeploy/conf/server.xml
- By default, the Tomcat server is configured to run on port 8000. If this port is in use, change to some other unused port. Search for <Connector port="8000" protocol="HTTP/1.1" if you want to change it.
- There are other ports referenced in the server.xml file as well. If the logs contain a port in use error, you can find the open ports on your machine and then search this file for ports that you find are in use and change them.
Step 4. Modify Tomcat Environment script setenv.bat for JAVA_HOME.
File - <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/setenv.bat
Even when JAVA_HOME is already set in your environment, it would be a good idea to set it in setenv.bat.
For example - set JAVA_HOME=c:/installs/Java/jdk1.8.0_121
This file would look something like this.
Step 5. Start tomcat by running the following script.
File - <FlexDeploy Home>/StartWithPostgres.bat
Step 6. 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 7. 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.