#604 Add warning to upgrading for UEFI-based systems
Merged 11 months ago by hankuoffroad. Opened 11 months ago by mixwui.
fedora-docs/ mixwui/quick-docs mwu/add-upgrade-warning-for-uefi  into  main

@@ -0,0 +1,11 @@ 

+ [[discovering-the-firmware-type]]

+ = Discovering the firmware type

+ 

+ To discover what firmware your machine uses, run the following command:

+ 

+ [source,bash]

+ ----

+ $ [ -d /sys/firmware/efi ] && echo UEFI || echo BIOS

+ ----

+ 

+ The output returns only UEFI or BIOS, depending on the firmware your machine runs.

@@ -11,6 +11,8 @@ 

  

  Since Fedora 16, *GRUB2* has been the default bootloader on x86 BIOS systems. For upgrades of BIOS systems, the default is also to install *GRUB2*, but you can opt to skip bootloader configuration entirely.

  

+ include::{partialsdir}/proc_discovering-the-firmware-type.adoc[leveloffset=+1]

+ 

  include::{partialsdir}/proc_installing-grub2-on-bios-system.adoc[leveloffset=+1]

  

  include::{partialsdir}/proc_installing-grub2-on-efi-system.adoc[leveloffset=+1]

@@ -120,7 +120,7 @@ 

  [[sect-update-grub-bootloader-on-bios]]

  === Update GRUB bootloader on BIOS systems

  

- Systems with the BIOS firmware have the GRUB RPM packages updated. However, the installed or embedded bootloader is never updated automatically. It is a good idea to update it between Fedora release versions.

+ Systems with the link:++https://docs.fedoraproject.org/en-US/quick-docs/installing-grub2/#installing-grub-2-on-a-bios-system++[BIOS firmware] have the GRUB RPM packages updated. However, the installed or embedded bootloader is never updated automatically. It is a good idea to update it between Fedora release versions.

  

  Find the device node the `/boot/` directory is located on:

  

@@ -26,6 +26,8 @@ 

  systems. For upgrades of BIOS systems, the default is also to install

  *GRUB2*, but you can opt to skip bootloader configuration entirely.

  

+ include::{partialsdir}/proc_discovering-the-firmware-type.adoc[leveloffset=+1]

+ 

  include::{partialsdir}/proc_installing-grub2-on-bios-system.adoc[leveloffset=+1]

  

  include::{partialsdir}/proc_installing-grub2-on-efi-system.adoc[leveloffset=+1]

Add warning to ensure users don't accidentally run grub2-install on UEFI systems.

I'm not sure if it's needed as the section already states it's for BIOS systems, but I almost blindly ran it before I verified that my system was actually UEFI.

@mixwui thanks for your input. The section of dnf upgrade process is about "Update GRUB bootloader on BIOS systems".

Your suggestion to run the command to check if the system is UEFI or BIOS seems out of place.
And it is followed by grub2 wiki. Not sure if the warning is really necessary here.

If the link needs to be referenced, we recommend the official Docs article to link, rather than wiki page.

-1

2 new commits added

  • Add discovering the firmware type for grub2
  • Link to quick-docs/installing-grub2
11 months ago

Thanks for the feedback @hankuoffroad -- I've updated the PR.

This deprecated page has the UEFI/BIOS check command, but its quick docs replacement doesn't, so I've added it as I think it's helpful.

I've also linked "BIOS Firmware" in "Update GRUB bootloader on BIOS systems" to "Installing GRUB2 on a BIOS system".

With the combination of the linked page/section and the section on how to check if the system is UEFI or BIOS directly above it, I think that solves the original issue well enough.

Pull-Request has been merged by hankuoffroad

11 months ago