Editing Multipath

Jump to navigation Jump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
 
https://en.wikipedia.org/wiki/Linux_DM_Multipath
 
https://en.wikipedia.org/wiki/Linux_DM_Multipath
 +
https://linux.die.net/man/8/multipath
  
* https://linux.die.net/man/5/multipath.conf
+
* <code>multipath -l</code>
* https://linux.die.net/man/8/multipath
+
* <code>multipath -ll</code>
* https://linux.die.net/man/8/multipathd
 
 
 
 
 
 
 
* <code>mpathconf</code>
 
** <code>mpathconf --enable --with_multipathd y</code>
 
* <code>multipath -l</code> (show the current multipath topology from information fetched in [[sysfs]] and the [[device mapper]])
 
* <code>[[multipath -ll]]</code>
 
 
** <code>multipath -ll DEVICE_NAME</code>
 
** <code>multipath -ll DEVICE_NAME</code>
 
* <code>[[multipath -v2]]</code> or  <code>[[multipath -v3]]</code>
 
 
* <code>multipath -t</code>
 
* <code>multipath -t</code>
 
:<code>-t</code> Display the currently used [[multipathd]] configuration
 
:<code>-t</code> Display the currently used [[multipathd]] configuration
* <code>[[multipathd]] show config</code>
+
* <code>multipathd show config</code>
  
 
* [[Ubuntu]]: <code>multipath-tools</code> package
 
* [[Ubuntu]]: <code>multipath-tools</code> package
** Binaries: <code>multipath</code> <code>[[multipathd]]</code> <code>[[mpathpersist]]</code>
+
** Binaries: <code>multipath</code> <code>[[multipathd]]</code> <code>mpathpersist</code>
 
* [[RHEL]]: <code>device-mapper-multipath</code> package
 
* [[RHEL]]: <code>device-mapper-multipath</code> package
  
 
Config files:  
 
Config files:  
* <code>/etc/[[multipath.conf]]</code><ref>https://www.thegeekdiary.com/understanding-the-dm-multipath-configuration-file-etc-multipath-conf/</ref><code>https://manpages.debian.org/unstable/multipath-tools/multipath.conf.5.en.html</code>
+
* <code>/etc/multipath.conf</code><ref>https://www.thegeekdiary.com/understanding-the-dm-multipath-configuration-file-etc-multipath-conf/</ref><code>https://manpages.debian.org/unstable/multipath-tools/multipath.conf.5.en.html</code>
* <code>/etc/multipath/[[wwids]]</code>
+
* <code>/etc/multipath/wwids</code>
 +
 
 +
 
 +
:multipath -w 3600a09803831417a5a244f5665797a48
 +
:wwid '3600a09803831417a5a244f5665797a48' removed
 +
 
 +
multipath -W
 +
successfully reset wwids
  
== Configuration file: /etc/[[multipath.conf]] <ref>https://en.wikipedia.org/wiki/Linux_DM_Multipath</ref>==
+
== Configuration file: /etc/multipath.conf <ref>https://en.wikipedia.org/wiki/Linux_DM_Multipath</ref>==
 
# System level defaults (''defaults''): User can override system level defaults.
 
# System level defaults (''defaults''): User can override system level defaults.
 
# Blacklisted devices (''blacklist''): User specifies the list of devices that is not to be under the control of DM-MPIO.
 
# Blacklisted devices (''blacklist''): User specifies the list of devices that is not to be under the control of DM-MPIO.
Line 32: Line 30:
 
# Storage controller specific settings (''devices''): User specified configuration settings will be applied to devices with specified "Vendor" and "Product" information.
 
# Storage controller specific settings (''devices''): User specified configuration settings will be applied to devices with specified "Vendor" and "Product" information.
 
# Device specific settings (''multipaths''): Fine tune the configuration settings for individual LUNs.
 
# Device specific settings (''multipaths''): Fine tune the configuration settings for individual LUNs.
 +
 +
 +
 +
== Default multipath.conf configuration ==
 +
<pre>
 +
RHEL
 +
cat /etc/multipath.conf | grep -v "#" | grep .
 +
defaults {
 +
    polling_interval            5
 +
    no_path_retry              4
 +
    user_friendly_names        no
 +
    flush_on_last_del          yes
 +
    fast_io_fail_tmo            5
 +
    dev_loss_tmo                30
 +
    max_fds                    4096
 +
}
 +
blacklist {
 +
        protocol "(scsi:adt|scsi:sbp)"
 +
}
 +
devices {
 +
    device {
 +
        all_devs                yes
 +
        no_path_retry          4
 +
    }
 +
}
 +
 +
</pre>
  
 
== Routing policies implemented: failover, multibus and group_by_serial ==
 
== Routing policies implemented: failover, multibus and group_by_serial ==
Line 42: Line 67:
 
== Readings ==
 
== Readings ==
 
* Varoqui, C. (2010.) The Linux multipath implementation. Retrieved from http://christophe.varoqui.free.fr/refbook.html
 
* Varoqui, C. (2010.) The Linux multipath implementation. Retrieved from http://christophe.varoqui.free.fr/refbook.html
* Changelog: https://git.opensvc.com/?p=multipath-tools/.git;a=log
 
 
== Related terms ==
 
* <code>[[blkid]]</code> <code>[[multipath -f]]</code> <code>[[multipath -w]]</code> <code>[[pvcreate]]</code>
 
* <code>[[multipath-tools]]</code> Ubuntu package
 
* [[Hitachi Dynamic Link Manager (HDLM)]]
 
  
== Activities ==
 
* Review <code>no_path_retry</code> configuration options in [[multipath.conf]] to avoid [[pvs]] to hang : https://www.suse.com/support/kb/doc/?id=7022310
 
* [[Multipath: remove multipath device unpresented to host]]: <code>multipath -f</code>
 
* Review [[multipath-tools]] source code: https://git.opensvc.com/gitweb.cgi?p=multipath-tools%2F.git
 
* Map some [[LUN]] to your system with multipath uninstalled and verify no [[dm]] devices are created. Install multipath and check again.
 
  
 
== See also ==
 
== See also ==
* [[EMC]] <code>[[powerpath]]</code>
+
* EMC <code>powerpath</code>
 
* <code>[[kpartx]]</code>
 
* <code>[[kpartx]]</code>
* {{HBA}}
+
* {{Fibre Channel}}
* {{Linux Fibre Channel}}
 
 
* {{Linux block devices}}
 
* {{Linux block devices}}
* {{lvm commands}}
 
  
 
[[Category:Linux commands]]
 
[[Category:Linux commands]]

Please note that all contributions to wikieduonline may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see Wikieduonline:Copyrights for details). Do not submit copyrighted work without permission!

Cancel Editing help (opens in new window)

Advertising: