Merge pull request #85369 from sr1kar99/44420-warning-about-disk-ordering-behavior

OCPBUGS#44420: Added a warning about the change in disk ordering behavior

Author: skopacz1

modules/lvms-about-adding-devices-to-a-vg.adoc

@@ -10,6 +10,15 @@ The `deviceSelector` field in the `LVMCluster` CR contains the configuration to
 
 You can specify the device paths in the `deviceSelector.paths` field, the `deviceSelector.optionalPaths` field, or both. If you do not specify the device paths in both the `deviceSelector.paths` field and the `deviceSelector.optionalPaths` field, {lvms} adds the supported unused devices to the volume group (VG). 
 
+[WARNING]
+====
+It is recommended to avoid referencing disks using symbolic naming, such as `/dev/sdX`, as these names may change across reboots within RHCOS. Instead, you must use stable naming schemes, such as `/dev/disk/by-path/` or `/dev/disk/by-id/`, to ensure consistent disk identification.
+
+With this change, you might need to adjust existing automation workflows in the cases where monitoring collects information about the install device for each node.
+
+For more information, see the link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/managing_file_systems/assembly_overview-of-persistent-naming-attributes_managing-file-systems[{op-system-base} documentation].
+====
+
 You can add the path to the Redundant Array of Independent Disks (RAID) arrays in the `deviceSelector` field to integrate the RAID arrays with {lvms}. You can create the RAID array by using the `mdadm` utility. {lvms} does not support creating a software RAID.
 
 [NOTE]