Configuration file defaults
The defaults section establishes global configuration parameters for DM Multipath behavior, including polling intervals, path grouping policies, and failover settings applied to all multipath devices.
The /etc/multipath.conf configuration file contains a defaults section. This section includes the default configuration of Device Mapper (DM) Multipath. The default values might differ based on your initial device settings.
The following table describes the optional attributes, set in the defaults section of the multipath.conf configuration file. If you do not set them, default values from the overrides, or devices sections apply.
| Attribute | Description |
|---|---|
|
|
Specifies the interval between two path checks in seconds. For properly functioning paths, the interval between checks gradually increases to |
|
The default value is |
|
|
|
Specifies the maximum length of the interval between two path checks in seconds. |
|
The default value is |
|
|
|
Defines the mode for setting up multipath devices. Available values include: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The default value is |
|
|
|
This represents the timeout in seconds, to wait for additional paths after detecting the first one, if |
|
Positive value: If set with a positive value, the timeout applies for all non-blacklisted devices. |
|
|
Negative value: If set with a negative value, the timeout applies only to known devices that have an entry in the multipath hardware table, either in the built-in table, or in a |
|
|
|
|
|
The default value for known hardware is |
|
|
|
Set the timeout of |
|
For systems with a large number of devices, |
|
|
The default value is |
|
|
|
Enable reassigning of device-mapper maps. With this option, the |
|
|
The default verbosity value is |
|
|
Specifies the default algorithm to use in determining what path to use for the next I/O operation. Possible values include: |
|
|
|
|
|
|
|
|
|
|
The default value is |
|
|
|
Specifies the default path grouping policy to apply to unspecified multipaths. Possible values include: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The default value is |
|
|
|
Set this option to activate merging |
|
The value of this option is a space separated list of records like |
|
|
If you configure this option and it matches the device node name of a device, it overrides any other configured methods for determining the WWID for this device. |
|
|
You can enable |
|
|
The default is |
|
|
|
Specifies the default function to call to obtain a path priority value. For example, the Asymmetric Logical Unit Access (ALUA) bits in SPC-3 provide an exploitable |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The default value depends on the |
|
|
|
Arguments to pass to the |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The default value is |
|
|
|
The default extra features of multipath devices, using the format: "number_of_features_plus_arguments feature1 …". |
|
Possible values for |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
By default, the value is unset. |
|
|
|
Specifies the default method to determine the state of the paths. Possible values include: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The default value is |
|
|
|
This attribute represents the |
|
The default value is |
|
|
|
Manages path group failback. Possible values include: |
|
|
|
|
|
|
|
|
|
|
A numeric value greater than zero, specifies deferred failback, and is expressed in seconds. |
|
|
The default value is |
|
|
|
Specifies the number of I/O requests to route to a path before switching to the next path in the current path group. This setting is only for systems running kernels older than 2.6.31. Newer systems should use |
|
|
Specifies the number of I/O requests to route to a path, before switching to the next path in the current path group. Uses a request-based device-mapper-multipath. This setting can be used on systems running current kernels. On systems running kernels older than 2.6.31, use |
|
|
A numeric value for this attribute specifies the number of times that the path checker must fail for all paths in a multipath device, before disabling queuing. |
|
A value of |
|
|
A value of |
|
|
The default value is |
|
|
|
Possible values include: |
|
|
|
|
|
|
|
The default value is |
|
|
|
If set to |
|
|
If set to |
|
|
Sets the maximum number of open file descriptors that can be opened by multipath and the |
|
|
The timeout to use for prioritizers and path checkers that issue SCSI commands with an explicit timeout, in seconds. The |
|
|
The number of seconds the SCSI layer waits after a problem is detected on an FC remote port, before failing I/O to devices on that remote port. This value must be smaller than the value of |
|
|
The number of seconds the SCSI layer waits after a problem is detected on an FC remote port, before removing it from the system. Setting this to infinity will set this to 2147483647 seconds, or 68 years. The operating system determines the default value. |
|
|
Specifies the maximum number of seconds the SCSI layer spends performing error handling, when SCSI devices fail. After this timeout, the scsi layer performs a full Host Bus Adapter (HBA) reset. Setting this is necessary in cases where the |
|
The default value is |
|
|
|
If set to |
|
If set to |
|
|
The default value is |
|
|
|
If |
|
If |
|
|
The default value is |
|
|
|
Controls which path grouping policy is set when |
|
If |
|
|
If |
|
|
The default value is |
|
|
|
Specifies the |
|
The default value is device dependent: |
|
|
|
If set to |
|
The default value is |
|
|
|
If set to |
|
The default value is |
|
|
|
Use the |
|
The default value of |
|
|
|
This attribute controls the number of seconds the |
|
The default value is |
|
|
|
If set to |
|
|
If you set all three of these attributes to integers greater than zero, they enable the |
|
See the Shaky paths detection section of the |
|
|
The default value is |
|
|
|
If |
|
If a path fails twice within the value set in the |
|
|
See the Shaky paths detection section of the |
|
|
The default value is |
|
|
|
Possible values include: |
|
|
|
|
|
|
|
|
|
|
The |
|
|
See the Shaky paths detection section of the |
|
|
The default value is |
|
|
|
If set to |
|
|
If set to |
|
|
Using this option, you can set the |
|
|
This attribute sets the number of seconds that multipath waits after creating a device with only ghost paths, before marking it ready for use in |
|
Setting this to |
|
|
The default value is |
|
|
|
This attribute enables or disables foreign libraries. |
|
The value is a regular expression. Foreign libraries are loaded if their name matches the expression. |
|
|
By default, no foreign libraries are enabled. Use |
|
|
|
If set to |
|
This option only works for SCSI devices with configuration to use the default |
|
|
The default value is |
|
|
|
This option sets the number of times multipath retries removing a device that is in use. Between each attempt, multipath becomes inactive for 1 second. The default value is |
|
|
If set to |
|
The default value is |
|
|
|
The |
|
This parameter can also be set to |
|
|
|
If set to |
|
|
Controls when the |
|
|
|
|
|
|
|
|
|
|
|
If set to |
|
|
|
|
The default value is |
For more information, see the multipath.conf(5) man page on your system.