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

-verbose|-v level

Verbosity:

--device=DEVICE|-d DEVICE

Query or change DEVICE.

--help|-h

Output this usage message.

--hex|-H

Output response in hex.

--in|-i

Request PR In command.

--out|-o

Request PR Out command.

--param-alltgpt|-Y

PR Out parameter 'ALL_TG_PT'.

--param-aptpl|-Z

PR Out parameter 'APTPL'.

--read-keys|-k

PR In: Read Keys.

--param-rk=RK|-K RK

PR Out parameter reservation key (RK is in hex, up to 8 bytes).

--param-sark=SARK|-S SARK

PR Out parameter service action reservation key (SARK is in hex).

--preempt|-P

PR Out: Preempt.

--clear|-C

PR Out: Clear registrations.

--preempt-abort|-A

PR Out: Preempt and Abort.

--prout-type=TYPE|-T TYPE

PR Out command type.

--read-full-status|-s

PR In: Read Full Status.

--read-keys|-k

PR In: Read Keys.

--read-reservation|-r

PR In: Read Reservation.

--register|-G

PR Out: Register.

--register-ignore|-I

PR Out: Register and Ignore.

--release|-L

PR Out: Release.

--report-capabilities|-c

PR In: Report Capabilities.

--reserve|-R

PR Out: Reserve.

--transport-id=TIDS|-X TIDS

TransportIDs can be mentioned in several forms.

--alloc-length=LEN|-l LEN

PR In: maximum allocation length. LEN is a decimal number between 0 and 8192.

EXAMPLE

Register the Service Action Reservation Key for the /dev/mapper/mpath9 device:

mpathpersist --out --register --param-sark=123abc --prout-type=5 /dev/mapper/mpath9

Read the Service Action Reservation Key for the /dev/mapper/mpath9 device:

mpathpersist -i -k /dev/mapper/mpath9

Reserve the Service Action Reservation Key for the /dev/mapper/mpath9 device:

mpathpersist --out --reserve --param-sark=123abc --prout-type=8 -d /dev/mapper/mpath9

Read the reservation status of the /dev/mapper/mpath9 device:

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.