Bug 2026735

Summary:	Update SR-IOV configuration docs to include Infiniband devices
Product:	Red Hat Enterprise Linux 8	Reporter:	Charles Haithcock <chaithco>
Component:	Documentation	Assignee:	Daniel Vozenilek <davozeni>
Documentation sub component:	default	QA Contact:
Status:	CLOSED CURRENTRELEASE	Docs Contact:
Severity:	medium
Priority:	high	CC:	jherrman, kheib, mtessun
Version:	8.7	Keywords:	Documentation
Target Milestone:	rc	Flags:	davozeni: needinfo-
Target Release:	---
Hardware:	x86_64
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2022-12-08 18:21:29 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Charles Haithcock 2021-11-25 16:53:06 UTC

Document URL: 


https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/configuring_and_managing_virtualization/index#attaching-sr-iov-networking-devices-to-virtual-machines_managing-sr-iov-devices




Section Number and Name: 

10.9.2. Attaching SR-IOV networking devices to virtual machines



Describe the issue: 

Currently, the docs describe setting up SR-IOV passthrough for KVM guests for ethernet devices only. These should be updated to include infiniband devices as well as the steps are slightly different. 



Suggestions for improvement: 

The original documentation is pretty good and thus does not need any rewrite, rather to include Infiniband should only necessitate including little additional snippets noting "if using infiniband, do <blah blah blah>". 



Additional information: 

- The steps are fundamentally similar it would seem, however the verbage is different. For example, in both scenarios of using ethernet or infiniband sr-iov, you need to set some sort of globally unique address for the switch to assign network info to. For ethernet, you assign a mac address, for infiniband you set a GUID. From there, the switch can set the ip address (ethernet) or LID (infiniband). 
- There's some work on assisting a customer with configuring their infiniband sr-iov in https://bugzilla.redhat.com/show_bug.cgi?id=2024305 that can be used as reference.