mdadm

Управлять программными RAID-массивами MD.

Готовые примеры · man page

Флаги

=act Установить "sync_action" для всех указанных md-устройств в одно из значений: idle, frozen, check или repair (idle прерывает текущее действие, frozen прерывает и не даёт запустить новому).

В режиме Grow добавить одно или несколько устройств: в Linear они просто присоединяются к концу массива (удалить потом нельзя), а при увеличении --raid-disks включаются в массив.

=device добавить журнал в существующий массив или воссоздать журнал для RAID-4/5/6, потерявшего журнальное устройство; работает только для массива в состоянии Read-Only, чтобы не прерывать идущие записи.

Добавить устройство как запасное (spare): в отличие от --add сначала не пытается выполнить --re-add, поэтому устройство становится spare, даже если похоже на недавнего члена массива.

=command Задать программу, запускаемую при каждом обнаруженном событии; настраивается в mdadm.conf как PROGRAM.

=K задать видимый размер массива (только вместе с --grow, эффект непостоянен после остановки и запуска); требуется перед уменьшением формы массива, так как reshape необратим.

Собрать (assemble) уже существующий массив.

сообщить mdadm, что массив существовал заранее и заведомо чист: позволяет избежать начальной синхронизации при создании RAID1/RAID10 или восстановлении после крупного сбоя; используйте только точно зная, что делаете.

Запросить у ядра запуск всех автоматически обнаруженных массивов; работает только при встроенном в ядро md (не модуле) и v0.90-метаданных в первичных MS-DOS-разделах типа FD.

=path нужен, когда --grow увеличивает число RAID-устройств в RAID5/RAID6 без запасных, либо уменьшает массив, меняет уровень или layout; файл должен лежать на отдельном устройстве, не на перестраиваемом массиве.

= задать способ хранения bitmap намерения записи (write-intent bitmap): internal — bitmap хранится вместе с метаданными на массиве и реплицируется на все устройства; clustered — массив создаётся для кластерной среды, по одной bitmap на каждый узел из --nodes, хранение внутреннее; none — создать массив без bitmap или удалить существующую (режим grow).

=K задать размер блока bitmap: каждый бит соответствует такому числу килобайт хранилища; для internal bitmap по умолчанию 64Meg или больше, чтобы вместиться в отведённое пространство.

Быть менее подробным (с --detail и --examine); вместе с --verbose даёт среднюю степень подробности.

Построить legacy-массив без суперблоков.

=K задать размер чередующегося блока (chunk) в килобайтах: 512KB по умолчанию при создании, 64KB при build без постоянных метаданных; значимо для RAID0/4/5/6/10, степени двойки минимум 4KB.

=slot:name подтвердить наличие устройства в ответ на запрос --add от другого узла кластера (передача идёт через udev с uuid устройства и номером слота).

Задать файл или каталог конфигурации; по умолчанию используются стандартные пути.

= задать, как массив поддерживает согласованность при неожиданном выключении (значимо только для уровней с избыточностью): resync — полная пересинхронизация и регенерация избыточности после нечистого выключения; bitmap — ресинк с помощью bitmap намерения записи (выбирается неявно при --bitmap); journal — журнал транзакций на журнальном устройстве для RAID 4/5/6; ppl — Partial Parity Log для RAID5.

Создать новый массив.

Разрешить mdadm работать фоновым демоном, если он решил за чем-то наблюдать: процесс порождается дочерним и отрывается от терминала, его pid пишется в стандартный вывод или в файл по -i.

=K явно задать смещение начала данных массива (для 1.x-метаданных между началом устройства и данными); обычно вычисляется автоматически, значение в килобайтах, если суффикс K/M/G/T не указан иначе.

=seconds Задать задержку в секундах (по умолчанию 60): mdadm опрашивает md-массивы и ждёт столько секунд перед следующим опросом, если событий не было; настраивается в mdadm.conf как MONITORDELAY.

Вывести подробности об одном или нескольких md-устройствах.

=format вывести сведения о возможностях RAID платформы (прошивка/аппаратная топология) для данного формата метаданных; без аргумента сканируются все контроллеры.

