proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-08-14 10:59:30 +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 <healthy bootable device> -R <new device>
sgdisk -G <new device> sgdisk -G <new device>
zpool replace -f <pool> <old zfs partition> <new zfs partition> 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 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 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]] [[sysboot_systemd_boot_refresh]]
.Updating the configuration on all ESPs .Updating the configuration on all ESPs
To copy and configure all bootable kernels and keep all ESPs in sync you just To copy and configure all bootable kernels and keep all ESPs listed in
need to run the kernel hook script `/etc/kernel/postinst.d/zz-pve-efiboot`. `/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`). (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 This is necessary should you make changes to the kernel commandline, or want to
want to add another ESP (e.g. when replacing a failed disk in a redundant ZFS sync all kernels and initrds after regenerating the latter.
pool).
[[sysboot_edit_kernel_cmdline]] [[sysboot_edit_kernel_cmdline]]
Editing the kernel commandline Editing the kernel commandline