Bug 1322343

Hardware considerations for implementing SR-IOV -> rename to Hardware considerations for PCI passthrough Switch chapter 1 and 2 (make sure the wording is fine) CHAPTER 1. HARDWARE CONSIDERATIONS FOR USING PCI PASSTHROUGH Append paragraph describing GPU support - copy/reword 1st paragraph of https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Virtualization_Deployment_and_Administration_Guide/sect-device-GPU.html Installation Guide New section after 8 (Red Hat Enterprise Linux Hosts): Configuring hypervisor for PCI passthrough 0) Enable VT-d or AMD-Vi in BIOS 1) Enable IOMMU (/etc/default/grub) Can be skipped on POWER platform. Mention difference in grub editing - RHEL vs RHEV-H (https://access.redhat.com/solutions/294393) 1.1) Intel RHEL: GRUB_CMDLINE_LINUX="nofb splash=quiet console=tty0 ... intel_iommu=on" RHEV-H: kernel /vmlinuz-2.6.32-279.19.1.el6.x86_64.debug ro rhgb quiet ... intel_iommu=on 1.2) AMD RHEL: GRUB_CMDLINE_LINUX="nofb splash=quiet console=tty0 ... amd_iommu=on" RHEV-H: kernel /vmlinuz-2.6.32-279.19.1.el6.x86_64.debug ro rhgb quiet ... amd_iommu=on 1.4) Possible alternative: [intel/amd]_iommu=pt Benefits: only enables IOMMU for devices used in passthrough, possibility of better host performance Pitfalls: may not work on all hosts To consider: try with [intel/amd]_iommu=on, after successful setup try [intel/amd]_iommu=pt - use the later if everything works, revert to former if not 2) (troubleshooting) Mention to ignore this section UNLESS something breaks when assigning devices to a VM/VM doesn't start 2.1) allow_unsafe_interrupts Mention interrupt remaping https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Virtualization_Deployment_and_Administration_Guide/chap-Guest_virtual_machine_device_configuration.html#sect-PCI_devices-Assigning_a_PCI_device_with_virsh (copy/reword the first note) 3) GPU passthrough Copy section "GPU Passthrough" from http://www.ovirt.org/develop/release-management/features/engine/hostdev-passthrough/ note: Make sure to specify GPU vendor when mentioning blacklisting the driver (rdblacklist=nouveau is for NVIDIA). Also try to keep the organization as follows: - finding device vendor:product id - appending to cmdline (pci-stub.ids) - blacklisting nouveau in case NVIDIA is used Ignore guest side and verification in this part of the guide. 4) Regenerate GRUB not required in RHEV-H grub2-mkconfig -o /boot/grub2/grub.cfg 5) Reboot the host - In case of GPU passthrough, (use verify section from link in 3)) Virtual Machine Management Guide Chapter 6.9 Host Devices 2nd paragraph (currently linking to RHEL documentation) -> reword and refer to updated installation guide 3rd paragraph -> refer to renamed Hardware considerations for PCI passthrough New paragraph after 6.9.1 (Adding a Host Device to a Virtual Machine): Guest Operating System setup for GPU passthrough (or better name), needs to contain following points: - Linux guest -> only proprietary GPU drivers are supported -> open source drivers must be blacklisted (GPU passthrough -> guest side of http://www.ovirt.org/develop/release-management/features/engine/hostdev-passthrough/#GPU_Passthrough) - make sure to differentiate GPU vendor -> xorg must be configured (https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Virtualization_Deployment_and_Administration_Guide/sect-device-GPU.html last 3 paragraphs) - Windows guest Install the virtual machine using only a SPICE or VNC console. After the installation is complete, install the correct drivers for the device and restart the virtual machine. If the GPU output is to be used, use the Windows display settings to configure the physical screen connected to the GPU as either a extension, mirror, or single screen of the operating system.