Install ESF

ESF is provided using a RPM Linux package. Visit the ESF download page to find the correct installation file for the target system.

📘

Check the gateway-specific page if more detailed installation instructions or additional preliminary steps are needed for your device.

Once the installation package has been copied to the target system, ESF can be installed with the following command:

dnf install esf-*.rpm
reboot

The dnf tool is responsible to verify the installer signature and install ESF with all the needed dependencies. Please refer to this page for more details about installer signature verification.
Once the target device has finished rebooting, verify that ESF is running as expected.

🚧

On already deployed devices, the rpm install may require the installation of the ESF RPM GPG key used to sign and verify the ESF RPM.

The ESF RPM Key comes pre-installed in EL 27.1.0 and EL 30.0.0.

The Key is available here. To install in the target device, run the following command: rpm --import <key>

NN Profiles

The No Network (NN) profiles are special ESF profiles that do not bundle the ESF Network Manager: all the network configuration need to be done outside of ESF.

Functionalities missing in NN profiles compared to the full ESF profiles:

• Networking interfaces management
• Firewall configuration management

ESF on RaspberryPi

Eurotech provides ESF installers tailored for RaspberryPiOS (32 and 64bit) and for Ubuntu 20 (RaspberryPi). This can be used for testing and evaluation purposes.

📘

The provided installation instructions have been tested with a Raspberry Pi connected via ethernet.

The installation can be completed via WI-FI but, at the following reboot, ESF will disable as default policy the WI-Fi interface. It can be later re-enabled via the ESF administration web UI.

Raspberry PI OS 32/64bits

The ESF installers for Raspberry PI are available both with and without networking (generic profiles).

Once the installation package has been copied to the target system, ESF can be installed with the following command:

sudo apt update

sudo apt install ./esf-raspberry-pi_<version>_armhf.deb
sudo reboot

sudo apt install -y wget apt-transport-https gnupg
sudo wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add -
sudo echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update

sudo apt-get install temurin-8-jre

sudo apt install ./esf-raspberry-pi_<version>_arm64.deb
sudo reboot

🚧

ESF on RaspberryPi 3 64 bit

ESF requires java 8 to run, but the jdk is not available for the 64-bit version of Raspberry OS (bullseye).

Currently, due to a bug in the current version of the recommended distribution (Temurin), installation of ESF fails on RaspberryPi 3 and 3+.

RaspberryPi 4 and later are not affected by the problem.

The previous instructions are applicable for both Raspberry Pi OS Lite and Raspberry Pi OS with desktop.
In case of installation in "Raspberry Pi OS with desktop and recommended software", the following commands need to be applied to install ESF:

sudo apt update
sudo apt install java-1.8.0-openjdk-armhf
sudo update-java-alternatives --set java-1.8.0-openjdk-armhf

sudo apt install ./esf-raspberry-pi_<version>_armhf.deb
sudo reboot

Ubuntu 20.04 64bits

The ESF installer for Ubuntu 20.04 on Raspberry PI is available only in the form without networking (generic aarch64 profile).

Once the installation package has been copied to the target system, ESF can be installed with the following command:

sudo apt update
sudo apt install openjdk-8-jdk

sudo apt install ./esf-generic-nn_<version>_arm64.deb
sudo reboot

APT Package Verification

The apt tool will perform all the required actions for verify and install the package on the system. Please refer to this page for more details about installer sign verification.

WLAN Softblock

On Raspbian, it could happen that ‘wlan’ interface is “soft blocked” by default and needs to be enabled. To see if it is blocked run:

rfkill list

and unblock it with:

sudo rfkill unblock wlan

📘

Raspberry Pi issues when passing DNS over WLAN AP

On ESF 7.2.0, the DNS configuration pass to clients connected to a WiFi access point is not supported. Clients should manually setup their DNS configuration.