Installing ZFlow on AWS Linux

ZFlow can be easily installed on AWS Linux 2 using the instructions below. We are assuming that your organization or you have an AWS account and are comfortable with AWS services in general, and especially EC2.


Launching AWS Linux Instance

The first step is to log into your AWS account and, from the console panel, get to the EC2 Dashboard. Create an AWS Linux 2023 using “Launch Instances”



Refer to the documentation on AWS if you need additional guidance on how to launch AWS Linux instances.





Install Java

Once you can access the above AWS instance using SSH, you can start the process of installing pre-requisites. If you are new to EC2, you can learn more about how to access EC2 instances using SSH in the following AWS user guide.

AWS Corretto

Use the command below to install AWS’s distribution of OpenJDK

sudo yum install java-21-amazon-corretto

You can check Java version using the following command

java -version

You should see something like below
openjdk version "21.0.3" 2024-04-16 LTS
OpenJDK Runtime Environment Corretto- (build 21.0.3+9-LTS)
OpenJDK 64-Bit Server VM Corretto- (build 21.0.3+9-LTS, mixed mode, sharing)

Install Tomcat

You can install Tomcat 9 using the following command

sudo yum install tomcat9


You can start tomcat9 service with the following commands

sudo systemctl start tomcat9
sudo service tomcat9 start


You can stop tomcat9 service with the following commands

sudo systemctl stop tomcat9
sudo service tomcat9 stop


You can use the following command to enable Tomcat to start automatically when the server boots up

sudo systemctl enable tomcat9


You can look at the tomcat log using the following command

journalctl -f -u tomcat9


The webapps directory of tomcat is located under





Install MySQL8


You can use instructions in the below link to install MySQL community server in the AWS instance you just created.


Since AWS Linux  does not have MySQL repositories the first step is to add the source repo using the command below

sudo rpm -Uvh


Once the repo is installed use the command below to install MySQL community server

sudo yum install mysql-community-server


To set MySQL server to start on boot using the following command

sudo systemctl enable mysqld


Start MySQL server using the command below

sudo systemctl start mysqld


By default MySQL 5.7 installation generates a temporary password. To find the password use the following command

sudo grep "password" /var/log/mysqld.log

Take a note of the above password since you will use that password in the step below.

Use the following command to reset the password and secure the installation.

sudo mysql_secure_installation


Remember the new password as you will need it in the next step. Learn more about MySQL Secure Installation.

Once MySQL is up and running the first step is to create a database user and database for zflow. You can login as MySQL root user to create the user and database with the following commands

mysql -u root -p

Creating Database and Database user for ZFlow in MySQL (when MySQL is running on the same server that ZFlow is running)

Once connected to MySQL, create the user with the following command. Come up with appropriate names for the following for your ZFlow installation, and keep them handy

  • userforzflowdatabase
  • password_for_zflowdbuser
  • databaseforzflow
mysql> CREATE USER 'userforzflowdatabase'@'localhost' IDENTIFIED BY 'password_for_zflowdbuser';

Make sure you give appropriate username and password in the above command and remember these as you will need them for configuring ZFlow.

mysql> CREATE DATABASE databaseforzflow;
mysql> GRANT ALL PRIVILEGES ON databaseforzflow.* TO 'userforzflowdatabase'@'localhost';

AWS RDS MySQL Databases

For RDS Systems (or scenarios where the MySQL server is different from the one where ZFlow is running), the user is created as follows. Please replace the user and database names with your values.

mysql> CREATE USER 'userforzflowdatabase'@'%' IDENTIFIED BY 'password_for_zflowdbuser';
mysql> CREATE DATABASE databaseforzflow;
mysql> GRANT ALL PRIVILEGES ON databaseforzflow.* TO 'userforzflowdatabase'@'%';


Install ZFlow

Go to the home directory of ec2-user and download ZFlow with the commands below


[ec2-user@ip-******** ~]$ cd $HOME


Please send us an email or contact us for ZFlow distribution. ZFlow distribution is a tar file (zflow.tar.gz) that you can unzip and untar using the commands below

[ec2-user@ip-******** ~]$ gunzip zflow.tar.gz
[ec2-user@ip-******** ~]$ tar -xvf zflow.tar


You should have the zflow directory with related application files listed

[ec2-user@ip-******** ~]$ ls
working  zflow


Move zflow directory to the webapps directory

[ec2-user@ip-******** ~]$ sudo mv zflow /var/lib/tomcat/webapps/

Change directory to webapps folder

[ec2-user@ip-******** ~]$ cd /var/lib/tomcat/webapps/


Change group and user ownership of zflow to tomcat

[ec2-user@ip-******** ~]$ sudo chown -R tomcat:tomcat zflow


ZFlow Configuration Properties

ZFlow configuration file is in the folder below

[ec2-user@ip-******** ~]$ cd /var/lib/tomcat/webapps/zflow/WEB-INF/classes/cfg


Use an editor (like vi or vim) to edit database configuration properties in the Configuration file

[ec2-user@ip-******** ~]$ sudo vi

Change the values of the database config properties as shown below. Use the actual names of the database user, database name and database password that you created in the MySQL section. Save changes to the file




Change LINK_BASE to IP number or DNS name of the tomcat server (If you are using load balancer in front, you should use the load balancer information


Depending the on the configuration you may route all the requests (using IP redirect and other options) using port 443 (https, in which case it will be



ZFlow Install Properties

Since this in an initial install we should set the appropriate install properties to create the database tables as well as load initial data. Install properties file is in the folder below

[ec2-user@ip-******** ~]$ cd /var/lib/tomcat/webapps/zflow/WEB-INF/classes/inst


Use an editor (like vi or vim) to edit install properties file

[ec2-user@ip-******** ~]$ sudo vi


Set the following install properties to true



Once this step is finished you can go back to the home directory and start tomcat server

sudo systemctl start tomcat


ZFlow should be running now. You can go to http://public_ip_of_your_ec2_instance:8080/zflow to complete the installation.



Make sure the inbound rules are properly set up in the security group so that 8080 port is reachable. You can also set an IP table rule to route all (http requests – port 80) are forwarded to 8080 which is the default port of tomcat.