Scroll to navigation

MPATHPERSIST(8) System Manager's Manual MPATHPERSIST(8)

NAME

mpathpersist - Manages SCSI persistent reservations on dm multipath devices.

SYNOPSIS

mpathpersist [OPTIONS] device

DESCRIPTION

This utility is used to manage SCSI persistent reservations on Device Mapper Multipath devices. To be able to use this functionality, the reservation_key attribute must be defined in the /etc/multipath.conf file. Otherwise the multipathd daemon will not check for persistent reservation for newly discovered paths or reinstated paths.

mpathpersist supports the same command-line options as the sg_persist utility. Consult the sg_persist (8) manual page for an in-depth discussion of the various options.

OPTIONS

Verbosity:
0
Critical messages.
1
Error messages.
2
Warning messages.
3
Informational messages.
4
Informational messages with trace enabled.
Query or change DEVICE.
Output this usage message.
Output response in hex.
Request PR In command.
Request PR Out command.
PR Out parameter 'ALL_TG_PT'.
PR Out parameter 'APTPL'.
PR In: Read Keys.
PR Out parameter reservation key (RK is in hex, up to 8 bytes).
PR Out parameter service action reservation key (SARK is in hex).
PR Out: Preempt.
PR Out: Clear registrations.
PR Out: Preempt and Abort.
PR Out command type.
PR In: Read Full Status.
PR In: Read Keys.
PR In: Read Reservation.
PR Out: Register.
PR Out: Register and Ignore.
PR Out: Release.
PR In: Report Capabilities.
PR Out: Reserve.
TransportIDs can be mentioned in several forms.
PR In: maximum allocation length. LEN is a decimal number between 0 and 8192.

EXAMPLE

mpathpersist --out --register --param-sark=123abc --prout-type=5 /dev/mapper/mpath9
mpathpersist -i -k /dev/mapper/mpath9
mpathpersist --out --reserve --param-sark=123abc --prout-type=8 -d /dev/mapper/mpath9
mpathpersist -i -s -d /dev/mapper/mpath9

SEE ALSO

multipath(8), multipathd(8), sg_persist(8).

AUTHORS

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

2016-10-30 Linux