Back to bug 1322343

Who When What Removed Added
Martin Polednik 2016-03-30 10:56:15 UTC Doc Text 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.
Michal Skrivanek 2016-04-15 09:32:02 UTC CC michal.skrivanek
Target Milestone --- ovirt-3.6.6
Severity medium high
John Skeoch 2016-04-18 07:56:18 UTC CC yeylon srevivo
Yaniv Kaul 2016-04-19 08:31:38 UTC CC ykaul
Marina Kalinin 2016-05-02 17:00:32 UTC CC mkalinin
Lucy Bopf 2016-05-03 13:53:37 UTC Priority unspecified high
CC lbopf
Lucy Bopf 2016-05-05 07:01:05 UTC Status NEW ASSIGNED
Assignee rhev-docs juwu
QA Contact rhev-docs trichard
Julie 2016-05-19 05:47:23 UTC CC mpoledni
Flags needinfo?(mpoledni)
Julie 2016-05-19 05:48:01 UTC Flags needinfo?(mkalinin)
Martin Polednik 2016-05-19 07:09:48 UTC CC juwu
Flags needinfo?(mpoledni) needinfo?(mkalinin) needinfo?(juwu)
Julie 2016-06-03 06:39:20 UTC Status ASSIGNED MODIFIED
Flags needinfo?(juwu)
Lucy Bopf 2016-06-06 01:26:57 UTC Target Milestone ovirt-3.6.6 ovirt-3.6.7
Yaniv Lavi 2016-06-30 12:04:58 UTC Target Milestone ovirt-3.6.7 ovirt-3.6.8
Julie 2016-07-11 02:27:08 UTC Status MODIFIED POST
Flags needinfo?(mpoledni)
Martin Polednik 2016-07-25 11:19:07 UTC Flags needinfo?(mpoledni)
Julie 2016-07-27 04:31:50 UTC Status POST ON_QA
Tahlia Richardson 2016-08-01 05:38:31 UTC Status ON_QA VERIFIED
Yaniv Lavi 2016-08-16 12:24:03 UTC Target Milestone ovirt-3.6.8 ovirt-3.6.9
Julie 2016-08-22 21:05:57 UTC Status VERIFIED CLOSED
Resolution --- CURRENTRELEASE
Last Closed 2016-08-22 17:05:57 UTC
Marina Kalinin 2016-11-29 22:06:18 UTC Link ID Red Hat Knowledge Base (Solution) 58078
Lucy Bopf 2017-07-13 01:30:33 UTC See Also https://bugzilla.redhat.com/show_bug.cgi?id=1470382
Gil Klein 2019-04-28 13:43:42 UTC CC gklein
Red Hat One Jira (issues.redhat.com) 2021-08-30 11:42:28 UTC Link ID Red Hat Issue Tracker RHV-43169

Back to bug 1322343