From 780f029dd3aa24eb094f90e8d064100818dda9d9 Mon Sep 17 00:00:00 2001 From: Richard Laager Date: Sat, 30 May 2020 00:28:17 -0500 Subject: [PATCH] Ubuntu 20.04: Separate /boot/grub ESP step The previous "Install GRUB/Linux/ZFS in the chroot..." step had two conditionals ("For a single-disk install only" and "Choose one..."). It was not clear to readers if these were mutually exclusive. Signed-off-by: Richard Laager Reported-by: Larry Wagner --- .../Ubuntu/Ubuntu 20.04 Root on ZFS.rst | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst b/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst index 46423f8..004e331 100644 --- a/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst +++ b/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst @@ -210,7 +210,8 @@ Step 2: Disk Formatting booting, this will allow you to move the disk(s) to a new system/motherboard in the future without having to rebuild the pool (and restore your data from a backup). Additionally, this is used for - ``/boot/grub`` in single-disk scenarios, as discussed below. + ``/boot/grub`` in single-disk scenarios, as :ref:`discussed below + `. For legacy (BIOS) booting:: @@ -653,7 +654,9 @@ Step 4: System Configuration size (given the partition size of 512 MiB) for FAT32. It also works fine on drives which present 512 B sectors. -#. Install GRUB/Linux/ZFS in the chroot environment for the new system: +#. Put ``/boot/grub`` on the EFI System Partition: + + .. _boot-grub-esp: For a single-disk install only:: @@ -661,8 +664,8 @@ Step 4: System Configuration echo /boot/efi/grub /boot/grub none defaults,bind 0 0 >> /etc/fstab mount /boot/grub - **Note:** This puts ``/boot/grub`` on the EFI System Partition. This allows - GRUB to write to it, which means that ``/boot/grub/grubenv`` and the + This allows GRUB to write to ``/boot/grub`` (since it is on a FAT-formatted + ESP instead of on ZFS), which means that ``/boot/grub/grubenv`` and the ``recordfail`` feature works as expected: if the boot fails, the normally hidden GRUB menu will be shown on the next boot. For a mirror or raidz topology, we do not want GRUB writing to the EFI System Partition. This is @@ -673,6 +676,8 @@ Step 4: System Configuration able to write to ``/boot/grub/grubenv`` and thus the ``recordfail`` behavior. +#. Install GRUB/Linux/ZFS in the chroot environment for the new system: + Choose one of the following options: - Install GRUB/Linux/ZFS for legacy (BIOS) booting::