Chapter 5. Upgrading the Red Hat Edge Manager RPM installation

Procedure

1. Back up the PostgreSQL database for Red Hat Edge Manager on your Red Hat Enterprise Linux host before you change packages. Plan retention, tooling, and verification using Backing up the PostgreSQL database for Red Hat Edge Manager on Red Hat Enterprise Linux.
2. SSH into your Red Hat Enterprise Linux host.

3. Authenticate to the Red Hat Container Registry if you are not already logged in. Enter your Red Hat Customer Portal credentials when prompted. Without a valid registry login, services can fail to pull updated images after the package upgrade even when dnf completes successfully.

   sudo podman login registry.redhat.io

4. Enable the content repositories for the Red Hat Edge Manager release you are upgrading to. Run a command that follows the pattern in the following example, replacing the placeholders with the repository identifiers that match your target release, Red Hat Enterprise Linux version, and system architecture:

   sudo subscription-manager repos --enable edge-manager-<release>-for-rhel-<major_version>-<architecture>-rpms

5. List available versions of the flightctl-services package in your enabled repositories:

   sudo dnf repoquery --showduplicates flightctl-services

6. Upgrade the Red Hat Edge Manager services package:

   sudo dnf upgrade -y flightctl-services

   Note

   You do not need to stop Flight Control services before this step. The supported upgrade path applies database migrations while services may still be running older versions during the transition.

7. Restart Flight Control so all units run the upgraded software:

   sudo systemctl restart flightctl.target

8. Verify that the required services are active:

   sudo systemctl list-units flightctl-*.service

   Ensure that all listed services show a status of active. Some units are one-time initialization tasks and correctly display active (exited); persistent services display active (running). For more information, see Additional resources.

9. Optional: If you installed the Flight Control CLI from the RPM, upgrade it to match the server:

   sudo dnf upgrade -y flightctl-cli