Deployment and Maintenance / System Requirements
Before installing DataFlux Func, please ensure that the environment meets the following conditions.
1. System Requirements
The host running DataFlux Func must meet the following conditions:
- CPU cores >= 2
- Memory capacity >= 4GB
- Disk space >= 20GB
- Network bandwidth >= 10Mbps
- Operating system is Ubuntu 16.04 LTS / CentOS 7.2 or above, macOS and Windows are not supported
- Clean system (no operations performed after installing the operating system except for network configuration)
- Open port
8088(this system uses port8088by default. Please ensure firewall, security group, and other configurations allow inbound access to8088) - When using an external MySQL, the MySQL version must be 5.7 or above, with the
innodb_large_prefixparameter enabled, and the database encoding set toutf8mb4 - When using an external Redis, the Redis version must be 5.0 or above, with at least 1 GB of available memory, non-clustered version
Note on certain cloud platform auto-installed plugins
Some plugins automatically installed by cloud platforms may consume significant resources themselves. The system configuration should be appropriately increased.
Detailed operating system compatibility
For detailed operating system compatibility test results, please refer to Tested Operating System Compatibility
If you wish to install on a Raspberry Pi, please refer to the following articles:
- Maintenance and Deployment / Installation / Raspberry Pi Official OS Deployment
- Maintenance and Deployment / Installation / Raspberry Pi Ubuntu Deployment
2. Software Preparation
This system runs based on Docker Stack. The installation package itself includes the Docker installation package and will automatically install Docker during installation.
Users can also install Docker and initialize Docker Swarm themselves, then run the installation script. The installation script will automatically skip this part if it detects Docker is already installed.
- The Docker Swarm initialization command is:
sudo docker swarm init
If the machine has multiple network cards, the network card needs to be specified in the above initialization command.
- Users with multiple network cards are advised to install Docker and initialize Docker Swarm themselves.
- The Docker Swarm initialization command specifying a network card is:
sudo docker swarm init --advertise-addr={network card name} --default-addr-pool={default address pool} - The list of network cards on the machine can be queried using
ifconfigorip addr. - Ensure the default address pool does 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
In the automatic installation script, when performing 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 | |
3. Tested Operating System Compatibility
This system's operation depends on Docker Swarm. Some older Linux distributions may not support the newer version of Docker, preventing the installation of this system.
For "Tested Environment":
- Virtual Machine: All use official ISO images, deploying DataFlux Func directly after installation.
- Alibaba Cloud: All use ECS public images, deploying DataFlux Func directly after ECS startup.
- Raspberry Pi: All use ISO images provided by the official website (ARM 64-bit operation), deploying DataFlux Func directly after startup.
For "Tested Result":
- Compatible: Indicates that after installing/creating the host, the installation script can be run directly to complete the installation without any additional operations.
- Conditionally Compatible: Indicates that after installing/creating the host, the installation script cannot be run directly; additional operations are required before executing the installation script.
- Incompatible: Indicates that the installation script cannot execute correctly in this environment, but you can use the image file to handle it yourself.
Test Results
The operating systems listed below have been tested and passed on cloud platforms or virtual machines. Those not listed are not necessarily incompatible.
Requires 64-bit system
DataFlux Func needs to 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 in a virtual machine or cloud host.
x86 Architecture
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| Ubuntu 22.04 | Alibaba Cloud | 5.1.0 5.0.5 |
||
| Ubuntu 20.04 | Alibaba Cloud | 5.0.5 |
||
| Ubuntu 18.04 | Alibaba Cloud | 5.0.5 |
||
| Ubuntu 16.04 | Alibaba Cloud | 5.0.5 |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| Ubuntu 20.04 LTS | VirtualBox | 2.x |
||
| Ubuntu 18.04 LTS | VirtualBox | 2.x |
||
| Ubuntu 16.04 LTS | VirtualBox | 2.x |
||
| Ubuntu 14.04 LTS | VirtualBox | 2.x |
Cannot use newer Docker due to new Docker feature requirements |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| CentOS 8.5 | Alibaba Cloud | 2.x |
||
| CentOS 8.4 | Alibaba Cloud | 2.x |
||
| CentOS 8.3 | Alibaba Cloud | 2.x |
||
| CentOS 8.2 | Alibaba Cloud | 2.x |
||
| CentOS 8.1 | Alibaba Cloud | 2.x |
||
| CentOS 8.0 | Alibaba Cloud | 2.x |
||
| CentOS 7.9 | Alibaba Cloud | 2.x |
||
| CentOS 7.8 | Alibaba Cloud | 2.x |
||
| CentOS 7.7 | Alibaba Cloud | 2.x |
||
| CentOS 7.6 | Alibaba Cloud | 2.x |
||
| CentOS 7.5 | Alibaba Cloud | 2.x |
||
| CentOS 7.4 | Alibaba Cloud | 2.x |
||
| CentOS 7.3 | Alibaba Cloud | 2.x |
||
| CentOS 7.2 | Alibaba Cloud | 2.x |
The original CentOS 7.2 image version is too low to use overlay2. It defaults to the non-union filesystem vfs, which can lead to excessive disk usage.However, the Alibaba Cloud public image for CentOS 7.2 has an upgraded kernel and can use overlay2 normally. |
|
| CentOS 6.10 | Alibaba Cloud | 2.x |
Cannot use newer Docker due to new Docker feature requirements |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| CentOS 7.9 | VirtualBox | 5.0.5 |
Image from Alibaba Cloud Open Source Mirror Site / CentOS 7.9.2009 / CentOS-7-x86_64-Minimal-2009.iso |
| Operating System | Tested Version | Tested Environment | Remarks |
|---|---|---|---|
| Debian 10.2 "buster" | Alibaba Cloud | 2.x |
|
| Debian 9.6 "stretch" | Alibaba Cloud | 2.x |
|
| Debian 8.11 "jessie" | Alibaba Cloud | 2.x |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| AlmaLinux 9.0 64-bit | Alibaba Cloud | 2.x |
||
| AlmaLinux 8.6 64-bit | Alibaba Cloud | 2.x |
||
| AlmaLinux 8.5 64-bit | Alibaba Cloud | 2.x |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| Fedora 35 64-bit | Alibaba Cloud | 2.x |
||
| Fedora 34 64-bit | Alibaba Cloud | 2.x |
||
| Fedora 33 64-bit | Alibaba Cloud | 2.x |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| OpenSUSE 15.4 64-bit | Alibaba Cloud | 2.x |
Docker needs to be installed beforehand, and Docker Swarm needs to be configured. For details, please refer to SUSE / Docker Open Source Engine Installation |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| SUSE Linux Enterprise Server 15 SP3 64-bit | Alibaba Cloud | 2.x |
Docker needs to be installed beforehand, and Docker Swarm needs to be configured. For details, please refer to SUSE / Docker Open Source Engine Installation |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| Rocky Linux 9.5 64-bit | Alibaba Cloud | 6.2.8 |
||
| Rocky Linux 8.6 64-bit | Alibaba Cloud | 2.x |
||
| Rocky Linux 8.5 64-bit | Alibaba Cloud | 2.x |
ARM Architecture
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| Ubuntu 22.04 | Alibaba Cloud | 5.0.5 |
||
| Ubuntu 20.04 | Alibaba Cloud | 5.0.5 |
||
| Ubuntu 18.04 | Alibaba Cloud | 2.x |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| Ubuntu 20.04 LTS | Raspberry Pi 4B 8GB version |
2.x |
For details, please refer to Maintenance and Deployment / Installation / Raspberry Pi Ubuntu Deployment |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| CentOS 8.3 | Alibaba Cloud | 2.x |
Redis reports Unsupported system page size error and cannot start.For details, see Troubleshooting / Containers Not Running Properly / Redis does not support the current system's page size |
|
| CentOS 7.9 | Alibaba Cloud | 2.x |
Redis reports Unsupported system page size error and cannot start.For details, see Troubleshooting / Containers Not Running Properly / Redis does not support the current system's page size |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| Debian 10.9 "buster" | Alibaba Cloud | 2.x |
| Operating System | Tested Environment | Tested Version | Tested Result | Remarks |
|---|---|---|---|---|
| Raspberry Pi OS (Debian 10 "buster") | Raspberry Pi 4B 8GB version |
2.x |
Raspberry Pi needs to be in arm64_bit mode.For details, please refer to Maintenance and Deployment / Installation / Raspberry Pi Official OS Deployment |
4. Browser Compatibility
This system is a web application. Some browsers may have compatibility issues and cannot be used.
| Browser | Tested Result |
|---|---|
| Chrome | |
| Safari | |
| Firefox | |
| Microsoft Edge (webkit) | |
| Opera | |
| Maxthon Browser | |
| Sogou Browser | |
| QQ Browser | |
| 360 Speed Browser (Speed Mode, i.e., Chrome Mode) | |
| 360 Speed Browser (Compatibility Mode, i.e., IE Mode) | |
| Internet Explorer |
X. Appendix
Kernel Version Too Low Causing Inability to Use Overlay
The Overlay storage engine requires Linux kernel 4.0+ or RHEL/CentOS version 3.10.0-514+. See:
- Docker Docs: Use the OverlayFS storage driver
- Docker Docs: Use the VFS storage driver
- Wikipedia: CentOS version 7
Excerpt of Docker Installation Commands in 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 | |