=file сохранить метаданные с перечисленных устройств либо восстановить метаданные на перечисленные устройства.

Вывести содержимое метаданных на названных устройствах (в отличие от --detail, применяющегося к самому md-устройству, --examine относится к устройствам-компонентам массива).

Перечислить испорченные блоки (bad-blocks), записанные для устройства, если для него настроен такой список; списки bad-blocks поддерживают пока только метаданные 1.x и IMSM.

Вывести сведения о bitmap; аргументом является компонент массива (запуск на самом устройстве массива, например /dev/md0, bitmap того массива не показывает).

При использовании с --detail, --detail-platform, --examine или --incremental форматировать вывод как пары key=value для простого импорта в окружение (MD_STARTED даёт yes при успешной инкрементальной сборке).

Пометить перечисленные устройства как неисправные (faulty); вместо имени файла можно указать слово detached или имя набора вида set-A, чтобы пометить сразу весь набор.

пометить последующие устройства из команд --create или --add флагом 'failfast' (только RAID1 и RAID10): запросы IO к ним быстрее завершаются ошибкой, ошибки чтения не восстанавливаются.

Режим наблюдения (monitor).

Быть настойчивее при выполнении отдельных операций (точное значение зависит от режима).

Изменить размер или конфигурацию активного массива.

Вывести общую справку, а после одного из режимных параметров — справку по этому режиму.

Вывести более подробную справку о разборе командной строки и некоторых часто используемых параметрах.

=name задать имя кластера для md-устройства: собрать его можно только в кластере с совпадающим именем; если не указано, mdadm пытается определить имя автоматически.

=name переопределить HOMEHOST из конфига и задать идентичность узла, считающегося домом для массивов; при создании записывается в метаданные, при авто-сборке принимаются только массивы этого дома.

=percent Задать процентный шаг: mdadm генерирует события RebuildNN с указанным процентным приращением.

Добавить или удалить одно устройство из подходящего массива и, возможно, запустить этот массив (инкрементальная сборка).

Указывает, что резервный файл для --backup-file недоступен и передан пустой файл: данные, перестраивавшиеся в момент сбоя, могут быть безвозвратно потеряны, остальной массив ещё восстановим; крайняя мера.

=array Если устройство — контейнер, а аргумент указывает неактивный подряд (subarray) контейнера, удалить этот подряд; удаление всех подрядов оставляет на дисках 'empty-container' или spare-суперблок.

=layout задать детали расположения данных для массивов RAID5, RAID6 и RAID10 и режимы отказов для faulty (например left-symmetric по умолчанию для RAID5, parity-first/parity-last, ddf-совместимые варианты).

=level задать уровень RAID: linear, raid0/0/stripe, raid1/1/mirror, raid4/4, raid5/5, raid6/6, raid10/10, multipath/mp, faulty, container; часть имён синонимична, с --build допустимы не все.

=K задать логический размер блоков массива (только в режиме Create и при метаданных версии 1.x); при смешанных LBS 512 и 4K массив по умолчанию использует 4K, но после удаления такого диска и перезагрузки возвращается к 512.

=address Задать адрес почты для отправки предупреждений; настраивается в mdadm.conf как MAILADDR.

=style объявить стиль метаданных RAID (суперблока): по умолчанию 1.2 для --create, а для прочих операций — подбор автоматически; значение можно переопределить параметром metadata ключевого слова CREATE в mdadm.conf.

Режим наблюдения (monitor).

=name задать имя массива длиной не более 32 символов; действует при создании массива с v1-метаданными или внешнего массива; если имя нужно, но не задано, берется basename создаваемого устройства.

Запретить запуск массива, пока присутствуют не все ожидаемые диски (обратное к --run); нужен только вместе с --scan и предотвращает запуск деградированного массива, который мог быть собран вне дома.

Запретить перемещение запасных дисков (spares) между массивами; разрешено только одному мониторингу с --scan.

=number задать максимальное число узлов кластера, одновременно использующих это устройство (работает только при создании массива для кластерной среды; по умолчанию 4).

повторно добавляемые устройства добавляются без установленного флага 'failfast'.

Полное имя -1: проверить массивы только один раз.

=layout то же, что --layout (чем объясняется буква p в -p).

