Skip to content

Commit df4324c

Browse files
authored
chore(node): Add grub-upgrader readme (#8191)
NODE-1712
1 parent a76f777 commit df4324c

File tree

1 file changed

+17
-0
lines changed
  • ic-os/components/hostos/misc/grub-upgrader

1 file changed

+17
-0
lines changed
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# GRUB Upgrader
2+
3+
`grub-upgrader` propagates GRUB configuration updates from the boot partition
4+
to the GRUB partition after IC-OS upgrades.
5+
6+
## How It Works
7+
8+
HostOS and GuestOS upgrade images include the latest `grub.cfg` on the boot partition (`/boot/grub.cfg`),
9+
but GRUB reads from the GRUB partition (`/boot/grub/grub.cfg`).
10+
This service syncs them by copying `/boot/grub.cfg` to `/boot/grub/grub.cfg`.
11+
12+
## ⚠️ Backwards Compatibility
13+
14+
If enabling this service, ensure the latest `grub.cfg` is backwards
15+
compatible with existing GRUB EFI binaries on mainnet.
16+
This service only updates the config file—not the GRUB EFI binary.
17+
New syntax unsupported by older GRUB versions may cause boot failures.

0 commit comments

Comments
 (0)