Release Notes for Alpine 3.20.0: Difference between revisions

Revision as of 12:59, 16 April 2024

Base System

grub 2.12

When upgrading existing installations using grub on UEFI systems, make sure to update the installed bootloader before rebooting, otherwise your machine might not boot.

The problem is that grub added new configuration that executes fwsetup --is-supported. The problem is that grub 2.06 does not supported the --is-supported argument yet, causing grub to unconditionally try to reboot into firmware.

Here is an example assuming the default setup. Don't blindly copy this examples but verify what's applicable to your system.

EFI

# grub-install --target=$target --efi-directory=$efi_directory \ --bootloader-id=alpine --boot-directory=/boot --no-nvram # install -D $efi_directory/EFI/alpine/grub$fwa.efi $efi_directory/EFI/boot/boot$fwa.efi

target: The relevant target for your system
efi_directory: Either /boot/efi or /boot. Run awk '$2 ~ /boot/ && $3 ~ /fat|msdos/ { print $2 }' /proc/mounts to confirm.
fwa: The respective firmware architecture for your system

Short-term work-around

A short-term work-around to get the system bootable again is to restore the backup configuration:

cp /boot/grub/grub.cfg.back /boot/grub.cfg

This should allow you to boot the system again to fix it permanently. This will be reverted again when either grub or the kernel is updated again.

This will only work if update-grub has not been executed any more since the upgrade to grub 2.12.

@@ Line 3: / Line 3: @@
 === grub 2.12 ===
-When upgrading existing installations using grub, make sure to update the installed bootloader before rebooting, otherwise your machine might not boot.
+When upgrading existing installations using grub on UEFI systems, make sure to update the installed bootloader before rebooting, otherwise your machine might not boot.
-Here are some examples for various situations assuming default setups. Don't blindly copy these examples but verify what's applicable to your system.
+The problem is that grub added new configuration that executes <code>fwsetup --is-supported</code>. The problem is that grub 2.06 does not supported the <code>--is-supported</code> argument yet, causing grub to unconditionally try to reboot into firmware.
-Afterwards, run the <code>update-grub</code> command to update the grub configuration:
+Here is an example assuming the default setup. Don't blindly copy this examples but verify what's applicable to your system.
-{{Cmd|# update-grub}}
-==== BIOS ====
-For BIOS systems (x86 or x86_64)
-{{Cmd|# grub-install --boot-directory{{=}}/boot --target{{=}}i386-pc <var>$disk</var>}}
-; disk : The block device grub has been installed to.
 ==== EFI ====
 {{Cmd|
-  # grub-install --target{{=}}<var>$target</var> --efi-directory{{=}}"<var>$efi_directory</var>" \
+  # grub-install --target{{=}}<var>$target</var> --efi-directory{{=}}<var>$efi_directory</var> \
-     --bootloader-id{{=}}alpine --boot-directory{{=}}"/boot --no-nvram
+     --bootloader-id{{=}}alpine --boot-directory{{=}}/boot --no-nvram
   # install -D <var>$efi_directory</var>/EFI/alpine/grub<var>$fwa</var>.efi <var>$efi_directory</var>/EFI/boot/boot<var>$fwa</var>.efi
@@ Line 32: / Line 21: @@
 ; efi_directory : Either {{Path|/boot/efi}} or {{Path|/boot}}. Run <code>awk '$2 ~ /boot/ && $3 ~ /fat|msdos/ { print $2 }' /proc/mounts</code> to confirm.
 ; fwa : The respective [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/blob/master/setup-disk.in#L320-324 firmware architecture] for your system
+==== Short-term work-around ====
+A short-term work-around to get the system bootable again is to restore the backup configuration:
+{{Cmd|cp /boot/grub/grub.cfg.back /boot/grub.cfg }}
+This should allow you to boot the system again to fix it permanently. This will be reverted again when either grub or the kernel is updated again.
+This will only work if <code>update-grub</code> has not been executed any more since the upgrade to grub 2.12.