=path Используется только с --fail: запоминает указанный путь, чтобы новое устройство на том же месте могло быть автоматически добавлено в тот же массив без метаданных; обычно устанавливается скриптом udev.

=file Когда mdadm работает в режиме демона, писать pid демонического процесса в указанный файл вместо вывода его в стандартный поток.

=component предпочесть более длинное имя устройства в /dev, содержащее указанный компонент пути (например --prefer=by-uuid); работает для --detail и --monitor.

=command Задать программу, запускаемую при каждом обнаруженном событии; настраивается в mdadm.conf как PROGRAM.

Обследовать устройство, чтобы выяснить (1) является ли оно md-устройством и (2) является ли компонентом md-массива, и представить найденную информацию.

Не выводить чисто информационные сообщения: mdadm молчит, пока не появится что-то действительно важное.

=number задать число активных устройств в массиве; вместе с числом запасных оно должно равняться количеству перечисленных компонентов; значение 1 требует предварительного --force и недопустимо для RAID4/5/6.

Вновь добавить устройство, ранее удалённое из массива: если метаданные подтверждают членство, а его слот свободен, устройство возвращается на то же место (восстановление может потребоваться полностью, по bitmap или не потребоваться вовсе).

Запустить массив только для чтения, а не на чтение-запись: запись невозможна, resync/recovery/reshape не запускаются; работает в режимах Create, Assemble, Manage и Misc.

Снимают флаг 'write-mostly' с последующих добавляемых или повторно добавляемых устройств.

Перестроить файл карты (/run/mdadm/map), который mdadm использует для отслеживания того, какие массивы сейчас собираются.

Удалить перечисленные устройства (они не должны быть активны — только faulty или spare); допускаются слова failed, detached и имена наборов вроде set-A.

Пометить перечисленные устройства как требующие замены: как только появится spare, оно будет перестроено и заменит помеченное устройство, которое остаётся в строю до конца восстановления, а затем помечается faulty.

=file сохранить метаданные с перечисленных устройств либо восстановить метаданные на перечисленные устройства.

=K задать множитель округления для Linear-массива: размер каждого компонента округляется вниз до кратного ему величины; синоним --chunk, подчёркивающий иной смысл для Linear (по умолчанию 0K).

Настаивать на запуске массива mdadm, даже если часть компонентов выглядит активной в другом массиве или файловая система; подавляет обычный запрос подтверждения.

Искать недостающую информацию в файле конфигурации или /proc/mdstat: разрешает mdadm брать отсутствующие сведения (устройства-компоненты, устройства массива, идентификаторы, адрес уведомлений) оттуда.

то же, что --fail.

=K задать объём (в килобайтах), используемый с каждого диска в RAID 1/4/5/6/10 и для RAID 0 на внешних метаданных; кратно размеру блока, оставляет около 128Kb под суперблок, значение max берёт минимальный диск.

=number задать число запасных (eXtra) устройств в начальном массиве; запасные можно добавлять и удалять позже, а суммарное число компонентов в командной строке должно совпадать с RAID-устройствами плюс запасные.

Деактивировать массив, освободив все ресурсы.

=minor задать младший номер устройства, для которого создан массив: устройства с другим младшим номером исключаются (массив /dev/md1 имеет старший 9, младший 1).

Сообщать обо всех событиях через 'syslog': сообщения получают facility 'daemon' и различающиеся приоритеты.

Если серьёзных ошибок нет, завершаться с кодом 2, когда изменений массива не произошло, и 0 при хотя бы одном изменении; полезно с косвенными спецификаторами missing, detached или faulty.

=POLICY Сгенерировать правила udev в файл, обрабатывающий горячее подключение bare-устройств, согласно ПОЛИТИКАМ, определённым в /etc/mdadm.conf (или /etc/mdadm/mdadm.conf); см. mdadm.conf(5).

=field обновить суперблок на каждом устройстве при сборке массива; аргументом может быть summaries, uuid, name, nodes, homehost, home-cluster, resync, byteorder, devicesize, no-bitmap, bbl, no-bbl, ppl, no-ppl, layout-original, layout-alternate, layout-unspecified, metadata или super-minor.

