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 install ESF with all the needed dependencies.
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.
Starting from ESF 7.1.1, the ESF RPM GPG key used to sign and verify the ESF RPM is the following.
For ESF 7.1.0, the key used to verify the RPMs 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 an ESF installer tailored for Raspberry Pi OS 32bit. This can be used for testing and evaluation purposes.

Before installing ESF, update and install all the needed dependencies with the following commands:

sudo apt update
sudo apt install openjdk-8-jdk rpm bind9 dos2unix ethtool hostapd isc-dhcp-server iw telnet unzip wireless-tools openvpn fail2ban python3-systemd iptables ansible chrony

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

sudo apt update
sudo apt install rpm bind9 dos2unix ethtool hostapd isc-dhcp-server iw telnet unzip wireless-tools openvpn fail2ban python3-systemd iptables ansible chrony

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

Proceed then installing the ESF rpm:

sudo rpm -ivh --nodeps esf-*.rpm
sudo reboot

Known issues:

the upgrades are not supported
no dependencies will be checked or installed during package installation. If some errors are shown on the ESF log, the user has to manually install the missing packages.