Конфигурационный файл DM-Multipath

По умолчанию DM-Multipath предоставляет конфигурации для большинства множественных устройств. В дополнение к этому DM-Multipath включает поддержку большинства массивов хранения, которые поддерживают DM-Multipath. Значения конфигураций по умолчанию и поддерживаемые устройства можно найти в файле multipath.conf.defaults.

Вы можете переопределить настроенные значения по умолчанию для DM-Multipath, изменив конфигурационный файл /etc/multipath.conf. Если необходимо, вы можете также добавить массив хранения, который не поддерживается по умолчанию, в конфигурационный файл. Эта глава предоставляет информацию по разбору иизменению файла multipath.conf. Она содержит следующие секции:

1. Обзор файла конфигурации

2. "Черный список" в файле конфигурации

3. Значения по умолчанию в файле конфигурации

4. Атрибуты множественности в файле конфигурации

5. Устройства в файле конфигурации

В файле конфигурации multipath вам нужно определить только те секции, которые вам потребуются для ваших настройек или те, для которых вы захотите изменить значения по умолчанию, определенные в multipath.conf.defaults. Если в файле присутствуют секции не относящиеся к вашему оборудованию или для которых вы не хотите менять значения по умолчанию, вы можете оставить их закомментированными, как в изначальном файле.

Файл конфигурации допускает синтаксис регулярных выражений.

Версию конфигурационного файла с комментариями можно найти в [архиве] /usr/share/doc/multipath-tools/examples/multipath.conf.annotated.gz.

Конфигурационный файл multipath разделяется на следующие секции:

blacklist
Перечисляет специфические устройства, которые не принимаются во внимание multipath.

blacklist_exceptions
Перечисляет кандидатов в множественные устройства, которые иначе будут блокироваться согласно параметрам секции blacklist.

defaults
Общие настройки по умолчанию для DM-Multipath.

multipath
Параметры настроек по характеристикам отдельных множественных устройств. Эти значения переопределяют те, что определены в секциях defaults и devices.

devices
Параметры настроек для отдельных контроллеров хранилищ. Эти значения переопределяют те, что определены в секции defaults. Если вы ииспользуете дисковый массив, который не поддерживается по умолчанию, вам может потребоваться создать для него подсекцию в разделе devices.

Когда система определяет атрибут множественного устройства, сначала она ищет совпадения в секции multipath, потом в devices, и только затем использует значения по умолчанию.

Секция blacklist конфигурационного файла multipath определяет устройства, которые не будут использоваться, когда система настраивает множественные устройства. Устройства, внесенные в список блокировки, не будут группироваться в множественные устройства.

Если вам действительно нужно заблокировать устройства, вы можете сделать это, используя следующие критерии:

1. По WWID, как описано в секции Блокировка по WWID

2. По имени устройства, как описано в секции Блокировка по имени устройства

3. По типу устройства, как описано в секции Блокировка по типу устройства

По умолчанию множество типов устройств блокируются даже если вы комментируете изначальную секцию blacklist конфигурационного файла. Для информации смотрите Блокировка по имени устройства.

Вы можете задать определенные устройства для блокирования по их международному идентификатору (WWID) с использованием метки wwid в секции blacklist конфигурационного файла.

Следующий пример показывает строки конфигурационного файла, которые будут блокировать устройство с WWID 26353900f02796769.

blacklist {
       wwid 26353900f02796769
}

Вы можете заблокировать типы устройств по их именам так, что они не будут использоваться для группировки в множественные устройства, задав метку devnode в секции blacklist.

Следующий пример показывает строки конфигурационного файла, которые заблокируют все SCSI устройства, поскольку они блокируют все устройства sd*.

blacklist {
       devnode "^sd[a-z]"
}

Вы можете использовать метку devnode в секции blacklist для определения отдельных блокируемых устройств вместо всех устройств определенного типа. Тем не менее, это не рекомендуется, поскольку, несмотря на то, что они статично определены в правилах udev, нет гарантии что определенное устройство будет иметь то же имя после перезагрузки. Например, после перезагрузки имя устройства может поменяться с /dev/sda на /dev/sdb.

По умолчанию следующие метки devnode включены в список blacklist. Устройства, определяемые в этой секции, как правило не поддерживают DM-Multipath. Чтобы разрешить любое из перечисленного при создании множественных устройств, вы можете определить их в секции blacklist_exceptions как показано в секции Исключения блокировки.

blacklist {
       devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
       devnode "^hd[a-z]"
}

