Skip to content

Deployment and Maintenance / System Requirements

Before installing DataFlux Func, please make sure the environment meets the following requirements.

1. System Requirements

The host running DataFlux Func must meet the following conditions:

  • CPU cores >= 2
  • Memory >= 4GB
  • Disk space >= 20GB
  • Network bandwidth >= 10Mbps
  • Operating system: Ubuntu 16.04 LTS / CentOS 7.2 or above, macOS and Windows are not supported
  • Clean system (after the operating system is installed, no operations other than network configuration have been performed)
  • Open port 8088 (the system uses port 8088 by default; make sure firewall, security group, and other settings allow inbound access to 8088)
  • When using an external MySQL, the MySQL version must be 5.7 or higher, with the innodb_large_prefix parameter enabled and the database encoding set to utf8mb4
  • When using an external Redis, the Redis version must be 5.0 or higher, with at least 1 GB of available memory, non-cluster version

Note about plugins automatically installed by some cloud platforms

Plugins automatically installed by some cloud platforms may consume a lot of resources, so the system configuration should be increased accordingly.

Detailed Operating System Compatibility

For detailed test results of operating system compatibility, see Tested Operating System Compatibility

If you wish to install on Raspberry Pi, please refer to the following articles:

2. Software Preparation

This system runs on Docker Stack, and the installation package itself contains the Docker installation package and will install it automatically during installation.

Users can also install Docker and initialize Docker Swarm themselves, then run the installation script. The installation script will automatically skip this step if it finds that Docker is already installed.

  • The Docker Swarm initialization command is: sudo docker swarm init

If there are multiple network interfaces on the machine, you need to specify a network interface in the above initialization command.

  • If multiple network interfaces exist, it is recommended that users install Docker and initialize Docker Swarm themselves
  • The Docker Swarm initialization command for specifying a network interface is: sudo docker swarm init --advertise-addr={network interface name} --default-addr-pool={default address pool}
  • The list of local network interfaces can be checked with ifconfig or ip addr
  • Note that the default address pool should not conflict with the local network subnet

Snap Version of Docker Is Not Supported

DataFlux Func does not support running on the Snap version of Docker.

docker swarm init in the automatic installation script

When the automatic installation script performs docker swarm init, the --advertise-addr and --default-addr-pool parameters are set to 127.0.0.1 and 10.255.0.0/16 respectively.

Bash
1
docker swarm init --advertise-addr=127.0.0.1 --default-addr-pool=10.255.0.0/16

3. Tested Operating System Compatibility

This system relies on Docker Swarm to run. Some older Linux distributions may not support the newer Docker, which may prevent the system from being installed.

For the "tested environments":

  • Virtual machines: all use official ISO images and deploy DataFlux Func directly after installation
  • Alibaba Cloud: all use ECS public images and deploy DataFlux Func directly after ECS startup
  • Raspberry Pi: all use official ISO images (ARM 64-bit), and deploy DataFlux Func directly after startup

For the "tested results":

  • Compatible: means that after installing/creating the host, running the installation script directly completes the installation without any additional operations
  • Conditionally compatible: means that after installing/creating the host, the installation script cannot be run directly; additional operations are required before running the installation script
  • Incompatible: means that the installation script cannot be executed correctly in this environment, but you can use the image file to handle it yourself

Test Results

The operating systems listed below have been actually installed on cloud platforms or virtual machines and passed the tests; those not listed are not necessarily incompatible.

A 64-bit System Is Required

DataFlux Func must run on a 64-bit system. The official Raspberry Pi OS also needs to run in ARM 64-bit mode.

Windows and macOS Are Not Supported

DataFlux Func does not support Windows or macOS. You can choose to install it on a virtual machine or cloud host.

x86 Architecture

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
Ubuntu 22.04 Alibaba Cloud 5.1.024.0.9
5.0.523.0.6		 Compatible
Ubuntu 20.04 Alibaba Cloud 5.0.523.0.6 Compatible
Ubuntu 18.04 Alibaba Cloud 5.0.523.0.6 Compatible
Ubuntu 16.04 Alibaba Cloud 5.0.523.0.6 Compatible

Original Images

Operating System Tested Environment Tested Version Tested Result Notes
Ubuntu 20.04 LTS VirtualBox 2.x20.10.8 Compatible
Ubuntu 18.04 LTS VirtualBox 2.x20.10.8 Compatible
Ubuntu 16.04 LTS VirtualBox 2.x20.10.8 Compatible
Ubuntu 14.04 LTS VirtualBox 2.x20.10.8 Incompatible Cannot use newer Docker because of Docker's new feature requirements

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
CentOS 8.5 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 8.4 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 8.3 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 8.2 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 8.1 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 8.0 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 7.9 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 7.8 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 7.7 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 7.6 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 7.5 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 7.4 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 7.3 Alibaba Cloud 2.x20.10.8 Compatible
CentOS 7.2 Alibaba Cloud 2.x20.10.8 Conditionally Compatible The original CentOS 7.2 image is too old to use overlay2; it defaults to the non-union filesystem vfs, which causes excessive disk usage.
However, the CentOS 7.2 in the Alibaba Cloud public image has an upgraded kernel and can use overlay2 normally.
CentOS 6.10 Alibaba Cloud 2.x20.10.8 Incompatible Due to Docker's new feature requirements, the new Docker version cannot be used.

