proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-08-14 03:49:27 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

boot/zfs: add docs for pve-efiboot-tool

Browse Source 
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
This commit is contained in:
Fabian Grünbichler 2019-07-11 13:32:23 +02:00 committed by Thomas Lamprecht
parent 82458168d0
commit 0daaddbdc0
2 changed files with 37 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
local-zfs.adoc
View File

@ -256,6 +256,12 @@ can be used as cache.
sgdisk <healthy bootable device> -R <new device>
sgdisk -G <new device>
zpool replace -f <pool> <old zfs partition> <new zfs partition>
pve-efiboot-tool format <new disk's ESP>
pve-efiboot-tool init <new disk's ESP>
NOTE: `ESP` stands for EFI System Partition, which is setup as partition #2 on
bootable disks setup by the {pve} installer since version 5.4. For details, see
xref:sysboot_systemd_boot_setup[Setting up a new partition for use as synced ESP].
Activate E-Mail Notification

36
system-booting.adoc
View File

@ -141,17 +141,43 @@ options " > /mnt/esp/loader/entries/preferred.conf
cat /etc/kernel/cmdline >> /mnt/esp/loader/entries/preferred.conf
----
[[sysboot_systemd_boot_setup]]
.Setting up a new partition for use as synced ESP
To format and initialize a partition as synced ESP, e.g., after replacing a
failed vdev in an rpool, or when converting an existing system that pre-dates
the sync mechanism, `pve-efiboot-tool` from `pve-kernel-helpers` can be used.
WARNING: the `format` command will format the `<partition>`, make sure to pass
in the right device/partition!
For example, to format an empty partition `/dev/sda2` as ESP, run the following:
----
pve-efiboot-tool format /dev/sda2
----
To setup an existing, unmounted ESP located on `/dev/sda2` for inclusion in
{pve}'s synchronization mechanism, use the following:
----
pve-efiboot-tool init /dev/sda2
----
Afterwards `/etc/kernel/pve-efiboot-uuids` should contain a new line with the
UUID of the newly added partition. The `init` command will also automatically
trigger a refresh of all configured ESPs.
[[sysboot_systemd_boot_refresh]]
.Updating the configuration on all ESPs
To copy and configure all bootable kernels and keep all ESPs in sync you just
need to run the kernel hook script `/etc/kernel/postinst.d/zz-pve-efiboot`.
To copy and configure all bootable kernels and keep all ESPs listed in
`/etc/kernel/pve-efiboot-uuids` in sync you just need to run `pve-efiboot-tool
refresh`.
(The equivalent to running `update-grub` on Systems being booted with `grub`).
This is necessary should you make changes to the kernel commandline, or if you
want to add another ESP (e.g. when replacing a failed disk in a redundant ZFS
pool).
This is necessary should you make changes to the kernel commandline, or want to
sync all kernels and initrds after regenerating the latter.
[[sysboot_edit_kernel_cmdline]]
Editing the kernel commandline