Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mpathconf(8) [centos man page]

MPATHCONF(8)						   Linux Administrator's Manual 					      MPATHCONF(8)

NAME

       mpathconf - A tool for configuring device-mapper-multipath

SYNOPSIS

       mpathconf [commands] [options]

DESCRIPTION

       mpathconf  is  a  utility  that	creates  or modifies /etc/multipath.conf.  It can enable or disable multipathing and configure some common
       options.  mpathconf can also load the dm_multipath module, start and stop the multipathd daemon, and configure the  multipathd  service	to
       start automatically or not. If mpathconf is called with no commands, it will display the current configuration.

       The  default  options  for mpathconf are --with_module The --with_multipathd option is not set by default.  Enabling multipathing will load
       the dm_multipath module but it will not immediately start it. This is so that users can manually  edit  their  config  file  if	necessary,
       before starting multipathd.

       If /etc/multipath.conf already exists, mpathconf will edit it. If it does not exist, mpathconf will use /usr/share/doc/device-mapper-multi-
       path-0.4.9/multipath.conf as the starting file. This file has user_friendly_names set. If this file does not exist, mpathconf  will  create
       /etc/multipath.conf  from  scratch.   For  most	users,	this  means  that  user_friendly_names will be set by default, unless they use the
       --user_friendly_names n command.

COMMANDS

       --enable
	      Removes any line that blacklists all device nodes from the /etc/multipath.conf blacklist section.

       --disable
	      Adds a line that blacklists all device nodes to the /etc/multipath.conf blacklist section. If no blacklist section exists,  it  will
	      create one.

       --user_friendly_name  { y | n }
	      If  set  to y, this adds the line user_friendly_names yes to the /etc/multipath.conf defaults section. If set to n, this removes the
	      line, if present. This command can be used along with any other command.

       --find_multipaths { y | n }
	      If set to y, this adds the line find_multipaths yes to the /etc/multipath.conf defaults section. If set to n, this removes the line,
	      if present. This command can be used aldong with any other command.

OPTIONS

       --with_module { y | n }
	      If  set  to  y,  this runs modprobe dm_multipath to install the multipath modules. This option only works with the --enable command.
	      This option is set to y by default.

       --with_multipathd { y | n }
	      If set to y, this runs service multipathd start to start the multipathd daemon on --enable, service multipathd stop to stop the mul-
	      tipathd  daemon on --disable, and service multipathd reload to reconfigure multipathd on --user_frindly_names and --find_multipaths.
	      This option is set to n by default.

FILES

       /etc/multipath.conf

SEE ALSO

       multipath.conf(5), modprobe(8), multipath(8), multipathd(8), service(8),

AUTHOR

       Benjamin Marzinski <bmarzins@redhat.com>

								     June 2010							      MPATHCONF(8)

Check Out this Related Man Page

MULTIPATH(8)                                               Linux Administrator's Manual                                               MULTIPATH(8)

NAME

       multipath - Device mapper target autoconfig

SYNOPSIS

       multipath [-v verbosity] [-d] [-h|-l|-ll|-f|-t|-F-B] [-p failover|multibus|group_by_serial|group_by_prio|group_by_node_name] [device]

DESCRIPTION

       multipath is used to detect multiple paths to devices for fail-over or performance reasons and coalesces them

OPTIONS

       -v  level
              verbosity, print all paths and multipaths

                   0           no output

                   1           print the created or updated multipath names only, for use to feed other tools like kpartx

                   2 +         print all info : detected paths, coalesced paths (ie multipaths) and device maps

       -h     print usage text

       -d     dry run, do not create or update devmaps

       -l     show the current multipath topology from information fetched in sysfs and the device mapper

       -ll    show the current multipath topology from all available information (sysfs, the device mapper, path checkers ...)

       -f     flush a multipath device map specified as parameter, if unused

       -F     flush all unused multipath device maps

       -t     print internal hardware table to stdout

       -r     force devmap reload

       -B     treat the bindings file as read only

       -p policy
              force new maps to use the specified policy:

                   failover    1 path per priority group

                   multibus    all paths in 1 priority group

                   group_by_serial
                               1 priority group per serial

                   group_by_prio
                               1  priority group per priority value. Priorities are determined by callout programs specified as a global, per-con-
                               troller or per-multipath option in the configuration file

                   group_by_node_name
                               1 priority group per target node name. Target node names are fetched in /sys/class/fc_transport/target*/node_name.

              Existing maps are not modified.

       device update only the devmap the path pointed by device is in.  device is in the /dev/sdb (as shown by udev in the $DEVNAME  variable)  or
              major:minor format.  device may alternatively be a multipath mapname

SEE ALSO

       multipathd(8), multipath.conf(5), kpartx(8), udev(8), dmsetup(8) hotplug(8)

AUTHORS

       multipath was developed by Christophe Varoqui, <christophe.varoqui@opensvc.com> and others.

                                                                     July 2006                                                        MULTIPATH(8)
Man Page