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

Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
wiki:руководство_по_ubuntu_server:множественное_связывание_устройств:configuration [2012/05/28 17:01]
[Устройства в файле конфигурации]
wiki:руководство_по_ubuntu_server:множественное_связывание_устройств:configuration [2013/02/20 09:06] (текущий)
Строка 10: Строка 10:
 По умолчанию DM-Multipath предоставляет конфигурации для большинства множественных устройств. В дополнение к этому DM-Multipath включает поддержку большинства массивов хранения,​ которые поддерживают DM-Multipath. Значения конфигураций по умолчанию и поддерживаемые устройства можно найти в файле multipath.conf.defaults. По умолчанию DM-Multipath предоставляет конфигурации для большинства множественных устройств. В дополнение к этому DM-Multipath включает поддержку большинства массивов хранения,​ которые поддерживают DM-Multipath. Значения конфигураций по умолчанию и поддерживаемые устройства можно найти в файле multipath.conf.defaults.
  
-Вы можете переопределить настроенные значения по умолчанию для DM-Multipath,​ изменив конфигурационный файл /​etc/​multipath.conf. Если необходимо,​ вы можете также добавить массив хранения,​ который не поддерживается по умолчанию,​ в конфигурационный файл. Эта глава предоставляет информацию по разбору иизменению файла multipath.conf. Она содержит следующие секции:​+Вы можете переопределить настроенные значения по умолчанию для DM-Multipath,​ изменив конфигурационный файл /​etc/​multipath.conf. Если необходимо,​ вы можете также добавить массив хранения,​ который не поддерживается по умолчанию,​ в конфигурационный файл. Эта глава предоставляет информацию по разбору и изменению файла multipath.conf. Она содержит следующие секции:​
  
   -- [[#​обзор_файла_конфигурации|Обзор файла конфигурации]]   -- [[#​обзор_файла_конфигурации|Обзор файла конфигурации]]
Строка 18: Строка 18:
   -- [[#​устройства_в_файле_конфигурации|Устройства в файле конфигурации]]   -- [[#​устройства_в_файле_конфигурации|Устройства в файле конфигурации]]
  
-В файле конфигурации multipath вам нужно определить только те секции,​ которые вам потребуются для ваших настройек или те, для которых вы захотите изменить значения по умолчанию,​ определенные в multipath.conf.defaults. Если в файле присутствуют секции не относящиеся к вашему оборудованию или для которых вы не хотите менять значения по умолчанию,​ вы можете оставить их закомментированными,​ как в изначальном файле.+В файле конфигурации multipath вам нужно определить только те секции,​ которые вам потребуются для ваших настроек или те, для которых вы захотите изменить значения по умолчанию,​ определенные в multipath.conf.defaults. Если в файле присутствуют секции не относящиеся к вашему оборудованию или для которых вы не хотите менять значения по умолчанию,​ вы можете оставить их закомментированными,​ как в изначальном файле.
  
 Файл конфигурации допускает синтаксис регулярных выражений. Файл конфигурации допускает синтаксис регулярных выражений.
Строка 41: Строка 41:
  
 **devices**\\ **devices**\\
-Параметры настроек для отдельных контроллеров хранилищ. Эти значения переопределяют те, что определены в секции **defaults**. Если вы ииспользуете дисковый массив,​ который не поддерживается по умолчанию,​ вам может потребоваться создать для него подсекцию в разделе **devices**.+Параметры настроек для отдельных контроллеров хранилищ. Эти значения переопределяют те, что определены в секции **defaults**. Если вы используете дисковый массив,​ который не поддерживается по умолчанию,​ вам может потребоваться создать для него подсекцию в разделе **devices**.
  
 Когда система определяет атрибут множественного устройства,​ сначала она ищет совпадения в секции **multipath**,​ потом в **devices**,​ и только затем использует значения по умолчанию. Когда система определяет атрибут множественного устройства,​ сначала она ищет совпадения в секции **multipath**,​ потом в **devices**,​ и только затем использует значения по умолчанию.
Строка 227: Строка 227:
 Если устройство активно/​пассивное,​ но автоматически переключает маршруты ввода/​вывода на пассивный маршрут,​ вам потребуется изменить функцию проверки на ту, которая не посылает поток ввода/​вывода для проверки работоспособности (иначе ваше устройство будет постоянно находиться в состоянии сбоя). Это также всегда подразумевает,​ что вы установили **path_checker** в **tur**; это работает для всех SCSI устройств,​ которые поддерживают команду **Test Unit Ready**, которых большинство. Если устройство активно/​пассивное,​ но автоматически переключает маршруты ввода/​вывода на пассивный маршрут,​ вам потребуется изменить функцию проверки на ту, которая не посылает поток ввода/​вывода для проверки работоспособности (иначе ваше устройство будет постоянно находиться в состоянии сбоя). Это также всегда подразумевает,​ что вы установили **path_checker** в **tur**; это работает для всех SCSI устройств,​ которые поддерживают команду **Test Unit Ready**, которых большинство.
  
-Если устройство требует специальной команды для переключения маршрутов,​ то настройка этого устройства требует модуля ядра для управления оборудованием. Доступный в данное время обработчик - это **emc**. Если это не обосновано для вашего устройства,​ то вы не сможете настроить устройство для multipath.+Если устройство требует специальной команды для переключения маршрутов,​ то настройка этого устройства требует модуля ядра для управления оборудованием. Доступный в данное время обработчик - это **emc**. Если это не подходит ​для вашего устройства,​ то возможно у вас не получится настроить устройство для multipath.
  
 ==Атрибуты устройств== ==Атрибуты устройств==
 ^ Атрибут ​ ^ Описание ​ ^ ^ Атрибут ​ ^ Описание ​ ^
-| vendor ​ | Specifies the vendor name of the storage device to which the device attributes applyfor example ​COMPAQ. ​ | +| vendor ​ | Определяет имя производителя устройства хранениядля которого применяют атрибуты,​ например,​ **COMPAQ**.  | 
-| product ​ | Specifies the product name of the storage device to which the device attributes applyfor example ​HSV110 (C)COMPAQ. ​ | +| product ​ | Определяет название продукта устройства хранения,​ для которого применяют атрибуты,​ например**HSV110 (C)COMPAQ**.  | 
-| revision ​ | Specifies the product revision identifier of the storage device +| revision ​ | Определяет идентификатор версии устройства хранения. | 
-| product_blacklist ​ | Specifies a regular expression used to blacklist devices by product+| product_blacklist ​ | Определяет регулярное выражение для блокировки устройства по его названию | 
-| hardware_handler ​ | %%Specifies a module that will be used to perform hardware specific actions when switching path groups or handling I/O errorsPossible values include: +| hardware_handler ​ | Определяет модуль,​ который будет использован для выполнения специфических действий,​ когда переключается группа маршрутов или обнаруживается ошибка ввода/выводаВозможные значения включают\\ 1. **1 emc**обработчик для массивов хранения ​EMC. \\ 2. **1 alua**обработчик для ​SCSI-3 ​массивов ​ALUA. \\ 3. **1 hp_sw**обработчик для контроллеров ​Compaq/​HP. ​\\ 4. **1 rdac**обработчик для контроллеров ​LSI/Engenio RDAC.  |
- +
-    ​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+
  
 +В дополнение следующие параметры могут быть переопределены в секции **device**:
   -- path_grouping_policy   -- path_grouping_policy
   -- getuid_callout   -- getuid_callout
Строка 262: Строка 253:
   -- flush_on_last_del   -- flush_on_last_del
  
-<​note>​Whenever a hardware_handler ​is specifiedit is your responsibility to ensure that the appropriate kernel module is loaded to support the specified interfaceThese 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 timeExample, +<​note>​Каждый раз, как определяется **hardware_handler**ваша обязанность проверить,​ что соответствующий модуль ядра загружен для поддержки указанного интерфейсаЭти модули могут быть найдены в **%%/​lib/​modules/​`uname -r`/​kernel/​drivers/​scsi/​device_handler/​%%** Необходимый модуль должен быть интегрирован в initrd, чтобы гарантировать обязательное обнаружение и способность обхода-восстановления сбоев, доступные во время загрузкиНапример,
 <​code>#​ cat scsi_dh_alua >> /​etc/​initramfs-tools/​modules ​ ## append module to file <​code>#​ cat scsi_dh_alua >> /​etc/​initramfs-tools/​modules ​ ## append module to file
 # update-initramfs -u -k all</​code></​note>​ # update-initramfs -u -k all</​code></​note>​
  
-The following example shows a device ​entry in the multipath ​configuration file. +Следующий пример показывает **device** метку в конфигурационном файле ​multipath:
 <​code>#​devices { <​code>#​devices {
 # device { # device {
Строка 279: Строка 268:
 #​}</​code>​ #​}</​code>​
  
-The spacing reserved in the vendor, product, and revision ​fields are significant as multipath ​is performing a direct match against these attributeswhose format is defined by the SCSI specificationspecifically the Standard INQUIRY ​commandWhen quotes are usedthe vendor, product, and revision ​fields will be interpreted strictly according to the specRegular expressions may be integrated into the quoted stringsShould 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 spacesThe specification expects the entire field to be populated by printable characters or spacesas seen in the example above +Пробелы,​ оставленные в полях **vendor****product** и **revision**, имеют значение,​ поскольку ​multipath ​выполняет прямое сравнение этих атрибутовчей формат определен в спецификациях ​SCSI, особенно команда [[http://​en.wikipedia.org/​wiki/​SCSI_Inquiry_Command|Standard INQUIRY]]Когда используются кавычкиполя ​vendor, product ​и revision ​будут интерпретироваться строго по спецификацииРегулярные выражения могут интегрироваться в закавыченные строкиПолябудучи объявлены без требуемых пробелов,​ будут скопированы ​multipath ​в буфер правильного размера и дополнены требуемым количеством пробеловСпецификация ожидаетчто все поле будет заполнено печатаемыми символами или пробелами,​ как видно в примере выше:
- +
-  -- vendor: 8 characters +
-  -- product: 16 characters +
-  -- revision4 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:+  ​-- vendor: 8 символов 
 +  -- product: 16 символов 
 +  -- revision4 имвола
  
 +Для создания более крепкого файла конфигурации могут быть также использованы регулярные выражения. Операторы включают **%%^ $ [ ] . * ? +%%**. Примеры работающих регулярных выражений могут быть найдены при исследовании примеров живой базы multipath и файла multipath.conf,​ находящихся в /​usr/​share/​doc/​multipath-tools/​examples:​
 <​code>#​ echo 'show config'​ | multipathd -k</​code>​ <​code>#​ echo 'show config'​ | multipathd -k</​code>​