Refer to the bootloader chapter in remaining docs

Editing the kernel commandline is described centrally in the bootloaders
chapter. Refer to it where appropriate (qm-pci-passthrough.adoc).

Additionally update the documentation on ZFS as rpool to the inclusion of
`systemd-boot`

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
This commit is contained in:
Stoiko Ivanov 2019-07-10 14:40:17 +02:00 committed by Thomas Lamprecht
parent 62de1c14a7
commit 1748211a7e
2 changed files with 21 additions and 25 deletions

View File

@ -154,15 +154,9 @@ rpool/swap 4.25G 7.69T 64K -
Bootloader Bootloader
~~~~~~~~~~ ~~~~~~~~~~
The default ZFS disk partitioning scheme does not use the first 2048 Depending on whether the system is booted in EFI or legacy BIOS mode the
sectors. This gives enough room to install a GRUB boot partition. The {pve} installer sets up either `grub` or `systemd-boot` as main bootloader.
{pve} installer automatically allocates that space, and installs the See the chapter on xref:system_booting[bootladers] for details.
GRUB boot loader there. If you use a redundant RAID setup, it installs
the boot loader on all disk required for booting. So you can boot
even if some disks fail.
NOTE: It is not possible to use ZFS as root file system with UEFI
boot.
ZFS Administration ZFS Administration
@ -255,7 +249,13 @@ can be used as cache.
.Changing a failed device .Changing a failed device
zpool replace -f <pool> <old device> <new-device> zpool replace -f <pool> <old device> <new device>
.Changing a failed bootable device when using systemd-boot
sgdisk <healthy bootable device> -R <new device>
sgdisk -G <new device>
zpool replace -f <pool> <old zfs partition> <new zfs partition>
Activate E-Mail Notification Activate E-Mail Notification

View File

@ -45,9 +45,10 @@ some configuration to enable PCI(e) passthrough.
.IOMMU .IOMMU
The IOMMU has to be activated on the kernel commandline. The easiest way is to The IOMMU has to be activated on the
enable trough grub. Edit `'/etc/default/grub'' and add the following to the xref:edit_kernel_cmdline[kernel commandline].
'GRUB_CMDLINE_LINUX_DEFAULT' variable:
The command line parameters are:
* for Intel CPUs: * for Intel CPUs:
+ +
@ -60,12 +61,6 @@ enable trough grub. Edit `'/etc/default/grub'' and add the following to the
amd_iommu=on amd_iommu=on
---- ----
[[qm_pci_passthrough_update_grub]]
To bring this change in effect, make sure you run:
----
# update-grub
----
.Kernel Modules .Kernel Modules
@ -87,6 +82,9 @@ After changing anything modules related, you need to refresh your
# update-initramfs -u -k all # update-initramfs -u -k all
---- ----
If you are using `systemd-boot` make sure to
xref:systemd-boot-refresh[sync the new initramfs to the bootable partitions].
.Finish Configuration .Finish Configuration
Finally reboot to bring the changes into effect and check that it is indeed Finally reboot to bring the changes into effect and check that it is indeed
@ -316,10 +314,9 @@ Intels drivers for GVT-g are integrated in the Kernel and should work
with 5th, 6th and 7th generation Intel Core Processors, as well as E3 v4, E3 with 5th, 6th and 7th generation Intel Core Processors, as well as E3 v4, E3
v5 and E3 v6 Xeon Processors. v5 and E3 v6 Xeon Processors.
To enable it for Intel Graphcs, you have to make sure to load the module 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 Kernel 'kvmgt' (for example via `/etc/modules`) and to enable it on the
commandline. For this you can edit `'/etc/default/grub'' and add the following xref:edit_kernel_cmdline[Kernel commandline] and add the following parameter:
to the 'GRUB_CMDLINE_LINUX_DEFAULT' variable:
---- ----
i915.enable_gvt=1 i915.enable_gvt=1
@ -327,8 +324,7 @@ to the 'GRUB_CMDLINE_LINUX_DEFAULT' variable:
After that remember to After that remember to
xref:qm_pci_passthrough_update_initramfs[update the `initramfs`], xref:qm_pci_passthrough_update_initramfs[update the `initramfs`],
xref:qm_pci_passthrough_update_grub[update grub] and and reboot your host.
reboot your host.
VM Configuration VM Configuration
^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^