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

Update root device hint documentation to recommend by-path names

XMLWordPrintable

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

      None

      Show
      None

      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.

            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

              Created:
              Updated:
              Resolved: