Initial git import.
[platform/upstream/multipath-tools.git] / FAQ
1 1. How to set up System-on-multipath ?
2 ======================================
3
4 prerequisite : udev and multipath-tools installed
5
6 here are the steps on a Debian SID system :
7
8 * add dm-mpath and dm-multipath to /etc/mkinitrd/modules
9 * copy $tools_dir/multipath/0[12]_* to /etc/mkinitrd/scripts
10 * define a friendly alias for your multipathed root disk
11   (in /etc/multipath.conf). Example : "system"
12 * enable busybox in /etc/mkinitrd/mkinitrd.conf and set ROOT
13   to any valid block-device (but not a /dev/dm-* one, due to
14   an mkintrd misbelief that all dm-* are managed by LVM2)
15 * run mkinitrd
16 * in /boot/grub/menu.lst, define the root= kernel parameter
17   Example : root=/dev/system1
18 * modify /etc/fstab to reference /dev/system* partitions
19
20 At reboot, you should see some info like :
21
22 path /dev/sda : multipath system
23 ...
24 gpt: 0 slices
25 dos: 5 slices
26 reduced size of partition #2 to 63
27 Added system1 : 0 70685937 linear /dev/system 63
28 Added system2 : 0 63 linear /dev/system 7068600
29 Added system5 : 0 995967 linear /dev/system 70686063
30 ...
31
32 2. How does it compare to commercial product XXX ?
33 ==================================================
34
35 Here are a few distinctive features :
36
37 * you can mix HBA models, even different vendors, different speed ...
38 * you can mix storage controllers on your SAN, and access them all, applying
39   different path grouping policy
40 * completely event-driven model : no administration burden if you accept the
41   default behaviours
42 * extensible : you can plug your own policies if the available ones don't fill
43   your needs
44 * supports root FS on multipathed SAN
45 * free, open-source software
46
47 3. LVM2 doesn't see my multipathed devices as PV, what's up ?
48 =============================================================
49
50 By default, lvm2 does not consider device-mapper block devices (such as a
51 dm-crypt device) for use as physical volumes.
52
53 In order to use a dm-crypt device as an lvm2 pv, add this line to the
54 devices block in /etc/lvm/lvm.conf:
55
56 types = [ "device-mapper", 16 ]
57
58 If /etc/lvm/lvm.conf does not exist, you can create one based on your 
59 current/default config like so:
60
61 lvm dumpconfig > /etc/lvm/lvm.conf
62
63 (tip from Christophe Saout)