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 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:
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 using the Fleio collector setup. Read more about the Fleio collector setup.
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.