Bug 1793696

Summary: [Admin] Add warning on multipath User Friendly Names not supported
Product: Red Hat Enterprise Virtualization Manager Reporter: Marina Kalinin <mkalinin>
Component: DocumentationAssignee: Rolfe Dlugy-Hegwer <rdlugyhe>
Status: CLOSED CURRENTRELEASE QA Contact: Petr Kubica <pkubica>
Severity: high Docs Contact:
Priority: high    
Version: 4.3.7CC: aefrat, gwatson, lsurette, lsvaty, nsoffer, pkovar, rdlugyhe, sleviim, srevivo
Target Milestone: ovirt-4.4.2Keywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: No Doc Update
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2020-09-17 21:59:27 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: Storage RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Marina Kalinin 2020-01-21 20:38:16 UTC
Following bz#1793207, please add a comment to current documentation, that using multipath user friendly names on RHV hosts is not supported.

We can even restore the warning we used to have in the past:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.0/html/Administration_Guide/Managing_Storage.html#Managing_Storage_Entities

Comment 4 Rolfe Dlugy-Hegwer 2020-09-02 19:42:50 UTC
(In reply to Marina Kalinin from comment #0)
> Following bz#1793207, please add a comment to current documentation, that
> using multipath user friendly names on RHV hosts is not supported.
> 
> We can even restore the warning we used to have in the past:
> https://access.redhat.com/documentation/en-US/
> Red_Hat_Enterprise_Virtualization/3.0/html/Administration_Guide/
> Managing_Storage.html#Managing_Storage_Entities

Thanks for the link! Where did you get that from? I used web.archive.org [3] to find the a copy of that old warning. I'll add that warning back to our current docs so it's harder to miss. 

If you're interested, the documentation already covers this topic to some extent, as shown below:

The "Customizing Multipath Configurations for SAN Vendors" topic [1] states, "Do not override the user_friendly_names and find_multipaths settings. For more information, see Section 3.6, “Recommended Settings for Multipath.conf”

The "Recommended Settings for Multipath.conf" topic [2] states, 

"When overriding /etc/multipath.conf, Do not override the following settings:

* user_friendly_names no - This setting controls whether user-friendly names are assigned to devices in addition to the actual device names. Multiple hosts must use the same name to access devices. Disabling this setting prevents user-friendly names from interfering with this requirement.


[1] https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_cockpit_web_interface/preparing_storage_for_rhv_she_cockpit_deploy#proc-Customizing_Multipath_Configurations_for_SAN_Vendors_SHE_cockpit_deploy

[2] https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_cockpit_web_interface/Preparing_Storage_for_RHV_SHE_cockpit_deploy#ref-Recommended_Settings_for_Multipath.conf_SHE_cockpit_deploy

[3] https://web.archive.org/web/20190720033417/https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.0/html/Administration_Guide/Managing_Storage.html