ZFlow Installation Checklist for Linux

Instance

  • Get Server (AWS Linux, RHEL, Ubuntu…)

JDK Installation

  • Install JDK 17 (openJDK or Corretto)

Tomcat Installation

  • Install Tomcat 9
  • Enable tomcat service for automatic restart on server restart
  • Tomcat logging config
  • Tomcat memory config
  • Tomcat server.xml config (change max parameter count to 20000)
<Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxParameterCount="20000"
... />

MySQL Installation

  • Install MySQL 8.4
  • enable MySQL daemon for automatic restart on server restart
  • MySQL secure installation

Database for ZFlow

  • Create zflow database user
  • Create zflow database
  • Allow zflow database user to manage zflow database

Folders for Backup, Filevault, and Archive

Create folders (outside of tomcat directory). If running on AWS we recommend mounting an EFS and place these directories in the mount directory.

In linux, for example

  • /zflow/backup
  • /zflow/archive
  • /zflow/filevault

In Windows Server, for example

  • C:/zflow/backup
  • C:/zflow/archive
  • C:/zflow/filevault

ZFlow Installation

  • Download zflow war package
  • mv zflow.war pacakge to {tomcat webapps directory}
  • Let tomcat explode the war file to app directory
  • Navigate to zflow application start page in the browser https://servername:8080/zflow or https://servername/zflow
  • Select New Install option
  • Provide zflow installation details in the install form
  • Submit
  • System restarts automatically after approximately 100 seconds
  • You should now get a zflow login at the zflow application start page in browser
  • Login with previously typed in admin user and password info
  • Stop tomcat
  • remove zflow.war file from tomcat webapps directory
  • Start tomvat again

 

cronjob for restarting tomcat in case of application failure

*/5 * * * * /path-to-zflow/zflow-healthcheck.sh >> /path-to-zflow/log/zflow_healthcheck.log 2>&1
  • SSL certificate
  • IP tables config (optional – can run tomcat on 443)
  • Apache/Nginx proxy (how to set up SSL cert for Apache/Nginx..)
  • How to use EFS for file management in ZFLow
  • How to use EBS for file management in ZFlow
  • Backup directory, ZFlow File Vault, Archive Directory configuration

 

Minimal ZFlow Config

  • APP_BASE
  • LINK_BASE
  • WEB_BASE
  • Guest User in System Configuration (so that mail and user defined functions can run)
  • FILE VAULT Configuration
  • BACKUP_DIR
  • ARCHIVE_DIR
  • Mail Server Config

System Backups

Backup cfg and jsp once the initial configurations are completed

 

Database Backups

  • Add DB_HOST (needed for RDS based database environments)
  • Configure backups in batchlist