Items to be defined in an installation-information settings file

Dynamic Link Manager (for Linux®) User Guide
Version
9.0.x
Audience
anonymous
Part Number
MK-92DLM113-64
ft:lastEdition
2025-11-06

The following describes the information defined in the installation information settings file.

[INSTALLATION_SETTINGS] section

This section defines information that is used when the installhdlm utility is executed. Specify this section name at the beginning of the installation information settings file (although an empty paragraph or comment line can be inserted above this section name).

The following table lists and describes the keys defined in the [INSTALLATION_SETTINGS] section.

Table. Keys in the [INSTALLATION_SETTINGS] section

Key name

Description

Necessity of definition

Maximum number of characters

New installation

Upgrade installation or re-installation

licensekeyfile#1

Specify the absolute path name of a license key file that is provided in *.plk format.

The default is /var/tmp/hdlm_license.

If you perform an upgrade installation or re-installation without updating the license, delete the licensekeyfile key and value.

Optional#2

Optional#2

1024

licensekey#1

Specify the absolute path name of a license key file that was created by using the following command:

# echo "license-key" > "license-key-file"

The default is /etc/opt/DynamicLinkManager/dlm.lic_key.

If you perform an upgrade installation or re-installation without updating the license, delete the licensekey key and value.

Optional#2

Optional#2

1024

driver_config

Specify either of the following values to indicate whether to load the HDLM driver and configure the HDLM device:

y: Load the HDLM driver and configure the HDLM device (default).

n: Do not load the HDLM driver and configure the HDLM device.

Optional

Optional

1

restart

Specify whether to restart the host after installation. Specify either of the following values:

y: Restart.

n: Do not restart (default).

If you are installing HDLM in an IP-SAN environment or an FCoE environment, specify n.

Optional

Optional

1
Legend:

Optional: If a key and its setting are not specified, the default value will be used.

However, for an upgrade installation or re-installation, the previous license information will be inherited for the licensekeyfile and licensekey keys.

#1

If no value is specified for either of these keys, the files below are read in the order listed:

  1. License key file (/var/tmp/hdlm_license)

  2. File containing the license key (/etc/opt/DynamicLinkManager/dlm.lic_key)

If none of these files exist when you attempt to perform a new installation, the KAPL09011-E and KAPL09212-E message is output.

If you specify a value for either the licensekey or licensekeyfile key, the specified file will not be deleted after the installhdlm utility is executed. If you do not specify a value for either key, the license key file (/var/tmp/hdlm_license) or the file in which the license key is described (/etc/opt/DynamicLinkManager/dlm.lic_key) will be deleted after the installhdlm utility is executed.

#2

When you perform a new installation of HDLM, or when you perform an upgrade installation while the license is expired, prepare the license key file.

[ENVIRONMENT_SETTINGS] section

This section defines HDLM operation information. If this section is omitted, the installer will use the following values:

  • For a new installation, the installer uses the default values of the keys that are listed in the following Table 2 .

  • For an upgrade installation or re-installation, the installer uses the old HDLM setting values.

The following table lists and describes the keys defined in the [ENVIRONMENT_SETTINGS] section.

Table. Keys in the [ENVIRONMENT_SETTINGS] section

Key name#1

Description#2

Necessity of definition

Maximum number of characters

New installation

Upgrade installation or re-installation

load_balance

Specify one of the following values to indicate whether to enable or disable the load balancing function:

on: Enabled (default)

off: Disabled

Optional

Optional

3

load_balance_type

Specify one of the following values to indicate the load balancing algorithm:

rr: The Round Robin algorithm

exrr: The Extended Round Robin algorithm

lio: The Least I/Os algorithm

exlio: The Extended Least I/Os algorithm (default)

lbk: The Least Blocks algorithm

exlbk: The Extended Least Blocks algorithm

Optional

Optional

5

load_balance_same_path_use_times

Specify the number of times the same path can be used for I/O operations when the Round Robin (rr), Least I/Os (lio), or Least Blocks (lbk) algorithm is used for load balancing.

You can specify a value from 0 to 999999. The default is 32.

Optional