Вы можете определить отдельные типы устройств в секцию blacklist файла конфигурации с помощью секций device. Следующий пример блокирует все устройства IBM DS4200 и любые производства HP.

blacklist {
       device {
               vendor  "IBM"
               product "3S42"       #DS4200 Product 10
       }
       device {
               vendor  "HP"
               product "*"
       }
}

Вы можете использовать секцию blacklist_exceptions конфигурационного файла для разрешения множественных устройств, заблокированных по умолчанию.

Например, если у вас множество устройств и вы хотите разрешить только одно из них (с WWID 3600d0230000000000e13955cc3757803), вместо того, чтобы блокировать каждое из них отдельно за исключением требуемого, можно заблокировать все и затем разрешить только одно, добавив следующие строки в файл /etc/multipath.conf:

blacklist {
        wwid "*"
}

blacklist_exceptions {
        wwid "3600d0230000000000e13955cc3757803"
}

Когда добавляете устройства в секцию blacklist_exceptions конфигурационного файла, вы должны указывать исключения тем же способом, что и в секции blacklist. Например, исключение по WWID не сработает для устройств, определенных в blacklist с помощью devnode, даже если заблокированное устройство ассоциируется с данным WWID. Точно так же исключения по devnode применимы только к меткам devnode, а исключения по device - к меткам device.

Убрать после выяснения ошибки с заголовком таблицы

Файл конфигурации /etc/multipath.conf включает секцию defaults, которая устанавливает параметр user_friendly_names в yes, как показано ниже:

defaults {
        user_friendly_names yes
}

Это переопределяет значение параметра user_friendly_names по умолчанию.

Конфигурационный файл содержит шаблоны настроек по умолчанию. Эта секция комментируется как показано ниже:

#defaults {
#       udev_dir                /dev
#       polling_interval        5
#       selector                "round-robin 0"
#       path_grouping_policy    failover
#       getuid_callout          "/lib/dev/scsi_id --whitelisted --device=/dev/%n"
#	prio			const
#	path_checker		directio
#	rr_min_io		1000
#	rr_weight		uniform
#	failback		manual
#	no_path_retry		fail
#	user_friendly_names	no
#}

Для переопределения значения по умолчанию любого настраиваемого параметра вы можете скопировать соответствующую строку из этого шаблона в секцию defaults и снять комментарий. Например, чтобы переустановить параметр path_grouping_policy в multibus вместо определенного по умолчанию failover, скопируйте соответствующую строку из шаблона и раскомментируйте ее, как показано ниже:

defaults {
        user_friendly_names     yes
        path_grouping_policy    multibus
}

Таблица настроек Multipath по умолчанию определяет атрибуты, которые устанавливаются в секции defaults файла multipath.conf. Эти значения используются DM-Multipath пока они не переопределены атрибутами, заданными в секциях devices и multipaths в этом же файле.

Настройки Multipath по умолчанию

^ Атрибут ^ Описание ^

Specifies the default path grouping policy to apply to unspecified multipaths. Possible values include: failover = 1 path per priority group multibus = all valid paths in 1 priority group group_by_serial = 1 priority group per detected serial number group_by_prio = 1 priority group per path priority value group_by_node_name = 1 priority group per target node name. The default value is failover. |

Table Multipath Attributes shows the attributes that you can set in the multipaths section of the multipath.conf configuration file for each specific multipath device. These attributes apply only to the one specified multipath. These defaults are used by DM-Multipath and override attributes set in the defaults and devices sections of the multipath.conf file. Multipath Attributes Attribute Description wwid Specifies the WWID of the multipath device to which the multipath attributes apply. This parameter is mandatory for this section of the multipath.conf file. alias Specifies the symbolic name for the multipath device to which the multipath attributes apply. If you are using user_friendly_names, do not set this value to mpathn; this may conflict with an automatically assigned user friendly name and give you incorrect device node names.

In addition, the following parameters may be overridden in this multipath section

  path_grouping_policy

  path_selector

  failback

  prio

  prio_args

  no_path_retry

  rr_min_io

  rr_weight

  flush_on_last_del

The following example shows multipath attributes specified in the configuration file for two specific multipath devices. The first device has a WWID of 3600508b4000156d70001200000b0000 and a symbolic name of yellow.

The second multipath device in the example has a WWID of 1DEC_321816758474 and a symbolic name of red. In this example, the rr_weight attributes is set to priorities.

multipaths {

     multipath {
            wwid                  3600508b4000156d70001200000b0000
            alias                 yellow
            path_grouping_policy  multibus
            path_selector         "round-robin 0"
            failback              manual
            rr_weight             priorities
            no_path_retry         5
     }
     multipath {
            wwid                  1DEC_____321816758474
            alias                 red
            rr_weight             priorities
      }

}

