[PATCH 2/2] Document user_friendly_names and available workarounds

Ritesh Raj Sarraf rrs at researchut.com
Fri Apr 17 13:56:45 UTC 2009

Explain the problems with user_friendly_names and
explain other reliable options.

Signed-off-by: Ritesh Raj Sarraf <rrs at researchut.com>
 debian/multipath-tools.README.Debian |   31 +++++++++++++++++++++++++++++++
 1 files changed, 31 insertions(+), 0 deletions(-)

diff --git a/debian/multipath-tools.README.Debian b/debian/multipath-tools.README.Debian
index 249ef7f..ffaaa63 100644
--- a/debian/multipath-tools.README.Debian
+++ b/debian/multipath-tools.README.Debian
@@ -9,6 +9,37 @@ If you want multipath-tools to use easier-to-read names, set
   user_friendly_names = yes
 in the 'defaults' section of /etc/multipath.conf.
+Note: While widely used (including the Debian Installer, which depends
+on it), user_friendly_names can sometimes lead to locking issues
+resulting in some maps not having friendly_names.
+For details, please see:
+Other ways to reliably reference a multipath map are:
+1) User Defined alias
+   Each map can be individually be assigned a friendly alias, using
+   which it can be referred.
+   Example:
+   multipaths {
+        multipath {
+                wwid    3600a0b800011a2be00001dfa46cf0620
+                alias   mydev1
+        }
+   }
+   Refer to the multipath.conf man page for additional details
+2) Labels
+   User can assing a filesystem label to each multiapthed device and
+   access them using labels.
+   To assign a label to a multipathed device:
+     e2label /dev/mapper/3600a0b800011a2be00001dfa46cf0620 mydev1
+   and then add an entry like the following in /etc/fstab
+     LABEL=mydev1		/mnt/mountpoint		ext3	defaults	0	0
+   Note: This feature is specific to filesystems and will not work if you want
+   to access the raw device or if your filesystem doesn't support labels
 Where did my FC-connected filesystem go?
 If you were previously mounting a device connected to your system by

More information about the pkg-lvm-maintainers mailing list