Uploaded image for project: 'OpenShift Bugs'
  1. OpenShift Bugs
  2. OCPBUGS-13354

Update root device hint documentation to recommend by-path names

    XMLWordPrintable

Details

    • No
    • 2
    • T&PS 2023 #8
    • 1
    • False
    • Hide

      None

      Show
      None

    Description

      In the documentation, we give an example of the deviceName root device hint as /dev/vda (which is kind of an odd choice, vs. e.g. /dev/sda given that it can only occur on VMs).
      On RHEL 8 kernels these names were pretty stable and so this wasn't a terrible way of selecting a disk.
      On RHEL 9 kernels the names are very much not stable and it seems you are as likely to select a completely unintended disk this way as to select the right one.

      To work around that, we are allowing users the option to supply by-path device names, like /dev/disks/by-path/pci-0000:01:00.0-scsi-0:2:0:0. These should be stable across reboots (and even across replacing the physical disk with another in the same slot). We should document that this type of path is now supported and recommended.

      The same root device hints structure is used in BareMetal IPI, the Agent-based installer, and ZTP. The implementation changes will apply to all of them.

      Attachments

        Issue Links

          blocks

          Feature - Capability or a well-defined set of functionality that delivers business value. Features can include additions or changes to existing functionality. Features can easily span multiple teams, and potentially multiple releases. OCPSTRAT-45 Add support for disk id, uuid and path to rootDeviceHints

          • Critical - To be worked on immediately following BLOCKER issues.
          • Closed
          documents

          Feature - Capability or a well-defined set of functionality that delivers business value. Features can include additions or changes to existing functionality. Features can easily span multiple teams, and potentially multiple releases. OCPSTRAT-45 Add support for disk id, uuid and path to rootDeviceHints

          • Critical - To be worked on immediately following BLOCKER issues.
          • Closed
          is caused by

          Bug - A problem that impairs or prevents the functions of the product. OCPBUGS-13081 Assisted Root device hints should accept by-path device alias

          • Critical - To be worked on immediately following BLOCKER issues.
          • Closed

          Bug - A problem that impairs or prevents the functions of the product. OCPBUGS-13080 Root device hints should accept by-path device alias

          • Major - To be worked after higher priority work items are addressed. When the severity is high and the effort to change it is low to moderate, this term is chosen. Issues in this category likely have an existing workaround but implementation or execution may be non-trivial.
          • Closed
          is related to

          Bug - A problem that impairs or prevents the functions of the product. OCPBUGS-13185 Document disk ordering behavior in 4.13

          • Major - To be worked after higher priority work items are addressed. When the severity is high and the effort to change it is low to moderate, this term is chosen. Issues in this category likely have an existing workaround but implementation or execution may be non-trivial.
          • Closed
          links to

          GitHub openshift/openshift-docs#62717: OCPBUGS-13354: Root device hint documentation update to recommend by-path names

          GitHub openshift/openshift-docs#62873: [enterprise-4.14] OCPBUGS-13354: Root device hint documentation update to recommend by-path names

          GitHub openshift/openshift-docs#62874: [enterprise-4.13] OCPBUGS-13354: Root device hint documentation update to recommend by-path names

          Activity

            People

              rhn-support-amolnar Alexandra Molnar
              zabitter Zane Bitter
              Pedro Jose Amoedo Martinez Pedro Jose Amoedo Martinez
              Votes:
              1 Vote for this issue
              Watchers:
              7 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: