Skip to main content

lun persistent-reservation show

Contributors
Suggest changes

Display the current reservation information for a given LUN

Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

Description

Displays reservation information for a specified LUN in a Vserver. Unlike other show commands, the user must specify the LUN.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

-vserver <Vserver Name> - Vserver Name (privilege: advanced)

Specifies the Vserver.

{ -path <path> - LUN Path (privilege: advanced)

Specifies the path of the LUN. Examples of correct LUN paths are /vol/vol1/lun1 and /vol/vol1/qtree1/lun1 .

| -volume <volume name> - Volume Name (privilege: advanced)

Specifies the volume.

-lun <text> - LUN Name (privilege: advanced)

Specifies the name of the LUN.

[-qtree <qtree name>] - Qtree Name (privilege: advanced) }

Specifies the qtree.

[-scsi-revision {scsi2|scsi3}] - SCSI Revision (privilege: advanced)

Selects the reservations that match this parameter value.

[-entry-type {reservation|registration}] - Reservation or Registration (privilege: advanced)

Selects the reservations that match this parameter value.

[-protocol {fcp|iscsi}] - Protocol (privilege: advanced)

Selects the reservations that match this parameter value.

[-reservation-key <text>] - Reservation Key (privilege: advanced)

Selects the reservations that match this parameter value.

[-reservation-type-code <text>] - Reservation Type (privilege: advanced)

Selects the reservations that match this parameter value. The possible values for SCSI-3 reservations are:

  • write exclusive

  • exclusive access

  • write exclusive registrants only

  • exclusive access registrants only

  • write exclusive all registrants

  • exclusive access all registrants

and for SCSI-2 are:

  • regular

  • third party

[-initiator-name <text>] - Initiator Name (privilege: advanced)

Selects the reservations that match this parameter value.

[-aptpl {true|false}] - Persist Through Power Loss (privilege: advanced)

Selects the reservations that match this parameter value. If true , the reservation will be preserved over a power loss. If false , it will not. This value is for SCSI-3 reservations only.

[-rtpid <integer>] - Relative Target Port ID (privilege: advanced)

Selects the reservations that match the specified Relative Target Port ID (RTPID). This applies to SCSI-3 reservations only.

[-target-wwpn <text>] - FCP Target WWPN (privilege: advanced)

Selects the reservations that match the specified World Wide Port Name (WWPN).

[-isid <text>] - Initiator Session ID (privilege: advanced)

Selects the reservations that match this parameter value.

[-tpgroup-tag <integer>] - TPGroup Tag (privilege: advanced)

Selects the reservations that match the specified target portal group tag. The tag identifies the tpgroup the reservation was made over.

[-third-party-initiator-name <text>] - Third Party Initiator Name (privilege: advanced)

Selects the reservations that match this parameter value (the initiator name that the reservation was made for). This is specific to third party reservation types, which is indicated by reservation-type-code.

[-zrto-status {none|primary-out-of-sync|primary-in-sync|secondary-out-of-sync|secondary-in-sync}] - ZRTO Status (privilege: advanced)

Selects the reservations that match this parameter value.

Examples

cluster1::*> lun persistent-reservation show -vserver vs_1 /vol/vol_1/lun_1
     Key                     Protocol Type              Initiator Name
     ----------------------- -------- ----------------- ----------------------------
     APTPL: true
     a0:00:00:00:00:00:00:01 iscsi    write exclusive   iqn.1993-08.org.debian:01:fa752b8a5a3a
     a0:00:00:00:00:00:00:01 iscsi    -                 iqn.1993-08.org.debian:01:fa752b8a5a3a
     2 entries were displayed.

The example above displays the current reservations for lun_1 on Vsever vs_1.