Bug 2056590

Summary:	/dev/disk/by-path not supported for local storage
Product:	OpenShift Container Platform	Reporter:	Tom Dale <tdale>
Component:	Documentation	Assignee:	Darshan Nagaraj <dnagaraj>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Chao Yang <chaoyang>
Severity:	medium	Docs Contact:	Latha S <lmurthy>
Priority:	medium
Version:	4.10	CC:	aos-bugs, chaoyang, dnagaraj, dnaphade, sniemann, tdale
Target Milestone:	---	Flags:	dnagaraj: needinfo- dnagaraj: needinfo- dnagaraj: needinfo- dnagaraj: needinfo-
Target Release:	4.6.z
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2022-03-08 10:55:05 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:
Bug Depends On:	2052618, 2061995
Bug Blocks:

Description Tom Dale 2022-02-21 14:34:10 UTC

Document URL: 
https://docs.openshift.com/container-platform/4.9/storage/persistent_storage/persistent-storage-local.html#local-volume-cr_persistent-storage-local

Section Number and Name: 
Provisioning local volumes by using the Local Storage Operator
Procedure #1


Describe the issue: 
The documentation currently states "Replace this value with your actual local disks filepath to the LocalVolume resource, such as dev/disk/by-id/wwn" .

In practice /dev/disk/by-id/* seems to be the only supported persistent path. /dev/disk/by-path behaves incorrectly as seen in https://bugzilla.redhat.com/show_bug.cgi?id=2052618 .


2052618
Suggestions for improvement: 
Rephrase above quoted section, or add a note specifying which paths are supported by LSO, and which should not be used as they will actually be changed to the kernel assigned device name.