From 2e0d13592fce6634d1bbeaee83adb2bad22855a7 Mon Sep 17 00:00:00 2001 From: parulin <161326115+parulin@users.noreply.github.com> Date: Fri, 1 Aug 2025 16:36:32 -0400 Subject: [PATCH] Fix some missing code blocks inside lists --- user/templates/windows/windows-qubes-4-0.rst | 7 +- user/troubleshooting/uefi-troubleshooting.rst | 71 ++++++++++--------- 2 files changed, 44 insertions(+), 34 deletions(-) diff --git a/user/templates/windows/windows-qubes-4-0.rst b/user/templates/windows/windows-qubes-4-0.rst index 489a8c11..b54f1199 100644 --- a/user/templates/windows/windows-qubes-4-0.rst +++ b/user/templates/windows/windows-qubes-4-0.rst @@ -99,9 +99,12 @@ Installation procedure: - Install on first disk. - - Windows license may be read from flash via root in dom0: - ``strings < /sys/firmware/acpi/tables/MSDM`` + - Windows license may be read from flash via root in dom0:: + + strings < /sys/firmware/acpi/tables/MSDM + Alternatively, you can also try a Windows 7 license key (as of 2018/11 they are still accepted for a free upgrade). + I first installed Windows and all updates, then entered the license key. diff --git a/user/troubleshooting/uefi-troubleshooting.rst b/user/troubleshooting/uefi-troubleshooting.rst index 05a05d7a..04204fb9 100644 --- a/user/troubleshooting/uefi-troubleshooting.rst +++ b/user/troubleshooting/uefi-troubleshooting.rst @@ -2,11 +2,9 @@ UEFI troubleshooting ==================== - Successfully installed in legacy mode, but had to change some xen parameters ---------------------------------------------------------------------------- - **Note**: If you make changes, you must boot from “Partition 1” explicitly from UEFI boot menu. **Change the xen configuration on a USB media** @@ -19,14 +17,10 @@ Successfully installed in legacy mode, but had to change some xen parameters vi EFI/BOOT/grub.cfg - - 3. Change the ``multiboot2 /images/pxeboot/xen.gz`` line to add your xen parameters on the boot entry of your choice 4. Install using your modified boot entry - - **Change xen configuration directly in an iso image** 1. Set up a loop device (replacing ``X`` with your ISO’s version name): ``losetup -P /dev/loop0 Qubes-RX-x86_64.iso`` @@ -37,24 +31,19 @@ Successfully installed in legacy mode, but had to change some xen parameters 4. Save your changes, unmount and dd to usb device - - Installation freezes before displaying installer ------------------------------------------------ - If you have an Nvidia card, see also `Nvidia Troubleshooting `__. Installation from USB stick hangs on black screen ------------------------------------------------- - Some laptops cannot read from an external boot device larger than 8GB. If you encounter a black screen when performing an installation from a USB stick, ensure you are using a USB drive less than 8GB, or a partition on that USB lesser than 8GB and of format FAT32. Installation completes successfully but then system crash/restarts on next boot ------------------------------------------------------------------------------- - Some Dell systems and probably others have `another bug in UEFI firmware `__. These systems need ``efi=attr=uc`` enabled at all times. Although this is enabled by default in the installer, it is disabled after the first stage of a successful install. You can re-enable it either as part of the install process: 1. Perform installation normally, but don’t reboot the system at the end yet. @@ -67,21 +56,36 @@ Some Dell systems and probably others have `another bug in UEFI firmware ` 2. Press ‘3’ to go to the shell -3. Find and mount the EFI system partition. (replace ``/dev/sda`` with your disk name. If unsure, use the ``lsblk`` command to display a list of disks): ``fdisk -l /dev/sda | grep EFI`` The output should look like this: ``/dev/sda1 2048 1230847 1228800 600M EFI System`` Then mount it: ``mkdir -p /mnt/sysimage/boot/efi mount /dev/sda1 /mnt/sysimage/boot/efi`` +3. Find and mount the EFI system partition. (replace ``/dev/sda`` with your disk + name. If unsure, use the ``lsblk`` command to display a list of disks): + + .. code:: console + + fdisk -l /dev/sda | grep EFI + + The output should look like this: + + .. code:: output + + /dev/sda1 2048 1230847 1228800 600M EFI System + + Then mount it: + + .. code:: console + + mkdir -p /mnt/sysimage/boot/efi mount /dev/sda1 /mnt/sysimage/boot/efi + + 4. Execute: @@ -89,25 +93,38 @@ Or if you have already rebooted after the first stage install and have encounter sed -i -e 's/ucode=scan/\0 efi=attr=uc/' /mnt/sysimage/boot/efi/EFI/qubes/grub.cfg - - 5. Type ``reboot``. 6. Continue with setting up default templates and logging in to Qubes. - - Boot device not recognized after installing ------------------------------------------- - Some firmware will not recognize the default Qubes EFI configuration. As such, it will have to be manually edited to be bootable. 1. Boot Qubes OS install media into :ref:`rescue mode ` 2. Press ‘3’ to go to the shell -3. Find and mount the EFI system partition. (replace ``/dev/sda`` with your disk name. If unsure, use the ``lsblk`` command to display a list of disks): ``fdisk -l /dev/sda | grep EFI`` The output should look like this: ``/dev/sda1 2048 1230847 1228800 600M EFI System`` Then mount it: ``mkdir -p /mnt/sysimage/boot/efi mount /dev/sda1 /mnt/sysimage/boot/efi`` +3. Find and mount the EFI system partition. (replace ``/dev/sda`` with your disk name. If unsure, use the ``lsblk`` command to display a list of disks): + + .. code:: console + + fdisk -l /dev/sda | grep EFI + + The output should look like this: + + .. code:: output + + /dev/sda1 2048 1230847 1228800 600M EFI System + + Then mount it: + + .. code:: console + + mkdir -p /mnt/sysimage/boot/efi mount /dev/sda1 /mnt/sysimage/boot/efi + + 4. Copy ``grubx64.efi`` to the fallback path: @@ -115,16 +132,11 @@ Some firmware will not recognize the default Qubes EFI configuration. As such, i cp /mnt/sysimage/boot/efi/EFI/qubes/grubx64.efi /mnt/sysimage/boot/efi/EFI/BOOT/bootx64.efi - - 5. Type ``reboot`` - - "Qubes" boot option is missing after removing / attaching a disk or updating the BIOS ------------------------------------------------------------------------------------- - 1. Boot Qubes OS install media into :ref:`rescue mode ` 2. Press ‘3’ to go to the shell @@ -135,12 +147,7 @@ Some firmware will not recognize the default Qubes EFI configuration. As such, i efibootmgr -v -c -u -L Qubes -l /EFI/qubes/grubx64.efi -d /dev/sda -p 1 - - - - Accessing installer Rescue mode on UEFI --------------------------------------- - Choose “Rescue a Qubes OS system” from grub2 boot menu.