jacobpascual/openzfs-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Ubuntu 20.04: Separate /boot/grub ESP step

Browse Source 
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 <rlaager@wiktel.com>
Reported-by: Larry Wagner <larrywagner0@gmail.com>
This commit is contained in:
Richard Laager
2020-05-30 00:28:17 -05:00
parent 73be195834
commit 780f029dd3
1 changed files with 9 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst
View File

@@ -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
<boot-grub-esp>`.
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::