HiCommand Dynamic Link Manager (HDLM) for Windows Systems User's Guide (HIT5201-96001, January 2008)

284 Chapter 8 Utility Reference
8.4 The dlmprsvkey Utility for Registering an HDLM Persistent Reservation Key
This utility registers and displays a persistent reservation key on the HDLM host. A persistent
reservation key is required to operate HDLM functions normally. This utility is executed
automatically at installation of HDLM. A registered persistent reservation key becomes valid
after the host is rebooted. This utility is located in the following:
HDLM-installation-folder\bin\dlmprsvkey.exe
8.4.1 Format
dlmprsvkey {-r [persistent-reservation-key-to-be-specified-by-user][-s]| -v
| -h}
8.4.2 Parameters
Specify the -r [persistent-reservation-key-to-be-specified-by-user][-s]
parameter when you register a persistent reservation key: persistent-reservation-
key-to-be-specified-by-user.
A maximum of 16 hexadecimal alphanumeric digits can be specified.
– If this parameter is omitted, or the dlmprsvkey utility is automatically executed
during HDLM installation:
The dlmprsvkey utility for registering the HDLM persistent reservation key creates
a persistent reservation key by using the MAC address of the NIC and the execution
time of the utility. If the MAC address of the NIC cannot be obtained, the
dlmprsvkey utility creates a persistent reservation key by using the execution time
of the utility only.
– If this parameter is specified:
If a value less than 16 digits is specified, zeros are added to the left of the entered
value to make up the 16 digits. The specified value must satisfy both of the
following conditions:
– Must be a unique value for hosts in SAN.
– Specifiable values are single-byte characters from 0 to 9, a to f, and A to F.
Values cannot be specified using zeroes only. In the following example, the
utility registers the PRSV key without specifying it on the host:
>dlmprsvkey -r
KAPL12104-I The operation for PRSV key registration will now start. Is this
OK? [y/n]: y
KAPL12106-I An attempt to register the PRSV key was successful. (PRSV key =
0123456789abcdef)
In the following example, the utility registers the PRSV key by specifying it on the
host:
>dlmprsvkey -r 0123456789ABCDEF
KAPL12104-I The operation for PRSV key registration will now start. Is this
OK? [y/n]: y