Das Multipath-Dienstprogramm ist der Ziel-Autokonfigurator des Device Mapper, der verwendet wird, um mehrere Pfade zu Geräten zu erkennen und zu konfigurieren. Verwenden Sie den folgenden Befehl, um die Nutzung anzuzeigen:
# multipath -h
multipath-tools v0.4.9 (05/33, 2016)
Usage:
multipath [-a|-A|-c|-w|-W] [-d] [-T tm:val] [-r] [-i] [-v lvl] [-p pol] [-b fil] [-q] [dev]
multipath -l|-ll|-f [-v lvl] [-b fil] [dev]
multipath -F [-v lvl]
multipath -t
multipath -h
Where:
-h print this usage text
-l show multipath topology (sysfs and DM info)
-ll show multipath topology (maximum info)
-f flush a multipath device map
-F flush all multipath device maps
-a add a device wwid to the wwids file
-A add devices from kernel command line mpath.wwids
parameters to wwids file
-c check if a device should be a path in a multipath device
-T tm:val
check if tm matches the multipathd timestamp. If so val is
whether or not the device is a path in a multipath device
-q allow queue_if_no_path when multipathd is not running
-d dry run, do not create or update devmaps
-t dump internal hardware table
-r force devmap reload
-i ignore wwids file
-B treat the bindings file as read only
-b fil bindings file location
-w remove a device from the wwids file
-W reset the wwids file include only the current devices
-p pol force all maps to specified path grouping policy :
. failover one path per priority group
. multibus all paths in one priority group
. group_by_serial one priority group per serial
. group_by_prio one priority group per priority lvl
. group_by_node_name one priority group per target node
-v lvl verbosity level
. 0 no output
. 1 print created devmap names only
. 2 default verbosity
. 3 print debug information
dev action limited to:
. multipath named 'dev' (ex: mpath0) or
. multipath whose wwid is 'dev' (ex: 60051..)
. multipath including the path named 'dev' (ex: /dev/sda)
. multipath including the path with maj:min 'dev' (ex: 8:0) Einige der verfügbaren Optionen werden wie folgt beschrieben:
- -v [Ausführlichkeit] – Geben Sie die Ausführlichkeitsstufe beim Anzeigen von Pfaden und Multipfaden an.
- -l – Listen Sie die Multipath-Topologie auf.
- -ll – Auflisten der maximalen Multipath-Topologieinformationen.
- -f – Leeren Sie eine Multipath-Gerätezuordnung. Verwenden Sie –F, um alle Multipath-Gerätezuordnungen zu löschen.
- -c – Überprüfen Sie, ob ein Gerät ein Pfad in einem Multipath-Gerät sein soll.
- -p Failover | Multibus | group_by_serial | group_by_prio |group_by_node_name – Erzwingen Sie für alle Zuordnungen die angegebene Pfadgruppierungsrichtlinie.
- -r – Neuladen der Gerätekarte erzwingen.
Sie können optional einen Gerätenamen angeben, um nur die Gerätezuordnung zu aktualisieren, die das angegebene Gerät enthält. Verwenden Sie das /dev/sd#-Format, das major:minor-Format, den Multipath-Map-Namen (z. B. mpathN) oder die WWID, um ein Gerät anzugeben.
Eine Beispielausgabe des Befehls multipath –ll lautet wie folgt:
# multipath -ll
...
mpathb(36001405346939038cc9480caf0dd9a9d) dm-3 LIO-ORG ,IBLOCK size=10g features=‘0’ hwhandler=‘0’ wp=rw
‘-+- policy=‘service-time 0’ prio=1 status=active
‘- 2:0:0:2 sdb 8:16 active ready running
mpatha(36001405a7c28190541f4d61880050090) dm-2 LIO-ORG ,IBLOCK size=10g features=‘0’ hwhandler=‘0’ wp=rw
‘-+- policy=‘service-time 0’ prio=1 status=active
‘- 2:0:0:1 sda 8:0 active ready running
... Die Ausgabe für mpathb wird wie folgt beschrieben:
- mpathb – Benutzerfreundlicher Gerätename
- 36001405346939038cc9480caf0dd9a9d – Eindeutige WWID
- dm-3 – sysfs-Dateiname
- LIO-ORG – Anbietername
- IBLOCK – Linux-BLOCK-Gerät
- Größe=10g – Größe des DM-Geräts
- features=‘0’ – Unterstützte DM-Funktionen
- hwhandler=‘0’ – Hardware-Handler
- wp=rw – Schreibberechtigung, auf read-write gesetzt
- policy=‘service-time 0’ – Pfadauswahlalgorithmus
- prio=1 – Pfadgruppenpriorität
- status=aktiv – Zustand der Pfadgruppe
- 2:0:0:2 – SCSI-Informationen:Host, Kanal, scsi_id und LUN
- SDB – Linux-Gerätename
- 8:16 – Major- und Minor-Nummern
- aktiv betriebsbereit – DM-Pfad und Status des physischen Pfads