-
Bug
-
Resolution: Done
-
Minor
-
None
-
4.17
-
Quality / Stability / Reliability
-
False
-
-
5
-
Low
-
None
-
None
-
None
-
None
-
None
-
None
-
None
-
None
-
None
-
None
-
-
None
Description of problem:
The example YAML to create a Fibre Channel Persistent Volume doesn't work because "scsi-" prefix needs to be removed from WWIDs value. Documentation should be updated with a working example. ``` apiVersion: v1 kind: PersistentVolume metadata: name: pv0001 spec: capacity: storage: 1Gi accessModes: - ReadWriteOnce fc: ### BAD EXAMPLE includes "scsi-" prefix ### ### wwids: [scsi-3600508b400105e210000900000490000] ### GOOD EXAMPLE ### wwids: [3600508b400105e210000900000490000] targetWWNs: ['500a0981891b8dc5', '500a0981991b8dc5'] lun: 2 fsType: ext4 ``` It would be nice if the explanation section below the YAML code block also mentioned this. For example, "(1) - World wide identifiers (WWIDs). Either FC wwids or a combination of FC targetWWNs and lun must be set, but not both simultaneously. The FC WWID identifier is recommended over the WWNs target because it is guaranteed to be unique for every storage device, and independent of the path that is used to access the device. The WWID identifier can be obtained by issuing a SCSI Inquiry to retrieve the Device Identification Vital Product Data (page 0x83) or Unit Serial Number (page 0x80). FC WWIDs are identified as /dev/disk/by-id/ to reference the data on the disk, even if the path to the device changes and even when accessing the device from different systems. The WWID is a hexadecimal value and should not include the "scsi-" prefix."
Version-Release number of selected component (if applicable):
How reproducible:
Steps to Reproduce:
1. 2. 3.
Actual results:
Expected results:
Additional info: