Fleio Requirements

Hardware Requirements

Minimum hardware requirements to run Fleio are: one virtual machine with 8 GB of RAM, 2 vCPUs, 80 GB of storage (SSD storage is recommended).

We have tested this configuration extensively on an OpenStack deployment with over 6 regions, 80 compute nodes and 2000 instances.

Supported Operating Systems

Linux distributions and versions supported by Fleio Docker deployment:

  • Ubuntu 22.04, 20.04, 18.04

  • Debian 12, 11

  • Red Hat Enterprise Linux 9.x

  • Rocky Linux 9

  • AlmaLinux 9.x

  • CentOS 8 Stream

Fleio Docker installation script should work on any Linux that has bash, runs systemd and is supported by Docker and Docker Compose, but we’re actively testing only the above distributions.

We recommend you to use one of the supported Linux distributions. If you do not use a supported version you will need to install Docker and Docker Compose manually and then run the installation script.

The operating system on the client machine (where the browser runs) does not matter as long as it has one of the supported browsers.

Correct system time

You must have a correct time and date on the machine on which you are installing Fleio, otherwise Fleio will not function correctly. We recommend that you use software like ntp or chrony to keep system time up-to-date.

Supported Browsers

Fleio supports the following browsers:

  • Chrome latest and previous major version

  • Safari latest and previous major version

  • Firefox latest and previous major version

  • Android latest and previous major version

  • iOS latest and previous major version

  • Microsoft Edge latest and previous major version

Required Network Configuration

If a firewall is deployed on the Fleio machine, the following network ports need to be accessible:

  • 80 TCP for non HTTP SSL connections

  • 443 TCP for HTTP SSL connections

Connections from the Fleio servers to the outside world are not blocked in most cases, however if they are, Fleio requires external access to many resources, including OpenStack services and cPanel/WHM. As a starting point the following ports are used by OpenStack services and cPanel/WHM API:

OpenStack services (Keystone, Nova, Neutron, Cinder, Glance, Designate and RabbitMQ):

  • Fleio licensing server: 443 (HTTPS)

  • RabbitMQ: 5672 (no SSL) and 5673 (SSL)

  • Keystone: 5000

  • Glance: 9292 and 9191

  • Neutron: 9696

  • Nova: 8773, 8774 and 8775

  • Cinder: 8776

  • Designate: 9001

  • Heat: 8004 and 8000

  • Magnum: 9511

  • Swift: 8080

  • Placement: 8780

  • Octavia: 9876

For cPanel/WHM the port is: 2087

These external ports only need to be configured on the firewall if it actually blocks connections from the server to the external network. Otherwise, Fleio only needs the usual TCP port 443 for HTTPS connections and TCP port 80 for HTTP connections to be accessible.

Due to licensing reasons Fleio needs to be connected to internet via a fixed public IP address.

OpenStack supported versions

Fleio officially supports the following OpenStack releases:

  • 2023.1 Antelope

  • Zed

  • Yoga

  • Xena

  • Wallaby

  • Victoria

  • Ussuri

  • Train

The Fleio development pipeline runs automatic tests against the listed above releases.

Fleio should also work with Stein, Rocky, Queens and Pike, but we are no longer testing Fleio with these releases.

OpenStack Supported Distributions

We have tested, and we are able to provide support for Fleio configuration with the following OpenStack distributions:

  • Kolla Ansible on Ubuntu and on CentOS

  • Ubuntu with OpenStack-Ansible

  • Red Hat Enterprise Linux / Centos with RDO

  • Ubuntu OpenStack

  • Mirantis OpenStack

  • DevStack

But Fleio should work with most OpenStack distributions. We’re using the standard OpenStack API and the internal RabbitMQ OpenStack message queue.

In our experience, Fleio does not work with Juju deployment of OpenStack due to a bug in Keystone policy file. Fleio sync will fail if the following commands fail when using the CLI with the same credentials as in Fleio:

openstack domain list
openstack project list --domain default

Make sure these commands work before adding OpenStack credentials in Fleio.

OpenStack Configuration Requirements

Fleio connects to OpenStack through the public OpenStack API and needs access to the management network in order to connect to the messaging queue daemon (RabbitMQ).

Fleio gets the up-to-date status of cloud resources as well as the cloud resource consumption information from the internal OpenStack messages posted on the message queue.

You can avoid giving Fleio access to the private OpenStack network and to the internal RabbitMQ message queue by forwarding RabbitMQ messages (see Forwarding RabbitMQ messages)

Fleio requires an OpenStack admin user with full access to the entire cloud and to all operations.

Mandatory OpenStack projects

In order to be able to use the main features of Fleio, you must have the following OpenStack projects:

  • Keystone

  • Nova

  • Neutron

  • Glance

Optional OpenStack projects

Main features of Fleio will work without the following OpenStack projects, but you may need them depending on your Fleio usage scenario:

  • Gnocchi is required for some pricing rules: per project network traffic pricing, Swift object storage pricing

  • Ceilometer and Ceilometer agent on compute nodes is required for project network traffic pricing

  • Cinder for block device (volume) storage

  • Cinder backup for volume backups and volume snapshots

  • Designate if you want staff and/or end users to edit DNS zones

  • Magnum and Heat if you want to use the Clusters feature

  • Swift for object storage

  • Octavia for Load balancers

RabbitMQ access is required for notification sent by Nova, Glance and other OpenStack services.

For more information and other configuration requirements, see Configuring section.