Bug 2091653

Summary:	[DDF] Section misses Predictable Names information for RoCE adapters, introduced with RHEL 9.0
Product:	Red Hat Enterprise Linux 9	Reporter:	Direct Docs Feedback <ddf-bot>
Component:	Documentation	Assignee:	Mayur Patil <maypatil>
Documentation sub component:	DDF	QA Contact:	smitterl
Status:	CLOSED CURRENTRELEASE	Docs Contact:
Severity:	unspecified
Priority:	medium	CC:	mmuehlfe, rhel-docs, smitterl
Version:	unspecified	Keywords:	Documentation
Target Milestone:	rc	Flags:	pm-rhel: mirror+
Target Release:	9.0
Hardware:	All
OS:	All
Whiteboard:
Fixed In Version:		Doc Type:	Enhancement
Doc Text:	.RoCE Express Adapters now use an improved interface naming scheme With this enhancement, RDMA over Converged Ethernet (RoCE) Express adapters use the predictable interface naming scheme and the Peripheral Communication Interface on z-system (zPCI) connector. In this naming scheme, RHEL uses user identifier (UID) or function identifier (FID) to generate unique names. In case that no unique UID is available, RHEL uses FID to set the naming scheme.	Story Points:	---
Clone Of:		Environment:
Last Closed:	2022-10-11 12:07:37 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Direct Docs Feedback 2022-05-30 16:02:09 UTC

IIUC, this section currently only documents OSA/OSD adapters.
For RoCE Express adapters, we have Predictable Names with their own scheme. More info in IBM docs [1].

In short RoCE Express uses zPCI.
They can be given unique names through their FID or UID. Usage of UID is recommended by IBM.
These new Predictable Interface Name schemes are only available in the current 9.0 release, not any RHEL 8 release.

[1]https://www.ibm.com/docs/en/linux-on-systems?topic=identifiers-interface-names

Reported by: smitterl

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/configuring_and_managing_networking/consistent-network-interface-device-naming_configuring-and-managing-networking#annotations:d5a84e5d-0e4e-46f6-8ecc-1abdcee4dbc6

Comment 1 smitterl 2022-05-30 16:03:58 UTC

Section 1.4. Predictable network interface device names on the System z platform explained

Comment 16 Mayur Patil 2022-10-11 15:37:09 UTC

Published release note: https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html-single/9.0_release_notes/index#enhancement_networking

Relevant Jira ticket: https://issues.redhat.com/browse/RHELPLAN-123702