=field Если устройство — контейнер, а аргумент указывает на подряд (subarray) в контейнере, попытаться обновить заданное поле суперблока этого подряда (подробности — в разделе MISC MODE).

=uuid задать uuid собираемого массива: устройства без этого uuid исключаются.

Более подробно сообщать о происходящем (можно указать дважды для особой подробности; влияет пока только на --detail --scan и --examine --scan).

Вывести сведения о версии mdadm.

Для каждого указанного md-устройства дождаться завершения resync, recovery или reshape перед возвратом; успех только если реально дождался каждого перечисленного устройства.

Для каждого указанного md-устройства (или каждого из /proc/mdstat при --scan) как можно скорее пометить массив чистым; для нативных массивов возвращает управление сразу, так как ядро обрабатывает переходы dirty-clean при выключении.

=device указать после списка --replace устройства, которыми преимущественно заменяются помеченные; они уже должны быть запасными в этом массиве.

=number включить режим write-behind (только RAID1); аргумент задаёт максимальное число незавершённых записей (по умолчанию 256), требуется write-intent bitmap, попытки идут лишь на write-mostly диски.

=device задать устройство журнала для массива RAID-4/5/6; журнальное устройство должно быть SSD с разумным ресурсом.

пометить последующие устройства из команд --build, --create или --add флагом 'write-mostly' (только RAID1): драйвер md избегает чтения с них, полезно при зеркалировании по медленному каналу.

при создании массива послать запросы записи нулей на все блочные устройства, чтобы обнулить область данных и обойтись без начальной синхронизации (ведёт себя как --assume-clean); значимо только с --create.

Если устройство содержит допустимый md-суперблок, затереть его нулями; с --force затирается место, где суперблок мог бы быть, даже если он не выглядит допустимым (осторожно с кластерным RAID).

Проверить массивы только один раз (генерирует события NewArray, DegradedArray и SparesMissing).

Собрать (assemble) уже существующий массив.

Построить legacy-массив без суперблоков.

Создать новый массив.

Вывести подробности об одном или нескольких md-устройствах.

Вывести содержимое метаданных на названных устройствах (в отличие от --detail, применяющегося к самому md-устройству, --examine относится к устройствам-компонентам массива).

Режим наблюдения (monitor).

Изменить размер или конфигурацию активного массива.

Добавить или удалить одно устройство из подходящего массива и, возможно, запустить этот массив.

=name задать имя массива длиной не более 32 символов; действует при создании массива с v1-метаданными или внешнего массива; если имя нужно, но не задано, берется basename создаваемого устройства.

Обследовать устройство, чтобы выяснить (1) является ли оно md-устройством и (2) является ли компонентом md-массива, и представить найденную информацию.

Настаивать на запуске массива mdadm, даже если часть компонентов выглядит активной в другом массиве или файловая система; подавляет обычный запрос подтверждения.

Деактивировать массив, освободив все ресурсы.

=field обновить суперблок на каждом устройстве при сборке массива; аргументом может быть summaries, uuid, name, nodes, homehost, home-cluster, resync, byteorder, devicesize, no-bitmap, bbl, no-bbl, ppl, no-ppl, layout-original, layout-alternate, layout-unspecified, metadata или super-minor.

Вывести сведения о версии mdadm.

пометить последующие устройства из команд --build, --create или --add флагом 'write-mostly' (только RAID1): драйвер md избегает чтения с них, полезно при зеркалировании по медленному каналу.

Вывести сведения о bitmap; аргументом является компонент массива (запуск на самом устройстве массива, например /dev/md0, bitmap того массива не показывает).

При использовании с --detail, --detail-platform, --examine или --incremental форматировать вывод как пары key=value для простого импорта в окружение (MD_STARTED даёт yes при успешной инкрементальной сборке).

=K задать видимый размер массива (только вместе с --grow, эффект непостоянен после остановки и запуска); требуется перед уменьшением формы массива, так как reshape необратим.

В режиме Grow добавить одно или несколько устройств: в Linear они просто присоединяются к концу массива (удалить потом нельзя), а при увеличении --raid-disks включаются в массив.