Original Images

Operating System Tested Environment Tested Version Tested Result Notes
CentOS 7.9 VirtualBox 5.0.523.0.6 Compatible Image from Alibaba Cloud Open Source Mirror Site / CentOS 7.9.2009 / CentOS-7-x86_64-Minimal-2009.iso

Alibaba Cloud Public Image

Operating System Tested Version Test Result Remarks
Debian 10.2 "buster" Alibaba Cloud 2.x20.10.8 Compatible
Debian 9.6 "stretch" Alibaba Cloud 2.x20.10.8 Compatible
Debian 8.11 "jessie" Alibaba Cloud 2.x20.10.8 Compatible

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
AlmaLinux 9.0 64-bit Alibaba Cloud 2.x20.10.8 Compatible
AlmaLinux 8.6 64-bit Alibaba Cloud 2.x20.10.8 Compatible
AlmaLinux 8.5 64-bit Alibaba Cloud 2.x20.10.8 Compatible

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
Fedora 35 64-bit Alibaba Cloud 2.x20.10.8 Compatible
Fedora 34 64-bit Alibaba Cloud 2.x20.10.8 Compatible
Fedora 33 64-bit Alibaba Cloud 2.x20.10.8 Compatible

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
OpenSUSE 15.4 64-bit Alibaba Cloud 2.x20.10.8 Conditionally Compatible Docker and Docker Swarm must be installed and configured in advance
For details, refer to SUSE / Docker Open Source Engine Installation

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
SUSE Linux Enterprise Server 15 SP3 64-bit Alibaba Cloud 2.x20.10.8 Conditionally Compatible Docker and Docker Swarm must be installed and configured in advance
For details, refer to SUSE / Docker Open Source Engine Installation

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
Rocky Linux 9.5 64-bit Alibaba Cloud 6.2.824.0.9 Compatible
Rocky Linux 8.6 64-bit Alibaba Cloud 2.x20.10.8 Compatible
Rocky Linux 8.5 64-bit Alibaba Cloud 2.x20.10.8 Compatible

ARM Architecture

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
Ubuntu 22.04 Alibaba Cloud 5.0.523.0.6 Compatible
Ubuntu 20.04 Alibaba Cloud 5.0.523.0.6 Compatible
Ubuntu 18.04 Alibaba Cloud 2.x20.10.8 Compatible

Raspberry Pi Official Ubuntu Images

Operating System Tested Environment Tested Version Tested Result Notes
Ubuntu 20.04 LTS Raspberry Pi
4B 8GB version		 2.x20.10.8 Compatible For details, see Deployment and Maintenance / Installation and Deployment / Raspberry Pi Ubuntu Deployment

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
CentOS 8.3 Alibaba Cloud 2.x20.10.8 Incompatible Redis reports the Unsupported system page size error and fails to start
See Troubleshooting / Container Cannot Run Normally / Redis Does Not Support the Current System's Page Size
CentOS 7.9 Alibaba Cloud 2.x20.10.8 Incompatible Redis reports the Unsupported system page size error and fails to start
See Troubleshooting / Container Cannot Run Normally / Redis Does Not Support the Current System's Page Size

Alibaba Cloud Public Image

Operating System Tested Environment Tested Version Tested Result Notes
Debian 10.9 "buster" Alibaba Cloud 2.x20.10.8 Compatible

Original Images

Operating System Tested Environment Tested Version Tested Result Notes
Raspberry Pi OS (Debian 10 "buster") Raspberry Pi
4B 8GB version		 2.x20.10.8 Conditionally compatible Requires enabling arm64_bit mode on the Raspberry Pi
For details, please refer to Maintenance and Deployment / Installation and Deployment / Raspberry Pi OS Deployment

4. Browser Compatibility

This system is a Web application. Some browsers may have compatibility issues and cannot be used.

Browser Test Result
Chrome Compatible
Safari Compatible
Firefox Compatible
Microsoft Edge (webkit) Compatible
Opera Compatible
Maxthon Browser Compatible
Sogou Browser Compatible
QQ Browser Compatible
360 Speed Browser (Speed mode, i.e., Chrome mode) Compatible
360 Speed Browser (Compatibility mode, i.e., IE mode) Incompatible
Internet Explorer Incompatible

X. Appendix

Kernel Version Too Low to Use Overlay

The Overlay storage engine requires a Linux 4.0+ kernel, or RHEL/CentOS version 3.10.0-514+, see:

Excerpt of Commands for Installing Docker on OpenSUSE / SUSE Linux

Please ensure you are sufficiently familiar with OpenSUSE / SUSE Linux and understand the meaning of the following code before proceeding.

Bash
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
# SUSE Linux Enterprise Server only
SUSEConnect -p sle-module-containers/15.0/x86_64 -r ''

# Install Docker
zypper install docker
systemctl enable docker.service
systemctl start docker.service

# Configure Docker Swarm
docker swarm init --advertise-addr=127.0.0.1 --default-addr-pool=10.255.0.0/16

# Run the installation script
bash run-portable.sh