4.5. Секция devices файла конфигурации

Таблица 4.3, «Атрибуты устройств» 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.
Многие устройства, поддерживающие работу с несколькими маршрутами, включены по умолчанию в конфигурацию и перечислены в файле multipath.conf.defaults. Обычно нет необходимости в изменении стандартных определений, но если вам все-таки необходимо это сделать, то просто добавьте соответствующую запись для конкретного устройства в файл конфигурации. Можно скопировать исходные настройки из multipath.conf.defaults и затем откорректировать значения.
Чтобы добавить в эту секцию нестандартное устройство, сначала нужно установить параметры vendor и product. Их значения можно найти в /sys/block/имя_устройства/device/vendor и /sys/block/имя_устройства/device/model. Пример:
[root@cypher-06 ~]# cat /sys/block/sda/device/vendor
WINSYS  
[root@cypher-06 ~]# 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 Таблица 4.3, «Атрибуты устройств».
Если же устройство будет функционировать в режиме «активно - пассивно», но при этом будет выполняться переключение на пассивный маршрут, необходимо изменить функцию перехода так, чтобы она не отправляла запросы ввода/ вывода маршруту с целью проверки его работоспособности. Для этого обычно следует присвоить параметру path_checker значение tur.
If the device needs a special command to switch paths, then configuring this device for multipath requires a hardware handler kernel module. The current hardware handlers are emc and "rdac. If these are not sufficient for your device, you may not be able to configure the device for multipath.

Таблица 4.3. Атрибуты устройств

Атрибут Описание
vendor Производитель устройства, например, COMPAQ.
product Имя, например, HSV110 (C)COMPAQ.
path_grouping_policy
Задает текущую политику объединения маршрутов, которая будет применяться к неопределенным маршрутам. Возможные значения:
failover = 1 путь на группу
multibus = все допустимые маршруты в одну группу
group_by_serial = 1 группа на определенный серийный номер
group_by_prio = 1 группа на значение приоритета маршрута
group_by_node_name = 1 группа на имя целевого узла
getuid_callout Specifies the default program and arguments to call out to obtain a unique path identifier. An absolute path is required.
prio_callout Specifies the the default program and arguments to call out to obtain a path weight. Weights are summed for each path group to determine the next path group to use in case of failue. "none" is a valid value.
path_checker Задает метод определения состояния маршрутов. Допустимые значения: readsector0, tur, emc_clariion, hp_sw, directio.
path_selector Определяет алгоритм определения маршрута, куда будет направлен следующий запрос ввода/ вывода.
features The extra features of multipath devices. The only existing feature is queue_if_no_path, which is the same as setting no_path_retry to queue. For information on issues that may arise when using this feature, see Раздел 5.3, «Issues with queue_if_no_path feature».
hardware_handler Определяет модуль, который будет использоваться для выполнения действий, специфичных для оборудования, при переключении между группами маршрутов или обработке ошибок ввода/ вывода. Допустимые значения: 0, 1 emc, 1 rdac. По умолчанию используется 0.
rr_weight
If set to priorities, then instead of sending rr_min_io requests to a path before calling selector to choose the next path, the number of requests to send is determined by rr_min_io times the path's priority, as determined by the prio_callout program. Currently, there are priority callouts only for devices that use the group_by_prio path grouping policy, which means that all the paths in a path group will always have the same priority.
Если установлено значение uniform (используется по умолчанию), то все маршруты будут равноправны.
no_path_retry
Цифровая величина задает число попыток использования проблемного маршрута, прежде чем запросы прекратят ожидание.
Значение fail подразумевает немедленный отказ без ожидания.
Значение queue обозначает, что ожидание запросов не должно прекращаться, до тех пора пока маршрут не будет восстановлен.
По умолчанию используется (null).
failback
Определяет метод переключения маршрутов.
Значение 0 или immediate обозначает, что если существует группа маршрутов с более высоким приоритетом по сравнению с текущей группой, система начнет ее использовать.
Положительная величина определит период времени (в секундах), который должен истечь, прежде чем будет выполнено переключение.
Значение manual обозначает, что переключение должно быть выполнено вручную.
rr_min_io Задает число направляемых по маршруту запросов ввода и вывода, прежде чем начнет использоваться следующий маршрут в группе. По умолчанию будет обработано 1000 запросов.
flush_on_last_del (RHEL 5.3 и более поздние версии) Если установлено в yes, то демон multipathd отключит возможность постановки в очередь, если удален последний маршрут к устройству. По умолчанию используется значение no.
product_blacklist Регулярное выражение для фильтрования устройств по названию продукта.
Следующий пример демонстрирует пример записи device в файле конфигурации:
#	}
#	device {
#		vendor			"COMPAQ  "
#		product			"MSA1000         "
#		path_grouping_policy	multibus
#		path_checker		tur
#		rr_weight		priorities
#	}
#}