Recommendations for the usage of user_friendly_names in multipath configurations
This document (7001133) is provided subject to the disclaimer at the end of this document.
SUSE Linux Enterprise Server 11
SUSE Linux Enterprise Server 10
SUSE Linux Enterprise Server 9
- with devicemapper multipathing (DM/MPIO) enabled.
- System root on a multipathed storage device.
The global multipath option user_friendly_names is used to create custom device names for the multipath devices.
There are, however, certain situations when the use of user_friendly_names is problematic.
- If the system root is on multipath, the userfriendly settings from /var/lib/multipath/bindings get included into the initrd. If afterwards the storage setup is changed, e.g. by adding or removing devices, there is a mismatch between the bindings setting inside the initrd and the bindings in /var/lib/multipath bindings.
- The default location of the user_friendly_names configuration file is /var/lib/multipath/bindings. If /var is not located on the system root but mounted from another partition the bindings file is not available when setting up multipathing.
It is advised to use the alias configuration option in the multipath.conf file instead, e.g.:
If root is not on multipath, but multipath is included in the initrd anyway (this can happen if root is on LVM), and user_friendly_names is used, then one should boot with the parameter "multipath=off", to avoid problems.
This will disable multipath in the initrd only. Once the system boots, the boot.multipath and multipathd boot scripts will still be able to activate multipathing.
Concerning issue 2. it needs to be assured that the bindings file is available on the system root and multipath can find it.
This be done for example by moving the bindings file to: /etc/multipath/bindings,
and setting the option "bindings_file" in the defaults section of /etc/multipath.conf, e.g:
Note: Since SUSE Linux Enterprise Server 11 Service Pack 3 the bindings are on default already stored in /etc/multipath/bindings.
An extra entry in multipath.conf is not longer needed. (this can be checked with command: # multipath -t | grep bindings)
This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.
- Document ID:7001133
- Creation Date: 11-Aug-2008
- Modified Date:06-Mar-2021
- SUSE Linux Enterprise Server
For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]suse.com