proxmox-boot-tool is a utility used to maintain the contents of the EFI System
Partitions correctly configured and synchronized. It copies sure kernel
variations to all ESPs and configures the respective bootloader besides from
the vfat formatted ESPs. Within the context of ZFS as root filesystem this implies
that you should utilize all optionally available options in your root pool as an alternative of the subset
which can also be current within the ZFS implementation in GRUB or having to create a
separate small boot-pool .
In setups with redundancy all disks are partitioned with an ESP, by the
installer. This ensures the system boots even when the primary boot gadget fails
or if the BIOS can solely boot from a selected disk.
The ESPs aren’t saved mounted throughout common operation. This helps to forestall
filesystem corruption to the vfat formatted ESPs in case of a system crash,
and removes the necessity to manually adapt /and so forth/fstab in case the first boot
gadget fails.
proxmox-boot-tool handles the next duties:
-
formatting and organising a brand new partition -
copying and configuring new kernel pictures and initrd pictures to all listed ESPs -
synchronizing the configuration on kernel upgrades and different upkeep duties -
managing the record of kernel variations that are synchronized -
configuring the boot-loader besides a selected kernel model (pinning)
You possibly can view the presently configured ESPs and their state by working:
# proxmox-boot-tool standing
Organising a brand new partition to be used as synced ESP
To format and initialize a partition as synced ESP, e.g., after changing a
failed vdev in an rpool, or when changing an current system that pre-dates
the sync mechanism, proxmox-boot-tool from proxmox-kernel-helper can be utilized.
|
the format command will format the <partition>, make certain to go
in the appropriate gadget/partition! |
For instance, to format an empty partition /dev/sda2 as ESP, run the next:
# proxmox-boot-tool format /dev/sda2
To setup an current, unmounted ESP situated on /dev/sda2 for inclusion in
Proxmox VE’s kernel replace synchronization mechanism, use the next:
# proxmox-boot-tool init /dev/sda2
# proxmox-boot-tool init /dev/sda2 grub
to drive initialization with GRUB as an alternative of systemd-boot, for instance for
Safe Boot assist.
Afterwards /and so forth/kernel/proxmox-boot-uuids ought to include a brand new line with the
UUID of the newly added partition. The init command can even routinely
set off a refresh of all configured ESPs.
Updating the configuration on all ESPs
To repeat and configure all bootable kernels and maintain all ESPs listed in
/and so forth/kernel/proxmox-boot-uuids in sync you simply have to run:
# proxmox-boot-tool refresh
(The equal to working update-grub techniques with ext4 or xfs on root).
That is obligatory must you make adjustments to the kernel commandline, or wish to
sync all kernels and initrds.
|
Each update-initramfs and apt (when obligatory) will routinely
set off a refresh. |
Kernel Variations thought-about by proxmox-boot-tool
The next kernel variations are configured by default:
-
the presently working kernel -
the model being newly put in on package deal updates -
the 2 newest already put in kernels -
the most recent model of the second-to-last kernel collection (e.g. 5.0, 5.3), if relevant -
any manually chosen kernels
Manually preserving a kernel bootable
Do you have to want to add a sure kernel and initrd picture to the record of
bootable kernels use proxmox-boot-tool kernel add.
For instance run the next so as to add the kernel with ABI model 5.0.15-1-pve
to the record of kernels to maintain put in and synced to all ESPs:
# proxmox-boot-tool kernel add 5.0.15-1-pve
proxmox-boot-tool kernel record will record all kernel variations presently chosen
for booting:
# proxmox-boot-tool kernel record Manually chosen kernels: 5.0.15-1-pve Routinely chosen kernels: 5.0.12-1-pve 4.15.18-18-pve
Run proxmox-boot-tool kernel take away to take away a kernel from the record of
manually chosen kernels, for instance:
# proxmox-boot-tool kernel take away 5.0.15-1-pve
|
|
It’s required to run proxmox-boot-tool refresh to replace all EFI System
Partitions (ESPs) after a handbook kernel addition or removing from above. |
