Bug 1285799

Summary:	[RFE] - Document hostdev_passthrough and VFIO features in RHEV administration guide.
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Nisim Simsolo <nsimsolo>
Component:	Documentation	Assignee:	Andrew Burden <aburden>
Status:	CLOSED CURRENTRELEASE	QA Contact:	rhev-docs <rhev-docs>
Severity:	high	Docs Contact:
Priority:	high
Version:	3.6.1	CC:	adahms, gklein, lbopf, lsurette, nsimsolo, rbalakri, yeylon, ylavi
Target Milestone:	ovirt-3.6.4	Keywords:	FutureFeature
Target Release:	3.6.1
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Enhancement
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-03-16 14:17:30 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	Docs	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	825045, 1154205, 1172230

Description Nisim Simsolo 2015-11-26 13:56:58 UTC

Description of problem:
In order to use both hostdev_passthrough and VFIO features, there are some limitations and preparations that needs to be documented.
Limitations example: host BIOS must support Intel vt-d or AMD-vi and host kernel should be >= 3.6
Setup preparation example: IOMMU support should be enabled, host GPU vendor:device ids should be added to pci-stub and GPU driver should be blacklisted.

Also, webadmin procedure for these features and feature limitations should be documented in the admin guide.


Additional info:
oVirt feature page: http://www.ovirt.org/Features/hostdev_passthrough#GPU_passthrough

Comment 2 Lucy Bopf 2016-01-27 04:15:58 UTC

Assigning to Andrew for review.

Comment 3 Lucy Bopf 2016-02-16 03:56:45 UTC

*** Bug 1247578 has been marked as a duplicate of this bug. ***

Comment 4 Andrew Burden 2016-02-25 02:50:24 UTC

This is going to involve new topics in the VMM and Admin Guide to cover the new GUI elements, and an admonition to VM migration topics in the VMM guide (those marked with * are still wip)

VMM Guide:
New topics: 
New section - Host Devices (in Administrative Tasks)
-*Device Passthrough concept - link to hardware considerations art.
-*Additional requirements for GPU passthrough (probably concept + proc.)
-Adding a Host Device to a Virtual Machine
-Removing Host Devices from a Virtual Machine
-Pinning a Virtual Machine to Another Host

Admonition added to:
-Preventing Automatic Migration of a Virtual Machine

Admin Guide:
New topic:
-Viewing Host Devices

Also, partially related, notice that there's no docs bug to cover SR-IOV in the GUI so will raise one out of BZ#869804

Comment 6 Dayle Parker 2016-03-07 07:49:27 UTC

Looks great - thank you! Changes have been merged, added Revision History entries to the Admin Guide and VMM Guide.

Comment 7 Lucy Bopf 2016-03-16 14:17:30 UTC

This content is now live on the Customer Portal:

Administration Guide:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Administration_Guide/index.html#Viewing_Host_Devices

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Administration_Guide/index.html#Preparing_GPU_Passthrough


Virtual Machine Management Guide:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Virtual_Machine_Management_Guide/index.html#sect-Host_Devices

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Virtual_Machine_Management_Guide/index.html#Preventing_automatic_migration_of_a_virtual_machine