Skip to content

Deployment and Maintenance / Raspberry Pi Ubuntu Deployment

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

Always use the latest version of DataFlux Func for operations

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

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

You must use a 64-bit Ubuntu Server image for Raspberry Pi

1. Preparations

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

1.1 Flashing the Raspberry Pi SD Card

It is recommended to use a clean official image to flash the SD card and then install DataFlux Func.

When flashing the SD card, you can choose:

  1. Use the official Raspberry Pi Imager tool for flashing

  2. Directly download the official Ubuntu Server 64-bit image and use a third-party tool to flash

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

1.2 Initializing the System

After booting Ubuntu for Raspberry Pi for the first time, you need to log in using the default username and password:

Username Password
ubuntu ubuntu

You will be prompted to change the password after successful login

1.3 Configuring Wi-Fi Connection (Optional)

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

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. Then, the configuration should be modified to the following content:

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

Reboot the Raspberry Pi

Bash
1
sudo reboot

Use cURL to verify if the network connection is successful

Bash
1
curl -L bing.com

2. Installing DataFlux Func

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

2.1 Download

The download operation is the same as on other platforms. Use the following command. The script will detect the current environment architecture and download the 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 for Raspberry Pi on a PC, you need to 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 install:

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

2.3 Initializing the System

After installation is complete, use a browser to open the DataFlux Func initialization page for operations.

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

2.4 Confirming Installation

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

management-about-aarch64.png

Subsequent operations are no different from DataFlux Func installed on a regular server.

X. Appendix

This section records content related to Raspberry Pi for reference.

X.1 Maximizing 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  # Prevents the CPU from running at maximum frequency
arm_freq=2100  # Overclock CPU to 2.1Ghz (default is 1.5Ghz)
over_voltage=6 # Increase voltage to level 6

It can be used normally even without the above settings, and a simple metal case can achieve passive cooling

This setting involves overclocking. Full load operation cannot rely solely on a metal case for passive cooling; at least a 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 bears no responsibility. Please think twice before proceeding

X.2 Raspberry Pi Stress Test Program

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

Clone the project repository

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

The original author's 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

Text Only
1
sudo ./stress.sh

Then, you can see output similar to the following in the terminal:

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 let the Raspberry Pi stay at high temperatures (above 80 degrees Celsius) for extended periods