diff --git a/troubleshooting/uefi-troubleshooting.md b/troubleshooting/uefi-troubleshooting.md index f2882422..f4b71aa3 100644 --- a/troubleshooting/uefi-troubleshooting.md +++ b/troubleshooting/uefi-troubleshooting.md @@ -8,38 +8,37 @@ 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](http://xen.markmail.org/message/f6lx2ab4o2fch35r), affecting mostly Lenovo systems, but probably some others too. You can try existing workaround: -1. In GRUB menu[1](#f1) 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: +01. In GRUB menu[1](#f1) press `e`. +02. At the end of `chainloader` line add `/mapbs /noexitboot`. +03. Perform installation normally, but not reboot system at the end yet. +04. Go to `tty2` (Ctrl-Alt-F2). +05. Enable `/mapbs /noexitboot` on just installed system. This step differs between Qubes releases: - * for Qubes 3.1: + **For Qubes 3.1:** - 5. Execute `mount | grep boot/efi` and note device name (first column). It should be something like `/dev/sda1`. - 6. Execute `efibootmgr -v`, search for `Qubes` entry and note its number (it should be something like `Boot0001` - `0001` is an entry number). - 7. 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): +06. Execute `mount | grep boot/efi` and note device name (first column). It should be something like `/dev/sda1`. +07. Execute `efibootmgr -v`, search for `Qubes` entry and note its number (it should be something like `Boot0001` - `0001` is an entry number). +08. 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" + efibootmgr -b XXXX -B + efibootmgr -v -c -u -L Qubes -l /EFI/qubes/xen.efi -d /dev/sda -p 1 "placeholder /mapbs /noexitboot" - 8. Compare new entry with the old one (printed in step 6) - it should only differ in additional options at the end. - 9. Now you can reboot the system by issuing `reboot` command. +09. 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: + **For Qubes 3.2 or later:** - 5. Edit `/mnt/sysimage/boot/efi/EFI/qubes/xen.cfg` (you can use `vi` editor) and add to every kernel section: +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 + mapbs=1 + noexitboot=1 - 9. Now you can reboot the system by issuing `reboot` command. +12. Now you can reboot the system by issuing `reboot` command. System crash/restart when booting installer