Bug 1793696 - [Admin] Add warning on multipath User Friendly Names not supported
Summary: [Admin] Add warning on multipath User Friendly Names not supported
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation
Version: 4.3.7
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ovirt-4.4.2
: ---
Assignee: Rolfe Dlugy-Hegwer
QA Contact: Petr Kubica
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2020-01-21 20:38 UTC by Marina Kalinin
Modified: 2023-12-15 17:13 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: No Doc Update
Doc Text:
Clone Of:
Environment:
Last Closed: 2020-09-17 21:59:27 UTC
oVirt Team: Storage
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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


Note You need to log in before you can comment on or make changes to this bug.