Table Device Attributes shows the attributes that you can set for each individual storage device in the devices section of the multipath.conf configuration file. These attributes are used by DM-Multipath unless they are overwritten by the attributes specified in the multipaths section of the multipath.conf file for paths that contain the device. These attributes override the attributes set in the defaults section of the multipath.conf file.

Many devices that support multipathing are included by default in a multipath configuration. The values for the devices that are supported by default are listed in the multipath.conf.defaults file. You probably will not need to modify the values for these devices, but if you do you can overwrite the default values by including an entry in the configuration file for the device that overwrites those values. You can copy the device configuration defaults from the multipath.conf.annotated.gz or if you wish to have a brief config file, multipath.conf.synthetic file for the device and override the values that you want to change.

To add a device to this section of the configuration file that is not configured automatically by default, you must set the vendor and product parameters. You can find these values by looking at /sys/block/device_name/device/vendor and /sys/block/device_name/device/model where device_name is the device to be multipathed, as in the following example:

# cat /sys/block/sda/device/vendor WINSYS # cat /sys/block/sda/device/model SF2372

The additional parameters to specify depend on your specific device. If the device is active/active, you will usually not need to set additional parameters. You may want to set path_grouping_policy to multibus. Other parameters you may need to set are no_path_retry and rr_min_io, as described in Table Multipath Attributes.

If the device is active/passive, but it automatically switches paths with I/O to the passive path, you need to change the checker function to one that does not send I/O to the path to test if it is working (otherwise, your device will keep failing over). This almost always means that you set the path_checker to tur; this works for all SCSI devices that support the Test Unit Ready command, which most do.

If the device needs a special command to switch paths, then configuring this device for multipath requires a hardware handler kernel module. The current available hardware handler is emc. If this is not sufficient for your device, you may not be able to configure the device for multipath. Device Attributes Attribute Description vendor Specifies the vendor name of the storage device to which the device attributes apply, for example COMPAQ. product Specifies the product name of the storage device to which the device attributes apply, for example HSV110 (C)COMPAQ. revision Specifies the product revision identifier of the storage device. product_blacklist Specifies a regular expression used to blacklist devices by product. hardware_handler

Specifies a module that will be used to perform hardware specific actions when switching path groups or handling I/O errors. Possible values include:

  1 emc: hardware handler for EMC storage arrays

  1 alua: hardware handler for SCSI-3 ALUA arrays.

  1 hp_sw: hardware handler for Compaq/HP controllers.

  1 rdac: hardware handler for the LSI/Engenio RDAC controllers.

In addition, the following parameters may be overridden in this device section

  path_grouping_policy

  getuid_callout

  path_selector

  path_checker

  features

  failback

  prio

  prio_args

  no_path_retry

  rr_min_io

  rr_weight

  fast_io_fail_tmo

  dev_loss_tmo

  flush_on_last_del

Whenever a hardware_handler is specified, it is your responsibility to ensure that the appropriate kernel module is loaded to support the specified interface. These modules can be found in /lib/modules/`uname -r`/kernel/drivers/scsi/device_handler/ . The requisite module should be integrated into the initrd to ensure the necessary discovery and failover-failback capacity is available during boot time. Example,

# cat scsi_dh_alua » /etc/initramfs-tools/modules ## append module to file # update-initramfs -u -k all

The following example shows a device entry in the multipath configuration file.

#devices { # device { # vendor «COMPAQ » # product «MSA1000 » # path_grouping_policy multibus # path_checker tur # rr_weight priorities # } #}

The spacing reserved in the vendor, product, and revision fields are significant as multipath is performing a direct match against these attributes, whose format is defined by the SCSI specification, specifically the Standard INQUIRY command. When quotes are used, the vendor, product, and revision fields will be interpreted strictly according to the spec. Regular expressions may be integrated into the quoted strings. Should a field be defined without the requisite spacing, multipath will copy the string into the properly sized buffer and pad with the appropriate number of spaces. The specification expects the entire field to be populated by printable characters or spaces, as seen in the example above

  vendor: 8 characters

  product: 16 characters

  revision: 4 characters

To create a more robust configuration file, regular expressions can also be used. Operators include ^ $ [ ] . * ? +. Examples of functional regular expressions can be found by examining the live multipath database and multipath.conf example files found in /usr/share/doc/multipath-tools/examples:

# echo 'show config' | multipathd -k