Red Hat Bugzilla – Bug 1474839
Misleading description in section 21.9 Persistent Storage using Fibre Channel
Last modified: 2017-10-17 21:11:44 EDT
Document URL: https://access.redhat.com/documentation/en-us/openshift_container_platform/3.5/html-single/installation_and_configuration/#install-config-persistent-storage-persistent-storage-fibre-channel
Section Number and Name: 21.9.2 Provisioning (sub-section of 21.9 Persistent Storage using Fibre Channel)
Describe the issue: Both the text and the example provided in this section are misleading. The text states: "Note, the number of LUNs must correspond to the number of Persistent Volumes that are created. In the example below, we have LUN as 2, therefore we have created two Persistent Volume definitions." and then in the pictures below there are 2 PVs shown, both backed by LUN 2.
However, the text above does not make sense... The LUN parameter in the YAML description is the LUN ID, which is defined by the SAN administrator when the LUN is created. Suppose the SAN admin gives us a LUN with ID = 100. Does that mean, citing the sentence above, that "we have LUN as 100, therefore we have created 100 PV definitions"?
Suggestions for improvement: I would remove the text "In the example below, we have LUN as 2, therefore we have created two Persistent Volume definitions.", and remove also the second picture (i.e. the one referencing pv0002). Then, I would stress that there is a 1-1 mapping between a persistent volume and a LUN (it's stated later in section 188.8.131.52. ENFORCING DISK QUOTAS).
Section Number and Name:
Describe the issue:
Suggestions for improvement:
*** Bug 1474828 has been marked as a duplicate of this bug. ***
*** Bug 1489493 has been marked as a duplicate of this bug. ***
Updates are in PR https://github.com/openshift/openshift-docs/pull/5301
The doc change LG from QE's perspective.
Commit pushed to master at https://github.com/openshift/openshift-docs
fixes for bugs: 1489493, 1489483, 1474839, and 1489497
Updates are now live at https://docs.openshift.com/container-platform/latest/install_config/persistent_storage/persistent_storage_fibre_channel.html