Bug 1311826

Summary:	[Docs] [Admin] Document working with SR-IOV-enabled NIC
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Andrew Burden <aburden>
Component:	Documentation	Assignee:	Andrew Burden <aburden>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Dayle Parker <dayleparker>
Severity:	unspecified	Docs Contact:
Priority:	high
Version:	3.6.0	CC:	gklein, lbopf, lsurette, rbalakri, yeylon, ykaul, ylavi
Target Milestone:	ovirt-3.6.4
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-03-10 02:17:33 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:	869804
Bug Blocks:

Description Andrew Burden 2016-02-25 06:03:46 UTC

"This release adds SR-IOV enablement to the user interface. In order to connect a vNIC directly to a Virtual Function of an SR-IOV-enabled NIC, the vNIC's profile must be marked as a "passthrough" one. The properties that must be configured on the Virtual Function are taken from the vNIC's profile/network (vlan tag). Each SR-IOV-enabled host-NIC must have a defined set of networks that it is allowed to service. When starting the virtual machine, its vNIC will be directly connected to one of the free Virtual Functions on the host. Note that not all Physical Functions are equivalent: the vNIC must be connected via a host-NIC that has the vNIC's network as one of its allowed networks."
- Doc text BZ#869804

Need to document how to setup/edit VFs on SR-IOV-enabled NICs. This will involve new content. Not sure if this would touch anything else. 

Hosts --> Network Interfaces --> Setup Host Networks.

NB - as above, mark the vnic profile as passthrough to enable host device passthrough of VFs

Comment 2 Lucy Bopf 2016-02-26 07:04:05 UTC

Moving to ASSIGNED.

Comment 4 Dayle Parker 2016-03-07 07:42:18 UTC

Looks good -- merged content and added entry to Admin Guide Revision History.

Comment 5 Andrew Burden 2016-03-10 02:17:33 UTC

This content has been published in the Red Hat Enterprise Virtualization 3.6 Administration Guide:

Editing the Virtual Function Configuration on a NIC:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Administration_Guide/chap-Logical_Networks.html#Editing_VFs_on_NIC

Enabling Passthrough on a vNIC Profile:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Administration_Guide/sect-Virtual_Network_Interface_Cards.html#Marking_vNIC_as_Passthrough

Creating a vNIC Profile:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Administration_Guide/sect-Virtual_Network_Interface_Cards.html#Creating_a_VNIC_Profile

Explanation of Settings in the VM Interface Profile Window:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Administration_Guide/sect-Virtual_Network_Interface_Cards.html#Explanation_of_Settings_in_the_VM_Interface_Profile_Window