Git-Mirrors/qubes-doc
1
0
Fork 0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2024-10-01 01:25:40 -04:00
Code Issues Packages Projects Releases Wiki Activity
ab15b144f8
qubes-doc/troubleshooting/uefi-troubleshooting.md
Andrew David Wong 49603789d2
Clarify how to add parameters to xen.cfg 
Thank you to Jeremy Rand for clarifying this step of the instructions:

https://groups.google.com/d/msg/qubes-users/VeqDPHiaKwM/j4xt1lSOCAAJ
2016-06-27 12:22:42 -07:00

2.9 KiB
Raw Blame History

layout title permalink
doc UEFI Troubleshooting /doc/uefi-troubleshooting/

Troubleshooting UEFI related problems

Cannot start installation, hangs at four penguins after choosing "Test media and install Qubes OS" in GRUB menu

There is some common bug in UEFI implementation, affecting mostly Lenovo systems, but probably some others too. You can try existing workaround:

  1. In GRUB menu1 press e.

  2. At the end of chainloader line add /mapbs /noexitboot.

  3. Perform installation normally, but not reboot system at the end yet.

  4. Go to tty2 (Ctrl-Alt-F2).

  5. Enable /mapbs /noexitboot on just installed system. This step differs between Qubes releases:

    For Qubes 3.1:

  6. Execute mount | grep boot/efi and note device name (first column). It should be something like /dev/sda1.

  7. Execute efibootmgr -v, search for Qubes entry and note its number (it should be something like Boot0001 - 0001 is an entry number).

  8. Replace existing Qubes entry with modified one. Replace XXXX with entry number from previous step, /dev/sda with your disk name and -p 1 with /boot/efi partition number):

    efibootmgr -b XXXX -B
efibootmgr -v -c -u -L Qubes -l /EFI/qubes/xen.efi -d /dev/sda -p 1 "placeholder /mapbs /noexitboot"

  9. Compare new entry with the old one (printed in step 6) - it should only differ in additional options at the end.

  10. Now you can reboot the system by issuing reboot command.

    For Qubes 3.2 or later:

  11. Edit /mnt/sysimage/boot/efi/EFI/qubes/xen.cfg (you can use vi editor) and add to every kernel section:

    mapbs=1
noexitboot=1

    Note: You must add these parameters on two separate new lines (one paramater on each line) at the end of each section that includes a kernel line (i.e., all sections except the first one, since it doesn't have a kernel line).

  12. Now you can reboot the system by issuing reboot command.

System crash/restart when booting installer

Some Dell systems and probably others have another bug in UEFI firmware. And there is another workaround for it:

  1. In GRUB menu1 press e.

  2. At the end of chainloader line add -- efi=attr=uc.

  3. Perform installation normally, but not reboot system at the end yet.

  4. Go to tty2 (Ctrl-Alt-F2).

  5. Execute:

     sed -i -e 's/^options=.*/\0 efi=attr=uc' /mnt/sysimage/boot/efi/qubes/xen.cfg

  6. Now you can reboot the system by issuing reboot command.

1 If you use rEFInd, you can see 3 options regarding the USB installer. Choose "Fallback Boot Loader" to enter the GRUB menu. ↩ ↩