Skip to content

Deployment and Maintenance / Raspberry Pi Ubuntu Deployment

This document mainly introduces how to run this system on a Raspberry Pi installed with the Ubuntu Server (64bit) system.

Please always use the latest version of DataFlux Func for operation

It is recommended to use a wired network connection to the Raspberry Pi during operation

This article is based on the Raspberry Pi 4B 8GB version. The Raspberry Pi 3B is too weak to run the system.

A 64-bit Ubuntu Server image for Raspberry Pi must be used.

1. Preparations

Some preparations are required before installing DataFlux Func on the Raspberry Pi.

1.1 Burning the Raspberry Pi SD Card

It is recommended to burn the SD card using a clean official image before installing DataFlux Func.

When burning the SD card, you can choose:

  1. Use the official Raspberry Pi Imager tool for burning

  2. Directly download the official Ubuntu Server 64-bit image and use third-party tools for burning

After burning is complete, insert the SD card into the Raspberry Pi and power it on to start.

1.2 Initialize the System

After the first boot of Ubuntu for Raspberry Pi, use the default username and password to log in:

Username Password
ubuntu ubuntu

You will be prompted to change the password after successful login.

1.3 Configure Wi-Fi Connection (Optional)

If you wish to connect to the network via Wi-Fi, follow the steps below:

Open the configuration file

Bash
1
sudo vim /etc/netplan/50-cloud-init.yaml

Assuming your Wi-Fi SSID is my-wifi and the password is my-wifi-password, the configuration should be modified as follows:

YAML
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
network:
    ethernets:
        eth0:
            dhcp4: true
            optional: true
    # Add Wi-Fi configuration here
    wifis:
        wlan0:
            dhcp4: true
            access-points:
                my-wifi:
                    password: my-wifi-password
    version: 2

Apply the new configuration

Bash
1
sudo netplan apply

Restart the Raspberry Pi

Bash
1
sudo reboot

Verify internet connectivity using cURL

Bash
1
curl -L bing.com

2. Install DataFlux Func

The process of installing DataFlux Func on the Raspberry Pi is basically the same as installing it on a regular server.

2.1 Download

Downloading is the same as on other platforms; simply use the following command. The script will detect the current environment architecture and download ARM version resources:

Bash
1
/bin/bash -c "$(curl -fsSL docs.dataflux-func.com/download)"

If you need to download the DataFlux Func installation package suitable for Raspberry Pi on a PC, specify --aarch64 in the download command

Bash
1
/bin/bash -c "$(curl -fsSL docs.dataflux-func.com/download)" -- --arch=aarch64

2.2 Installation

After the download is complete, enter the downloaded directory and execute the following command to proceed with the installation:

Bash
1
sudo /bin/bash run-portable.sh

2.3 Initialize the System

After installation, open the DataFlux Func initialization page through a browser to perform operations.

  • Visit http://{Raspberry Pi IP}:8088

2.4 Confirm Installation

After installation, log in to the system, go to 'Manage / About', and you can see that the 'Architecture' is aarch64:

management-about-aarch64.png

The subsequent operations are no different from those of DataFlux Func installed on a regular server.

X. Appendix

This section records some content related to the Raspberry Pi for reference.

X.1 Maximize Raspberry Pi Performance

Open the /boot/firmware/usercfg.txt file

Bash
1
sudo vim /boot/firmware/usercfg.txt

Add the following content as needed:

Text Only
1
2
3
force_turbo=0  # Prevent the CPU from running at maximum frequency
arm_freq=2100  # Overclock the CPU to 2.1GHz (default is 1.5GHz)
over_voltage=6 # Increase voltage to level 6

Even without the above settings, normal usage is possible, and passive cooling with just a metal case is sufficient.

This setting involves overclocking. Passive cooling alone with a metal case is not enough when running at full load; at least one fan is required.

More aggressive configurations can further enhance Raspberry Pi performance but will void the warranty.

If your Raspberry Pi is damaged due to overclocking, the author of this article assumes no responsibility. Please think carefully before proceeding.

X.2 Raspberry Pi Stress Testing Program

You can use the Raspberry Pi stress testing tool to test the stability of the Raspberry Pi (especially after overclocking).

Pull the project repository

Bash
1
git clone https://gitee.com/sujivin/rpi-cpu-stress.git

The original GitHub repository address is: github.com/xukejing/rpi-cpu-stress

Add executable permissions

Bash
1
2
cd rpi-cpu-stress
chmod +x stress.sh

Start the stress test

Bash
1
sudo ./stress.sh

In the terminal, you will see output similar to the following:

Text Only
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
a72 freq: 2100000
temp: 50634

a72 freq: 2100000
temp: 54530

a72 freq: 2100000
temp: 55991

a72 freq: 2100000
temp: 56478
  • a72 freq: 2100000: Indicates the current CPU frequency is 2.1GHz.
  • temp: 50634: Indicates the temperature is 50.634 degrees Celsius.

Do not allow the Raspberry Pi to remain at high temperatures (above 80 degrees Celsius) for long periods.