Not sure where it would be best to place it. It used to be in the "Storage Administration Guide" in RHEL 7 and 6. Probably "Managing storage devices" would be a good match (https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/managing_storage_devices/index)
Section Number and Name:
The corresponding content for RHEL 7 is:
Describe the issue:
A very commonly needed procedure which can have a significant impact if done wrong (depending on the system setup it can result to data loss, cluster evictions, hanging systems etc) is missing.
Suggestions for improvement:
Document the procedure, as was done in previous RHEL versions
For the time being there is also a KCS documenting the procedure (but also using the "storage administration guide" as a reference for older versions), which kind of fills the gap: https://access.redhat.com/solutions/3941
However, it is impressive how many times such issues pop up in support cases. This is a procedure that would be good to be described in the product documentation.
After evaluating this issue, there are no plans to address it further or fix it in an upcoming release. Therefore, it is being closed. If plans change such that this issue will be fixed in an upcoming release, then the bug can be reopened.
This content is now live on the customer portal in both titles:
Configuring device mapper multipath:
Managing storage devices: