Red Hat Bugzilla – Bug 1474839
Misleading description in section 21.9 Persistent Storage using Fibre Channel
Last modified: 2017-07-25 09:32:37 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 220.127.116.11. ENFORCING DISK QUOTAS).
Section Number and Name:
Describe the issue:
Suggestions for improvement: