Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
Depending on whether the system is booted in EFI or legacy BIOS mode the
{pve} installer sets up either `grub` or `systemd-boot` as main bootloader.
Depending on whether the system is booted in EFI or legacy BIOS mode the
{pve} installer sets up either `grub` or `systemd-boot` as main bootloader.
-See the chapter on xref:system_booting[bootladers] for details.
+See the chapter on xref:sysboot[{pve} host bootladers] for details.
.IOMMU
The IOMMU has to be activated on the
.IOMMU
The IOMMU has to be activated on the
-xref:edit_kernel_cmdline[kernel commandline].
+xref:sysboot_edit_kernel_cmdline[kernel commandline].
The command line parameters are:
The command line parameters are:
----
If you are using `systemd-boot` make sure to
----
If you are using `systemd-boot` make sure to
-xref:systemd-boot-refresh[sync the new initramfs to the bootable partitions].
+xref:sysboot_systemd_boot_refresh[sync the new initramfs to the bootable partitions].
To enable it for Intel Graphics, you have to make sure to load the module
'kvmgt' (for example via `/etc/modules`) and to enable it on the
To enable it for Intel Graphics, you have to make sure to load the module
'kvmgt' (for example via `/etc/modules`) and to enable it on the
-xref:edit_kernel_cmdline[Kernel commandline] and add the following parameter:
+xref:sysboot_edit_kernel_cmdline[Kernel commandline] and add the following parameter:
-[[system_booting]]
-Bootloaders
------------
+[[sysboot]]
+Host Bootloader
+---------------
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]
-{pve} uses one of two bootloaders depending on the disk setup selected in the
-installer.
+{pve} currently uses one of two bootloaders depending on the disk setup
+selected in the installer.
For EFI Systems installed with ZFS as the root filesystem `systemd-boot` is
used. All other deployments use the standard `grub` bootloader (this usually
also applies to systems which are installed on top of Debian).
For EFI Systems installed with ZFS as the root filesystem `systemd-boot` is
used. All other deployments use the standard `grub` bootloader (this usually
also applies to systems which are installed on top of Debian).
-[[installer_partitioning_scheme]]
+[[sysboot_installer_part_scheme]]
Partitioning scheme used by the installer
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Partitioning scheme used by the installer
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Partition of all bootable disks for supporting older systems.
Partition of all bootable disks for supporting older systems.
+[[sysboot_systemd_boot]]
Systemd-boot
~~~~~~~~~~~~
Systemd-boot
~~~~~~~~~~~~
corruption to the `vfat` formatted ESPs in case of a system crash, and removes
the need to manually adapt `/etc/fstab` in case the primary boot device fails.
corruption to the `vfat` formatted ESPs in case of a system crash, and removes
the need to manually adapt `/etc/fstab` in case the primary boot device fails.
+[[sysboot_systemd_boot_config]]
Configuration
^^^^^^^^^^^^^
Configuration
^^^^^^^^^^^^^
-[[systemd-boot-refresh]]
+[[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
.Updating the configuration on all ESPs
To copy and configure all bootable kernels and keep all ESPs in sync you just
want to add another ESP (e.g. when replacing a failed disk in a redundant ZFS
pool).
want to add another ESP (e.g. when replacing a failed disk in a redundant ZFS
pool).
+[[sysboot_edit_kernel_cmdline]]
Editing the kernel commandline
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Editing the kernel commandline
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The kernel commandline needs to be placed as line in `/etc/kernel/cmdline`
Running `/etc/kernel/postinst.d/zz-pve-efiboot` sets it as `option` line for
all config files in `loader/entries/proxmox-*.conf`.
The kernel commandline needs to be placed as line in `/etc/kernel/cmdline`
Running `/etc/kernel/postinst.d/zz-pve-efiboot` sets it as `option` line for
all config files in `loader/entries/proxmox-*.conf`.