Bug#716655: multipath-tools: mention aliases in README.debian

[Vincent McIntyre]

Package: multipath-tools
Version: 0.4.9+git0.4dfdaf2b
Severity: wishlist
Tags: patch


Explicit aliases for particular wwwn are a better alternative than
user_friendly_names because the mpathN <-> wwwn name mapping can
change unexpectedly. The patch below explains this in README.debian.
Please consider applying.

--- debian/multipath-tools.README.Debian.orig   2013-07-11 00:14:45.000000000 +0000
+++ debian/multipath-tools.README.Debian        2013-07-11 00:11:15.000000000 +0000
@@ -13,6 +13,17 @@
 user_friendly_names can lead to locking issues with large numbers of LUNs
 resulting in some maps not having friendly_names [1].
 
+Note: The mpathN <-> wwwn name mapping created by the user_friendly_names
+feature can change unexpectedly across reboots. A more stable solution for
+ 'friendly' names is to make explicit aliases in multipath.conf, e.g.
+   multipaths {
+       multipath {
+           wwwid 2226f000123deadbf
+           alias diskbox1-lun0
+       }
+   }
+This device should be accessible as /dev/mapper/diskbox1-lun0.
+

-- System Information:
Debian Release: jessie/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 3.2.0-0.bpo.4-amd64 (SMP w/8 CPU cores)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/dash