feat(installer): integrate complete runtime support for SONIE and systemd-boot OS upgrades by jasonbridges · Pull Request #4532 · sonic-net/sonic-utilities

jasonbridges · 2026-05-09T01:15:02Z

Pull Request Description: Add Support for SONIE & `systemd-boot` Upgrades

Title

feat(installer): integrate complete runtime support for SONIE and systemd-boot OS upgrades

Description Body

What I did

Introduced comprehensive runtime OS upgrade and installation support for bare-metal SONIE (SONiC Operating System Installation Environment) and generic systemd-boot based platforms into the sonic-installer framework.

This enables standard CLI operations (sonic-installer install, set-next-boot, set-default) to function seamlessly on non-GRUB, systemd-boot driven distribution architectures.

How I did it

Ported and combined three major feature evolutions into the standard utility framework:

Base Bootloaders & Utilities: Introduced the sonic_sdboot_utils library to interact natively with systemd-boot loader variables and EFI configurations. Added the SonieGrubBootloader (sonie.py) and NullBootloader (null.py) classes.
CLI Framework Integration: Integrated these bootloaders into sonic_installer/main.py. Added support for the --skip-bootloader parameter, robust temporary folder cleanup on SystemExit, and conditional database flags (-d) for hermetic environment updates.
Optimized Path Refactoring: Refactored get_image_path in bootloader.py to implement a highly robust fallback sequence:
- Validates target image versions securely by parsing slot sonic-config YAML manifests rather than guessing by file timestamps.
- Tracks active slots containing valid SONiC root filesystems as automated fallbacks.
- Resolves target slots dynamically based on /proc/cmdline running state.

How to verify it

Execute standard local unit test suites to confirm 100% pass rates across the new bootloader and assessment logic:

pytest tests/installer_bootloader_sonie_test.py
pytest tests/installer_bootloader_null_test.py
pytest tests/sdboot_install_main_test.py
pytest tests/sdboot_sdboot_config_test.py

Manual verification can be conducted on a SONIE bare-metal or QEMU instance:

sonic-installer install /path/to/sonic.bin -y

Previous command output (if the output of a command-line utility has changed)

Operations on systemd-boot architectures previously failed with fatal exceptions due to missing GRUB environment files:

Failed to detect bootloader environment. Aborting...

New command output (if the output of a command-line utility has changed)

Standard sonic-installer output now processes cleanly on systemd-boot platforms:

Installing image sonic.bin and setting it as default...
Verification successful
Setup SWAP memory
Done

mssonicbld · 2026-05-09T01:15:10Z

/azp run

azure-pipelines · 2026-05-09T01:15:16Z

Azure Pipelines will not run the associated pipelines, because the pull request was updated after the run command was issued. Review the pull request again and issue a new run command.

mssonicbld · 2026-05-09T01:18:37Z

/azp run

azure-pipelines · 2026-05-09T01:18:49Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T01:20:24Z

/azp run

azure-pipelines · 2026-05-09T01:20:30Z

Azure Pipelines will not run the associated pipelines, because the pull request was updated after the run command was issued. Review the pull request again and issue a new run command.

mssonicbld · 2026-05-09T01:21:47Z

/azp run

azure-pipelines · 2026-05-09T01:21:58Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T01:29:25Z

/azp run

azure-pipelines · 2026-05-09T01:29:32Z

Azure Pipelines will not run the associated pipelines, because the pull request was updated after the run command was issued. Review the pull request again and issue a new run command.

mssonicbld · 2026-05-09T01:30:15Z

/azp run

azure-pipelines · 2026-05-09T01:30:26Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T02:19:37Z

/azp run

azure-pipelines · 2026-05-09T02:19:48Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T02:34:16Z

/azp run

azure-pipelines · 2026-05-09T02:34:27Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T03:37:10Z

/azp run

azure-pipelines · 2026-05-09T03:37:21Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T03:48:07Z

/azp run

azure-pipelines · 2026-05-09T03:48:18Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T04:01:26Z

/azp run

mssonicbld · 2026-05-09T21:43:35Z

/azp run

azure-pipelines · 2026-05-09T21:43:46Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T21:53:55Z

/azp run

azure-pipelines · 2026-05-09T21:54:05Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T22:16:54Z

/azp run

azure-pipelines · 2026-05-09T22:17:05Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T22:20:08Z

/azp run

azure-pipelines · 2026-05-09T22:20:18Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-09T22:41:41Z

/azp run

