Bug 2127070

Summary: [DDF] The documentation for ODF on bare metal using local storage devices should highlight that we generally support
Product: [Red Hat Storage] Red Hat OpenShift Data Foundation Reporter: Direct Docs Feedback <ddf-bot>
Component: documentationAssignee: Kusuma <kbg>
Status: CLOSED CURRENTRELEASE QA Contact: Olive Lakra <olakra>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 4.11CC: cblum, mmuench, ocs-bugs, odf-bz-bot, olakra, rcyriac
Target Milestone: ---Keywords: NoDocsQEReview
Target Release: ODF 4.11.2   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2023-03-09 12:47:11 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-09-15 09:18:11 UTC
The documentation for ODF on bare metal using local storage devices should highlight that we generally support remote devices (via methods like iSCSI or others) as well and will treat these as "local disks" in that case

Reported by: rhn-stor-cblum

https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.11/html/deploying_openshift_data_foundation_using_bare_metal_infrastructure/preparing_to_deploy_openshift_data_foundation#annotations:f1d0b2f5-222d-412d-a2be-b52e131a0dba

Comment 2 Chris Blum 2022-09-15 09:34:28 UTC
Let's add a short paragraph between the first two paragraphs in Chapter 1 of the "Deploying OpenShift Data Foundation using bare metal infrastructure" document.

My recommendation for the addition is:

In the following we use the term local storage or locally attached-storage devices. This includes disks physically present on the servers, but also storage that is attached over the network or fiber-channel and presented as block storage devices through the Linux kernel. Typically we would be looking for these storage devices in the local /dev folder and its sub-folders and in the output of lsblk.
However, this does not include support for file-system based remote storage like NFS, even if block storage is emulated on top of this file-system, for example via loopback devices.