= задать способ хранения bitmap намерения записи (write-intent bitmap): internal — bitmap хранится вместе с метаданными на массиве и реплицируется на все устройства; clustered — массив создаётся для кластерной среды, по одной bitmap на каждый узел из --nodes, хранение внутреннее; none — создать массив без bitmap или удалить существующую (режим grow).

=K задать размер чередующегося блока (chunk) в килобайтах: 512KB по умолчанию при создании, 64KB при build без постоянных метаданных; значимо для RAID0/4/5/6/10, степени двойки минимум 4KB.

=seconds Задать задержку в секундах (по умолчанию 60): mdadm опрашивает md-массивы и ждёт столько секунд перед следующим опросом, если событий не было; настраивается в mdadm.conf как MONITORDELAY.

=style объявить стиль метаданных RAID (суперблока): по умолчанию 1.2 для --create, а для прочих операций — подбор автоматически; значение можно переопределить параметром metadata ключевого слова CREATE в mdadm.conf.

Быть настойчивее при выполнении отдельных операций (точное значение зависит от режима).

Вывести общую справку, а после одного из режимных параметров — справку по этому режиму.

=file Когда mdadm работает в режиме демона, писать pid демонического процесса в указанный файл вместо вывода его в стандартный поток.

= задать, как массив поддерживает согласованность при неожиданном выключении (значимо только для уровней с избыточностью): resync — полная пересинхронизация и регенерация избыточности после нечистого выключения; bitmap — ресинк с помощью bitmap намерения записи (выбирается неявно при --bitmap); journal — журнал транзакций на журнальном устройстве для RAID 4/5/6; ppl — Partial Parity Log для RAID5.

=level задать уровень RAID: linear, raid0/0/stripe, raid1/1/mirror, raid4/4, raid5/5, raid6/6, raid10/10, multipath/mp, faulty, container; часть имён синонимична, с --build допустимы не все.

=minor задать младший номер устройства, для которого создан массив: устройства с другим младшим номером исключаются (массив /dev/md1 имеет старший 9, младший 1).

=number задать число активных устройств в массиве; вместе с числом запасных оно должно равняться количеству перечисленных компонентов; значение 1 требует предварительного --force и недопустимо для RAID4/5/6.

Запустить массив только для чтения, а не на чтение-запись: запись невозможна, resync/recovery/reshape не запускаются; работает в режимах Create, Assemble, Manage и Misc.

=layout задать детали расположения данных для массивов RAID5, RAID6 и RAID10 и режимы отказов для faulty (например left-symmetric по умолчанию для RAID5, parity-first/parity-last, ddf-совместимые варианты).

Не выводить чисто информационные сообщения: mdadm молчит, пока не появится что-то действительно важное.

Удалить перечисленные устройства (неактивные: faulty или spare); кроме имени файла (например /dev/sda1) допускаются слова failed, detached и имена наборов вида set-A.

Искать недостающую информацию в файле конфигурации или /proc/mdstat: разрешает mdadm брать отсутствующие сведения (устройства-компоненты, устройства массива, идентификаторы, адрес уведомлений) оттуда.

Если серьёзных ошибок нет, завершаться с кодом 2, когда изменений массива не произошло, и 0 при хотя бы одном изменении; полезно с косвенными спецификаторами missing, detached или faulty.

=uuid задать uuid собираемого массива: устройства без этого uuid исключаются.

Более подробно сообщать о происходящем (можно указать дважды для особой подробности; влияет пока только на --detail --scan и --examine --scan).

Пометить массив как readwrite.

=number задать число запасных (eXtra) устройств в начальном массиве; запасные можно добавлять и удалять позже, а суммарное число компонентов в командной строке должно совпадать с RAID-устройствами плюс запасные.

Сообщать обо всех событиях через 'syslog': сообщения получают facility 'daemon' и различающиеся приоритеты.

=K задать объём (в килобайтах), используемый с каждого диска в RAID 1/4/5/6/10 и для RAID 0 на внешних метаданных; кратно размеру блока, оставляет около 128Kb под суперблок, значение max берёт минимальный диск.

mdadm

Построчное объяснение

mdadm (command)
Управлять программными RAID-массивами MD.

История