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:

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';

If you are seeing database related errors when installing or upgrading Fleio see Troubleshoot database errors on upgrade.

Bootstrap initial configuration

Now we need to bootstrap Fleio by running the following command:

/var/webapps/fleio/scripts/bootstrap

This script creates the database tables, creates the administrator user, the settings.py file, installs Nginx and configures it, and ensures that all the required services are up and running.

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.