These docs are for v7.0.0. Click to read the latest docs for v7.4.0.

Upgrade ESF

The RPM file used to a fresh ESF install can be used to upgrade an existing installation. The RPM file, indeed, contains all the resources needed to upgrade/install ESF. The upgrade will preserve all the user preferences, scripts and snapshots.

📘

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

To upgrade ESF download it from the Eurotech Download site.
Sideload the rpm file from your PC to the gateway and, from the same gateway folder, use the following command:

dnf upgrade esf-*.rpm

🚧

The ESF upgrade using RPM files supports upgrades from ESF 6.2.x to 7.0.x.
In case of upgrades from ESF 6.2.2, ESF 7.0.2 must be used as a target in order to prepare the system for an upgrade to ESF 7.1.1. The upgrade path should be: ESF 6.2.2 -> ESF 7.0.2 -> ESF 7.1.1.

It is recommended to use ESF 7.1.1 or greater for new developments.

In the case of different upgrade requirements, please keep in touch with your Eurotech sales representative for the quotation of a specific Professional Service.

Since ESF 7.0 is a major release with breaking changes, please refer to the ESF 7 Upgrade and Backwards Incompatible Changes page to verify the impact of the update on your existing installation and applications currently running on the framework.

🚧

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.0.2, the ESF RPM GPG key used to sign and verify the ESF RPM is the following.

For ESF 7.0.0 and 7.0.1, the key used to verify the RPMs is available here.

To install in the target device, run the following command: rpm --import <key>

🚧

ESF upgrade and Linux packages

ESF 7 comes with new features which require new Linux packages to be installed on already deployed devices.
As for the ESF RPM Key, Linux RPM keys come pre-installed in EL 27.1.0 and EL 30.0.0.
For earlier EL versions you will need to update the Linux RPM GPG keys before updating ESF.

You can do it by following these steps:

  • For ReliaGATE 10-14 and ReliaGATE/DynaGATE 10-12

dnf_resync

  • For other hardware platforms:
wget https://epr-dev.eurotech.com/packages/GPG_keys/2022/updatekeys
chmod +x updatekeys
./updatekeys -r

NOTE: It is safe to run BOTH dnf_resync and updatekeys.sh on systems that support both schemes.