1MPATHCONF(8) Linux Administrator's Manual MPATHCONF(8)
2
6 mpathconf - A tool for configuring device-mapper-multipath
7
9 mpathconf [commands] [options]
10
12 mpathconf is a utility that creates or modifies /etc/multipath.conf.
13 It can enable or disable multipathing and configure some common
14 options. mpathconf can also load the dm_multipath module, start and
15 stop the multipathd daemon, and configure the multipathd service to
16 start automatically or not. If mpathconf is called with no commands, it
17 will display the current configuration.
18 The default options for mpathconf are --with_module and --with_chkcon‐
20 fig. The --with_multipathd option is not set by default. Enabling
21 multipathing will load the dm_multipath module and chkconfig multipathd
22 to start on the next boot, but it will not immediately start it. This
23 is so that users can manually edit their config file if necessary,
24 before starting multipathd.
25 If /etc/multipath.conf already exists, mpathconf will edit it. If it
27 does not exist, mpathconf will use /usr/share/doc/device-mapper-multi‐
28 path-0.4.9/multipath.conf as the starting file. This file has
29 user_friendly_names set. If this file does not exist, mpathconf will
30 create /etc/multipath.conf from scratch. For most users, this means
31 that user_friendly_names will be set by default, unless they use the
32 --user_friendly_names n command.
33
35 --enable
36 Removes any line that blacklists all device nodes from the
37 /etc/multipath.conf blacklist section.
38 --disable
40 Adds a line that blacklists all device nodes to the /etc/multi‐
41 path.conf blacklist section. If no blacklist section exists, it
42 will create one.
43 --user_friendly_name { y | n }
45 If set to y, this adds the line user_friendly_names yes to the
46 /etc/multipath.conf defaults section. If set to n, this removes
47 the line, if present. This command can be used along with any
48 other command.
49 --find_multipaths { y | n }
51 If set to y, this adds the line find_multipaths yes to the
52 /etc/multipath.conf defaults section. If set to n, this removes
53 the line, if present. This command can be used aldong with any
54 other command.
55
57 --with_module { y | n }
58 If set to y, this runs modprobe dm_multipath to install the mul‐
59 tipath modules. This option only works with the --enable com‐
60 mand. This option is set to y by default.
61 --with_multipathd { y | n }
63 If set to y, this runs service multipathd start to start the
64 multipathd daemon on --enable, service multipathd stop to stop
65 the multipathd daemon on --disable, and service multipathd
66 reload to reconfigure multipathd on --user_frindly_names and
67 --find_multipaths. This option is set to n by default.
68 --with_chkconfig { y | n }
70 If set to y, this runs chkconfig multipathd on to set multipathd
71 to start automatically on --enable and chkconfig multipathd off
72 to stop multipathd for starting automatically on --disable.
73 This option is set to y by default.
74
76 /etc/multipath.conf
77
79 multipath.conf(5), chkconfig(8), modprobe(8), multipath(8), multi‐
80 pathd(8), service(8),
81
83 Benjamin Marzinski <bmarzins@redhat.com>
84 June 2010 MPATHCONF(8)