Centos 7

This is the guide for installing Fleio on Centos 7 distribution. In our documentation, for simplicity reasons, we are going to install the backend and the frontend on the same server.

Run the commands below as root user.

Enable the Fleio repository

Fleio is using dependencies that are available in epel. This package ensures that this extra repository is enabled along with Fleio repository.

yum install https://repos.fleio.com/rhel/7/fleio-release-1-2.el7.noarch.rpm

Install MariaDB 10.1

With the default MariaDB package on CentOS 7 we encountered database corruption issues leading to Fleio hanging. This is why we recommend MariaDB 10.1.

Check if you have MariaDB already installed:

yum list installed |  grep mariadb

Remove any already installed MariaDB version:

yum remove mariadb mariadb-server

Create and edit file /etc/yum.repos.d/mariadb.repo to add the MariaDB 10.1 repository:

touch /etc/yum.repos.d/mariadb.repo
vi /etc/yum.repos.d/mariadb.repo

And put the following text into the file.

# MariaDB 10.1 CentOS repository
# http://downloads.mariadb.org/mariadb/repositories/
[mariadb]
name = MariaDB
baseurl = http://yum.mariadb.org/10.1/centos7-amd64
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1

Save and close this file, then install MariaDB:

yum update
yum install MariaDB-server MariaDB-client MariaDB-shared

Start the service and make it autostart on system boot:

systemctl start mariadb
systemctl enable mariadb

Disable SELinux

Run this command to disable SELinux

setenforce 0

And edit /etc/sysconfig/selinux and set SELINUX=disabled to disable it permanently:

vi /etc/sysconfig/selinux
## edit and set SELINUX=disabled

Install the backend package

yum install fleio-backend

Install the frontend package

yum install fleio-frontend

Fleio needs a database server in order to operate. In this tutorial, we will use MariaDB-server but feel free to use the database server of your choice.

Create the database and the database user

We are using fleio as database and fleio as username.

Run the mysql command line client, and create the database and the username:

CREATE DATABASE fleio CHARACTER SET utf8;
GRANT ALL PRIVILEGES ON fleio.* TO 'fleio'@'localhost' IDENTIFIED BY 'HEREWETYPEPASSWORD';

Bootstrap initial configuration

Now that we have Fleio installed and we have the database prepared, we need to create the settings file in path /var/webapps/fleio/project/fleio/settings.py. You can create this file manually, based on the template file found at /var/webapps/fleio/project/fleio/settings.template or you can use a helper script to create the settings.py file.

To start the helper script run:

/var/webapps/fleio/scripts/bootstrap

This script creates the database tables, creates the administrator user and the settings.py file. Next you need to answer several questions. Note that the default values, which are usually fine, are in square brackets.

/var/webapps/fleio/scripts/bootstrap

 * URL to install Fleio at [http://12.34.56.78]:
 * Specify timezone [UTC]:
 * Enter mysql server ip [localhost]:
 * Enter mysql database name for fleio [fleio]:
 * Enter mysql username for fleio [fleio]:
 * Enter mysql password for username fleio: HEREWETYPEPASSWORD
 * Configuring SMTP...
 * Specify SMTP server [localhost]:
 * SMTP requires SMTP authentication ? y/n:
 If Yes:
    * Specify SMTP username:
    * Specify SMTP password:

 * Creating database scheme...
 * Done
 * Creating super user for staff...
 * Specify your first name:
 * Specify your last name:
 * Specify username:
 * Specify email:
 * Specify password:
 * Installing additional packages
 * Done

Please proceed to Configuring section.