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 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 system/motherboard in the future without having to rebuild the pool (and
restore your data from a backup). Additionally, this is used for 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:: 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 size (given the partition size of 512 MiB) for FAT32. It also works fine on
drives which present 512 B sectors. 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:: 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 echo /boot/efi/grub /boot/grub none defaults,bind 0 0 >> /etc/fstab
mount /boot/grub mount /boot/grub
**Note:** This puts ``/boot/grub`` on the EFI System Partition. This allows This allows GRUB to write to ``/boot/grub`` (since it is on a FAT-formatted
GRUB to write to it, which means that ``/boot/grub/grubenv`` and the ESP instead of on ZFS), which means that ``/boot/grub/grubenv`` and the
``recordfail`` feature works as expected: if the boot fails, the normally ``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 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 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`` able to write to ``/boot/grub/grubenv`` and thus the ``recordfail``
behavior. behavior.
#. Install GRUB/Linux/ZFS in the chroot environment for the new system:
Choose one of the following options: Choose one of the following options:
- Install GRUB/Linux/ZFS for legacy (BIOS) booting:: - Install GRUB/Linux/ZFS for legacy (BIOS) booting::