Optional

6

lbex_usetimes_limit

Specify the number of times the same path can be used for sequential I/O operations when the extended Round Robin (exrr), Least I/Os (exlio), or Least Blocks (exlbk) algorithm is used for extended load balancing.

You can specify a value from 0 to 999999. The default is 100.

Optional

Optional

6

lbex_random_io_usetimes_limit

Specify the number of times the same path can be used for random I/O operations when the extended Round Robin (exrr), Least I/Os (exlio), or Least Blocks (exlbk) algorithm is used for extended load balancing.

You can specify a value from 0 to 999999. The default is 1.

Optional

Optional

6

error_log_level

Set the level of error information that is collected as error logs.

You can set a level from 0 to 4. The default is 3.

Optional

Optional

1

error_log_size

Set the size of the error log files (dlmmgr[1-16].log) in kilobytes.

You can set a size from 100 to 2000000. The default is 9900.

Optional

Optional

7

error_log_number

Set the number of error log files (dlmmgr[1-16].log).

You can set a value from 2 to 16. The default is 2.

Optional

Optional

2

trace_level

Set the trace output level.

You can set a level from 0 to 4. The default is 0.

Optional

Optional

1

trace_file_size

Set the size of the trace files (hdlmtr[1-64].log) in kilobytes.

You can set a size from 100 to 16000. The default is 1000.

Optional

Optional

5

trace_file_number

Set the number of trace files (hdlmtr[1-64].log).

You can set a value from 2 to 64. The default is 4.

Optional

Optional

2

path_health_check

Specify one of the following values to indicate whether to enable or disable the path health check function:

on: Enabled (default)

off: Disabled

Optional

Optional

3

path_health_check_interval

Specify the interval in minutes at which the path health check is performed.

You can specify a check interval from 1 to 1440. The default is 30.

Optional

Optional

4

auto_failback

Specify one of the following values to indicate whether to enable or disable the automatic failback function for failed paths:

on: Enabled (default)

off: Disabled

Optional

Optional

3

auto_failback_interval

Specify the interval in minutes from the time the previous path status check finished until the time the next path status check started.

You can specify a check interval from 1 to 1440. The default is 1.

Optional

Optional

4

intermittent_error_monitor#3

Specify one of the following values to indicate whether to enable or disable intermittent error monitoring:

on: Enabled

off: Disabled (default)

Optional

Optional

3

intermittent_error_monitor_interval

Specify the interval in minutes that monitoring for intermittent errors is performed.

You can specify a check interval from 1 to 1440. The default is 30.

Optional

Optional

4

intermittent_error_monitor_number

Specify the number of times an error occurs. You can specify a value from 1 to 99. The default is 3.

Optional

Optional

2
Legend:

Optional: If a key and its setting are not specified, the installer uses the default.

#1

If you are upgrading or re-installing HDLM, the current configuration is applied for any setting that is not specified.

#2

For details about the functions set by these keys, see set (sets up the operating environment).

#3

You can specify this key only in the following cases:

  • For a new installation:

    When on is specified for the auto_failback key in the installation information settings file

  • For an upgrade installation or re-installation:

    When on is specified for the auto_failback key in the installation information settings file, or when automatic failback is enabled in the installation pre-settings

The following shows an example of an edited installation information settings file.

[INSTALLATION_SETTINGS]
 licensekeyfile=/var/tmp/hdlm_license
 licensekey=/etc/opt/DynamicLinkManager/dlm.lic_key
 driver_config=y
 restart=n
 
[ENVIRONMENT_SETTINGS]
 load_balance=on
 load_balance_type=exlio
 load_balance_same_path_use_times=32
 lbex_usetimes_limit=100
 lbex_random_io_usetimes_limit=1
 error_log_level=3
 error_log_size=9900
 error_log_number=2
 trace_level=0
 trace_file_size=1000
 trace_file_number=4
 path_health_check=on
 path_health_check_interval=30
 auto_failback=on
 auto_failback_interval=1
 intermittent_error_monitor=off
 # intermittent_error_monitor_interval=210
 # intermittent_error_monitor_number=3