- -r
Specify the number of retries when memory is allocated in the filter driver. If memory allocation fails, the system retries at intervals of 0.05 seconds. If retrying for a long time results in I/O not being executed, set an appropriate retry count. If that retry count is exceeded and memory allocation fails, the KAPL05708-E message is output to syslog and to the HDLM manager log file.
- retrycount
Specify a numeric value from -1 to 2,147,483,646.
-1 : The system retries until memory is allocated. This is the initial value of the system.
0 : The system does not retry.
1 to 2,147,483,646: The system retries the specified number of times.
If the following values are specified, the message KAPL12559-E is displayed and then the processing terminates:
Non-numeric value
Value less than -1
Value more than 2,147,483,646
- -inqt
Specify, in seconds, the timeout value of the SCSI INQUIRY command. In HDLM, the default timeout value is 30 seconds. Note that the timeout value specified by using the -inqt parameter only applies to the SCSI INQUIRY command executed from HDLM. This value has no effect on the SCSI INQUIRY command executed from another application.
- InquiryTimeout
Specify a numeric value of -1 or in the range from 1 to 3,600.
-1: This sets the timeout value to 30 seconds, which is HDLM's default value.
1 to 3,600: Timeout value (in seconds)
If the following values are specified, the message KAPL12559-E is displayed and then the processing ends:
0
Value less than -1
Value more than 3,600
Non-numeric value
- -inqr
Specify the number of retries of the SCSI INQUIRY command. In HDLM, the default number of retries is 1. Note that the number of retries specified by using the -inqr parameter only applies to the SCSI INQUIRY command executed from HDLM. This value has no effect on the SCSI INQUIRY command executed from another application.
- InquiryRetry
Specify a numeric value in the range from -1 to 2,147,483,646.
-1: This sets the number of retries to 1, which is HDLM's default value.
0: The system does not retry.
1 to 2,147,483,646: The system retries the specified number of times.
If the following values are specified, the KAPL12559-E message is displayed and then processing ends:
Value less than -1
Value more than 2,147,483,646
Non-numeric value
- -prsup
Specify this parameter when linking with a cluster that supports persistent reservations (Pacemaker).
- ReserveStatus
Specify on or off. The default value is off.
on: Links with a cluster that supports persistent reservations.
off: Does not link with a cluster that supports persistent reservations.
You can use this parameter for the following OSs:
- Red Hat Enterprise Linux 7
- Red Hat Enterprise Linux 8
- Red Hat Enterprise Linux 9
- -epr
Specify the number of times to retry I/O on failed paths when all paths fail.
Specify this parameter only when you are using a channel board (25-Gbps iSCSI optical).
In a boot disk environment of a multipath configuration where an HDLM device is used, do not specify the -epr option because operations might be affected at OS startup when the -epr option is specified.
Example
- Example 1:
In this example, the utility sets the retry count to 100000:
# /opt/DynamicLinkManager/bin/dlmsetopt -r 100000 KAPL12554-I The utility for setting HDLM driver option has started. KAPL12555-I The utility for setting HDLM driver option completed normally. KAPL12558-I Please restart the computer so that the option settings take effect.
- Example 2:
In this example, the utility displays Help:
- For Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Red Hat Enterprise Linux 9, Oracle Linux 7, Oracle Linux 8, Oracle Linux 9 or Oracle Unbreakable Enterprise Kernel:
# /opt/DynamicLinkManager/bin/dlmsetopt -h KAPL12554-I The utility for setting HDLM driver option has started. Usage: dlmsetopt {-r retrycount | -inqt InquiryTimeout | -inqr InquiryRetry | -epr ErrorPathRetry | -epd ErrorPathDelay | -prsup ReserveStatus | -h} retrycount: -1 = Infinite 0 = No Retry 1-2147483646 = Retry Count InquiryTimeout: -1 = Default Timeout(30(s)) 1-3600 = Inquiry Timeout Value InquiryRetry: -1 = Default Retry(1) 0 = No Retry 1-2147483646 = Inquiry Retry Count ErrorPathRetry: 0 = No Retry(Default) 0-255 = Error Path Retry Count ErrorPathDelay: 1 = Default Delay(1(s)) 1-255 = Error Path Retry Delay Value ReserveStatus: on = Persistent Reserve Support off = No Persistent Reserve Support(Default) KAPL12555-I The utility for setting HDLM driver option completed normally.
- For OSs other than the above:
# /opt/DynamicLinkManager/bin/dlmsetopt -h KAPL12554-I The utility for setting HDLM driver option has started. Usage: dlmsetopt {-r retrycount | -inqt InquiryTimeout | -inqr InquiryRetry | -epr ErrorPathRetry | -epd ErrorPathDelay | -h} retrycount: -1 = Infinite 0 = No Retry 1-2147483646 = Retry Count InquiryTimeout: -1 = Default Timeout(30(s)) 1-3600 = Inquiry Timeout Value InquiryRetry: -1 = Default Retry(1) 0 = No Retry 1-2147483646 = Inquiry Retry Count ErrorPathRetry: 0 = No Retry(Default) 0-255 = Error Path Retry Count ErrorPathDelay: 1 = Default Delay(1(s)) 1-255 = Error Path Retry Delay Value KAPL12555-I The utility for setting HDLM driver option completed normally.
Notes
The contents specified in the dlmsetopt utility are written to the options sddlmfdrv line of the conf files. Do not attempt to edit this line using an editor such as vi. The following table lists the names of conf files used by the dlmsetopt utility.
Table. conf files used by the dlmsetopt utility OS
File name
Red Hat Enterprise Linux 7
Red Hat Enterprise Linux 8
Red Hat Enterprise Linux 9
Oracle Linux 7
Oracle Linux 8
Oracle Linux 9
SUSE LINUX Enterprise Server 12
SUSE LINUX Enterprise Server 15
/etc/modprobe.d/dlmdrvopt.conf
Oracle Unbreakable Enterprise Kernel 7
Oracle Unbreakable Enterprise Kernel 8
If you use the dlmsetopt utility in an environment where an HDLM device is used for the boot disk, after changing the settings, you need to re-create the initial RAM disk image file. To re-create the file, use the dracut command. If you change the name of the initial RAM disk image file, change the settings file for the boot loader so that the re-created initial RAM disk image file is used during boot-up. For details on this procedure, see the following table.
Table. Setting file names for boot loaders Boot loader
Configuration file name
GRUB2
BIOS
Red Hat Enterprise Linux 7
Red Hat Enterprise Linux 8
Red Hat Enterprise Linux 9
SUSE LINUX Enterprise Server 12
SUSE LINUX Enterprise Server 15
/boot/grub2/grub.cfg
UEFI
Red Hat Enterprise Linux 7
Red Hat Enterprise Linux 8
/boot/efi/EFI/redhat/grub.cfg
Red Hat Enterprise Linux 9
/boot/grub2/grub.cfg
When you specify the -prsup on parameter, you need to restart the host to enable the setting. To link with Lifekeeper, do not set the -prsup on parameter.