azure-pipelines · 2026-05-09T22:41:51Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-10T00:14:10Z

/azp run

azure-pipelines · 2026-05-10T00:14:20Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-05-10T00:51:08Z

/azp run

azure-pipelines · 2026-05-10T00:51:18Z

Azure Pipelines successfully started running 1 pipeline(s).

Change-Id: I4d4cfa6115957987e33fda2c663fcaf3d69be991

mssonicbld · 2026-05-20T16:32:33Z

/azp run

azure-pipelines · 2026-05-20T16:32:46Z

Azure Pipelines successfully started running 1 pipeline(s).

Change-Id: Ic923c51ded5c8343e4bf6cae2b83f3b2630c440a

mssonicbld · 2026-05-29T02:10:07Z

/azp run

azure-pipelines · 2026-05-29T02:10:18Z

Azure Pipelines successfully started running 1 pipeline(s).

saiarcot895 · 2026-05-29T06:34:49Z

+        # Always check for A/B slots first as they are preferred for SONiC
+        candidates = []
+        for slot in ["image-A", "image-B"]:
+            slot_path = path.join(HOST_PATH, slot)


I think this assumes that the two images will be mounted at /host/image-A and /host/image-B? Might it make sense to use partition labels or something similar instead of assuming it will be mounted there?

jasonbridges force-pushed the sonie branch from 4c0798a to a4d0693 Compare May 9, 2026 01:20

jasonbridges force-pushed the sonie branch from a4d0693 to 8379619 Compare May 9, 2026 01:21

jasonbridges force-pushed the sonie branch from 8379619 to 7c38383 Compare May 9, 2026 01:29

jasonbridges force-pushed the sonie branch from 7c38383 to 20a08fb Compare May 9, 2026 01:30

jasonbridges force-pushed the sonie branch from 20a08fb to 7fb1b78 Compare May 9, 2026 02:19

jasonbridges force-pushed the sonie branch from 7fb1b78 to 25ad747 Compare May 9, 2026 02:34

jasonbridges force-pushed the sonie branch from 25ad747 to 1b127b0 Compare May 9, 2026 03:37

jasonbridges force-pushed the sonie branch from 1b127b0 to 522222b Compare May 9, 2026 03:48

jasonbridges force-pushed the sonie branch from 522222b to b0fd982 Compare May 9, 2026 04:01

jasonbridges force-pushed the sonie branch from 760fc2a to 221b2b4 Compare May 9, 2026 21:53

jasonbridges force-pushed the sonie branch from 221b2b4 to 8275d8f Compare May 9, 2026 22:16

jasonbridges force-pushed the sonie branch from 8275d8f to 54173b9 Compare May 9, 2026 22:20

jasonbridges force-pushed the sonie branch from 54173b9 to d80ec6c Compare May 9, 2026 22:41

jasonbridges force-pushed the sonie branch from d80ec6c to 82d6323 Compare May 10, 2026 00:14

jasonbridges marked this pull request as ready for review May 10, 2026 00:47

jasonbridges force-pushed the sonie branch from 82d6323 to 44eba02 Compare May 10, 2026 00:51

jasonbridges added 2 commits May 20, 2026 16:32

Add support for SONIE in sonic-installer

9401188

Change-Id: I4d4cfa6115957987e33fda2c663fcaf3d69be991

Fix installer tests and bootloader logic

5f20571

jasonbridges force-pushed the sonie branch from 44eba02 to 5f20571 Compare May 20, 2026 16:32

Merge commit 'f66ad703c1ce06f6d0cfb40035b24b7d11ce62e5' into sonie

712a00f

Change-Id: Ic923c51ded5c8343e4bf6cae2b83f3b2630c440a

saiarcot895 reviewed May 29, 2026

View reviewed changes

Conversation

jasonbridges commented May 9, 2026

Pull Request Description: Add Support for SONIE & systemd-boot Upgrades

Title

Description Body

What I did

How I did it

How to verify it

Previous command output (if the output of a command-line utility has changed)

New command output (if the output of a command-line utility has changed)

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 9, 2026

Uh oh!

azure-pipelines Bot commented May 9, 2026

Uh oh!

mssonicbld commented May 10, 2026

Uh oh!

azure-pipelines Bot commented May 10, 2026

Uh oh!

mssonicbld commented May 10, 2026

Uh oh!

azure-pipelines Bot commented May 10, 2026

Pull Request Description: Add Support for SONIE & `systemd-boot` Upgrades