Appendix D. Configuring a Host for PCI Passthrough

Configuring a Host for PCI Passthrough

1. Enable the virtualization extension and IOMMU extension in the BIOS. See Enabling Intel VT-x and AMD-V virtualization hardware extensions in BIOS in the Red Hat Enterprise Linux Virtualization Deployment and Administration Guide for more information.

2. Enable the IOMMU flag in the kernel by selecting the Hostdev Passthrough & SR-IOV check box when adding the host to the Manager or by editing the grub configuration file manually.

   • To enable the IOMMU flag from the Administration Portal, see Adding Standard Hosts to the Red Hat Virtualization Manager and Kernel Settings Explained.
   • To edit the grub configuration file manually, see Enabling IOMMU Manually.
3. For GPU passthrough, you need to run additional configuration steps on both the host and the guest system. See GPU device passthrough: Assigning a host GPU to a single virtual machine in Setting up an NVIDIA GPU for a virtual machine in Red Hat Virtualization for more information.

Enabling IOMMU Manually

1. Enable IOMMU by editing the grub configuration file.

   Note

   If you are using IBM POWER8 hardware, skip this step as IOMMU is enabled by default.

   • For Intel, boot the machine, and append intel_iommu=on to the end of the GRUB_CMDLINE_LINUX line in the grub configuration file.

     # vi /etc/default/grub
     ...
     GRUB_CMDLINE_LINUX="nofb splash=quiet console=tty0 ... intel_iommu=on
     ...

     Copy to Clipboard Toggle word wrap

   • For AMD, boot the machine, and append amd_iommu=on to the end of the GRUB_CMDLINE_LINUX line in the grub configuration file.

     # vi /etc/default/grub
     …​
     GRUB_CMDLINE_LINUX="nofb splash=quiet console=tty0 …​ amd_iommu=on
     …​

     Copy to Clipboard Toggle word wrap
     Note

     If intel_iommu=on or an AMD IOMMU is detected, you can try adding iommu=pt. The pt option only enables IOMMU for devices used in passthrough and provides better host performance. However, the option might not be supported on all hardware. Revert to the previous option if the pt option doesn’t work for your host.

     If the passthrough fails because the hardware does not support interrupt remapping, you can consider enabling the allow_unsafe_interrupts option if the virtual machines are trusted. The allow_unsafe_interrupts is not enabled by default because enabling it potentially exposes the host to MSI attacks from virtual machines. To enable the option:

     # vi /etc/modprobe.d
     options vfio_iommu_type1 allow_unsafe_interrupts=1

     Copy to Clipboard Toggle word wrap

2. Refresh the grub.cfg file and reboot the host for these changes to take effect:

   # grub2-mkconfig -o /boot/grub2/grub.cfg

   Copy to Clipboard Toggle word wrap

   # reboot

   Copy to Clipboard Toggle word wrap