Parameters

-k

Specify this parameter to display the reservation key. The following explains the items displayed when the -k parameter is specified:

Reservation Key

If the reservation key is not set, [0x0000000000000000] is displayed.

Regist Key

The registered keys are displayed.

Key Count

The number of registered keys is displayed.

-c

Specify this parameter to clear the reservation key.

sdn

Specify the SCSI device (sdn) for which you want to display or clear the reservation key. You can specify more than one SCSI device.

If you omit this parameter, the utility displays or clears the reservation keys for all SCSI devices.

-a

Even if an error occurs during processing, processing continues for all remaining SCSI devices.

-h

Displays the format of the utility for clearing HDLM persistent reservation.

Example

To check the reservation keys, and then clear a reservation key:

1. Execute the dlmpr utility to display the reservation keys for sda, sdb, sdc, sdd, sde, and sdf.

   # /opt/DynamicLinkManager/bin/dlmpr -k sda sdb sdc sdd sde sdf
   sda  Reservation Key : [0xaaaaaaaaaaaaaaaa]
        Regist Key : [0xaaaaaaaaaaaaaaaa], Key Count : 1
   sdb  Reservation Key : [0xbbbbbbbbbbbbbbbb]
        Regist Key : [0xaaaaaaaaaaaaaaaa], Key Count : 2
        Regist Key : [0xbbbbbbbbbbbbbbbb], Key Count : 2
   sdc  Reservation Key : [0xbbbbbbbbbbbbbbbb]
        Regist Key : [0xbbbbbbbbbbbbbbbb], Key Count : 4
   sdd  Reservation Key : [0xaaaaaaaaaaaaaaaa]
        Regist Key : [0xaaaaaaaaaaaaaaaa], Key Count : 4
   sde  Reservation Key : [0x0000000000000000]
   sdf  Reservation Key : [0x0000000000000000]
        Regist Key : [0xaaaaaaaaaaaaaaaa], Key Count : 1
        Regist Key : [0xbbbbbbbbbbbbbbbb], Key Count : 1

2. Execute the dlmpr utility to clear the reservation key.

   # /opt/DynamicLinkManager/bin/dlmpr -c sdb sdc

3. The confirmation message appears. Enter y to clear. Otherwise, enter n.

   KAPL10641-I Reservation Key will now be cleared. Is this OK?
   [y/n]:y
   KAPL10642-I Reservation Key of sdb was cleared.
   KAPL10642-I Reservation Key of sdc was cleared.

Note

Before executing the dlmpr utility, make sure that the LU for which persistent reservation will be cleared is not being accessed.

If you perform the following operation while both of the following conditions exist, an error occurs when reservation-key is read, and 0x???????????????? is displayed.

Conditions

• Multiple paths are configured to the HDLM device.

• A persistent reservation has been set by the cluster software.

Operation

1. Clear persistent reservation, specifying the SCSI device.

2. Execute the dlmpr utility with the -k parameter specified to display the PersistentReserve information for a SCSI device associated with a different path.

If the above display error occurs, re-execute the dlmpr utility with the -k parameter specified.