Installing ZFlow on AWS Linux2

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 2 Instance

The first step is to login into your AWS account and from the console panel get to the EC2 Dashboard. From the

 

 

 

 

 

Install Java 8

Once you are able to 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.

You can use the following command to install Java 8 on AWS Linux 2 instance

sudo yum install java-1.8.0-openjdk

 

You can check active java version using the following command

java -version

You should see something like below

 

 

 

 

Install Tomcat 8.5

There are a couple of options for installing tomcat 8.5

Option#1: Use tomcat 8.5 from AWS extras repo

You can list the extra packages (you will see tomcat8 versions):

amazon-linux-extras list

You can install tomcat8.5 with the following command

sudo amazon-linux-extras install tomcat8.5

 

Add the following line to /usr/share/tomcat/conf/context.xml

<CookieProcessor className="org.apache.tomcat.util.http.LegacyCookieProcessor" />

After the line is added context.xml may look like below

 

 

You can start tomcat service with the following command

sudo systemctl start tomcat

 

You can look at the tomcat log using the following command

journalctl -f -u tomcat

 

The webapps directory of tomcat is usually located at

/var/lib/tomcat

Unfortunately, the installation process does not create the tomcat webapp (ROOT) so there is no index file under /var/lib/tomcat/webapps/ROOT/ to clearly show that tomcat is running. You can of course create your own index file and add it to the /var/lib/tomcat/webapps/ROOT/ directory. You can do this by creating index.html with the following HTML

You can also download the index.html file and place it under /var/lib/tomcat/webapps/ROOT/

Once tomcat is working you should see a screen like below when http://your_aws_instance_public_ip_number:8080 is entered in the browser URL

Finally, use the following command to enable tomcat to start automatically when the server boots up

sudo systemctl enable tomcat

 

Use the command below to stop tomcat

sudo systemctl stop tomcat

 

Option#2: Download from tomcat repository and install

The second option is to download tomcat from apache tomcat repository and installing it.

One advantage of this option is that tthere is no log4j jar file in the apache tomcat distribution.

You follow the steps in the following post to install Tomcat 8 manually

How to install Apache Tomcat 8 on Ubuntu

 

Install MySQL 5.7

 

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

sudo rpm -Uvh https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm

 

Run this command before you run the below command to install mysql-server

sudo rpm --import https://repo.mysql.com/RPM-GPG-KEY-mysql-2022

 

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

 

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';
mysql> FLUSH PRIVILEGES;

 

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 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 ZFlowConfig.properties

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

DB_USER=userforzflowdatabase
DB_URL=jdbc:mysql://localhost:3306/databaseforzflow
DB_PASSWD=password_for_zflowdbuser

 

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 install.properties

 

Set the following install properties to true

INSTALL=true
LOAD_SYS_DATA=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.