mdadm
Управлять программными RAID-массивами MD.
Готовые примеры · man page
--action
=act Установить "sync_action" для всех указанных md-устройств в одно из значений: idle, frozen, check или repair (idle прерывает текущее действие, frozen прерывает и не даёт запустить новому).
--add
В режиме Grow добавить одно или несколько устройств: в Linear они просто присоединяются к концу массива (удалить потом нельзя), а при увеличении --raid-disks включаются в массив.
--add-journal
=device добавить журнал в существующий массив или воссоздать журнал для RAID-4/5/6, потерявшего журнальное устройство; работает только для массива в состоянии Read-Only, чтобы не прерывать идущие записи.
--add-spare
Добавить устройство как запасное (spare): в отличие от --add сначала не пытается выполнить --re-add, поэтому устройство становится spare, даже если похоже на недавнего члена массива.
--alert
=command Задать программу, запускаемую при каждом обнаруженном событии; настраивается в mdadm.conf как PROGRAM.
--array-size
=K задать видимый размер массива (только вместе с --grow, эффект непостоянен после остановки и запуска); требуется перед уменьшением формы массива, так как reshape необратим.
--assemble
Собрать (assemble) уже существующий массив.
--assume-clean
сообщить mdadm, что массив существовал заранее и заведомо чист: позволяет избежать начальной синхронизации при создании RAID1/RAID10 или восстановлении после крупного сбоя; используйте только точно зная, что делаете.
--auto-detect
Запросить у ядра запуск всех автоматически обнаруженных массивов; работает только при встроенном в ядро md (не модуле) и v0.90-метаданных в первичных MS-DOS-разделах типа FD.
--backup-file
=path нужен, когда --grow увеличивает число RAID-устройств в RAID5/RAID6 без запасных, либо уменьшает массив, меняет уровень или layout; файл должен лежать на отдельном устройстве, не на перестраиваемом массиве.
--bitmap
= задать способ хранения bitmap намерения записи (write-intent bitmap): internal — bitmap хранится вместе с метаданными на массиве и реплицируется на все устройства; clustered — массив создаётся для кластерной среды, по одной bitmap на каждый узел из --nodes, хранение внутреннее; none — создать массив без bitmap или удалить существующую (режим grow).
--bitmap-chunk
=K задать размер блока bitmap: каждый бит соответствует такому числу килобайт хранилища; для internal bitmap по умолчанию 64Meg или больше, чтобы вместиться в отведённое пространство.
--brief
Быть менее подробным (с --detail и --examine); вместе с --verbose даёт среднюю степень подробности.
--build
Построить legacy-массив без суперблоков.
--chunk
=K задать размер чередующегося блока (chunk) в килобайтах: 512KB по умолчанию при создании, 64KB при build без постоянных метаданных; значимо для RAID0/4/5/6/10, степени двойки минимум 4KB.
--cluster-confirm
=slot:name подтвердить наличие устройства в ответ на запрос --add от другого узла кластера (передача идёт через udev с uuid устройства и номером слота).
--config
Задать файл или каталог конфигурации; по умолчанию используются стандартные пути.
--consistency-policy
= задать, как массив поддерживает согласованность при неожиданном выключении (значимо только для уровней с избыточностью): resync — полная пересинхронизация и регенерация избыточности после нечистого выключения; bitmap — ресинк с помощью bitmap намерения записи (выбирается неявно при --bitmap); journal — журнал транзакций на журнальном устройстве для RAID 4/5/6; ppl — Partial Parity Log для RAID5.
--create
Создать новый массив.
--daemonise
Разрешить mdadm работать фоновым демоном, если он решил за чем-то наблюдать: процесс порождается дочерним и отрывается от терминала, его pid пишется в стандартный вывод или в файл по -i.
--data-offset
=K явно задать смещение начала данных массива (для 1.x-метаданных между началом устройства и данными); обычно вычисляется автоматически, значение в килобайтах, если суффикс K/M/G/T не указан иначе.
--delay
=seconds Задать задержку в секундах (по умолчанию 60): mdadm опрашивает md-массивы и ждёт столько секунд перед следующим опросом, если событий не было; настраивается в mdadm.conf как MONITORDELAY.
--detail
Вывести подробности об одном или нескольких md-устройствах.
--detail-platform
=format вывести сведения о возможностях RAID платформы (прошивка/аппаратная топология) для данного формата метаданных; без аргумента сканируются все контроллеры.
--dump
=file сохранить метаданные с перечисленных устройств либо восстановить метаданные на перечисленные устройства.
--examine
Вывести содержимое метаданных на названных устройствах (в отличие от --detail, применяющегося к самому md-устройству, --examine относится к устройствам-компонентам массива).
--examine-badblocks
Перечислить испорченные блоки (bad-blocks), записанные для устройства, если для него настроен такой список; списки bad-blocks поддерживают пока только метаданные 1.x и IMSM.
--examine-bitmap
Вывести сведения о bitmap; аргументом является компонент массива (запуск на самом устройстве массива, например /dev/md0, bitmap того массива не показывает).
--export
При использовании с --detail, --detail-platform, --examine или --incremental форматировать вывод как пары key=value для простого импорта в окружение (MD_STARTED даёт yes при успешной инкрементальной сборке).
--fail
Пометить перечисленные устройства как неисправные (faulty); вместо имени файла можно указать слово detached или имя набора вида set-A, чтобы пометить сразу весь набор.
--failfast
пометить последующие устройства из команд --create или --add флагом 'failfast' (только RAID1 и RAID10): запросы IO к ним быстрее завершаются ошибкой, ошибки чтения не восстанавливаются.
--follow
Режим наблюдения (monitor).
--force
Быть настойчивее при выполнении отдельных операций (точное значение зависит от режима).
--grow
Изменить размер или конфигурацию активного массива.
--help
Вывести общую справку, а после одного из режимных параметров — справку по этому режиму.
--help-options
Вывести более подробную справку о разборе командной строки и некоторых часто используемых параметрах.
--home-cluster
=name задать имя кластера для md-устройства: собрать его можно только в кластере с совпадающим именем; если не указано, mdadm пытается определить имя автоматически.
--homehost
=name переопределить HOMEHOST из конфига и задать идентичность узла, считающегося домом для массивов; при создании записывается в метаданные, при авто-сборке принимаются только массивы этого дома.
--increment
=percent Задать процентный шаг: mdadm генерирует события RebuildNN с указанным процентным приращением.
--incremental
Добавить или удалить одно устройство из подходящего массива и, возможно, запустить этот массив (инкрементальная сборка).
--invalid-backup
Указывает, что резервный файл для --backup-file недоступен и передан пустой файл: данные, перестраивавшиеся в момент сбоя, могут быть безвозвратно потеряны, остальной массив ещё восстановим; крайняя мера.
--kill-subarray
=array Если устройство — контейнер, а аргумент указывает неактивный подряд (subarray) контейнера, удалить этот подряд; удаление всех подрядов оставляет на дисках 'empty-container' или spare-суперблок.
--layout
=layout задать детали расположения данных для массивов RAID5, RAID6 и RAID10 и режимы отказов для faulty (например left-symmetric по умолчанию для RAID5, parity-first/parity-last, ddf-совместимые варианты).
--level
=level задать уровень RAID: linear, raid0/0/stripe, raid1/1/mirror, raid4/4, raid5/5, raid6/6, raid10/10, multipath/mp, faulty, container; часть имён синонимична, с --build допустимы не все.
--logical-block-size
=K задать логический размер блоков массива (только в режиме Create и при метаданных версии 1.x); при смешанных LBS 512 и 4K массив по умолчанию использует 4K, но после удаления такого диска и перезагрузки возвращается к 512.
--mail
=address Задать адрес почты для отправки предупреждений; настраивается в mdadm.conf как MAILADDR.
--metadata
=style объявить стиль метаданных RAID (суперблока): по умолчанию 1.2 для --create, а для прочих операций — подбор автоматически; значение можно переопределить параметром metadata ключевого слова CREATE в mdadm.conf.
--monitor
--name
=name задать имя массива длиной не более 32 символов; действует при создании массива с v1-метаданными или внешнего массива; если имя нужно, но не задано, берется basename создаваемого устройства.
--no-degraded
Запретить запуск массива, пока присутствуют не все ожидаемые диски (обратное к --run); нужен только вместе с --scan и предотвращает запуск деградированного массива, который мог быть собран вне дома.
--no-sharing
Запретить перемещение запасных дисков (spares) между массивами; разрешено только одному мониторингу с --scan.
--nodes
=number задать максимальное число узлов кластера, одновременно использующих это устройство (работает только при создании массива для кластерной среды; по умолчанию 4).
--nofailfast
повторно добавляемые устройства добавляются без установленного флага 'failfast'.
--oneshot
Полное имя -1: проверить массивы только один раз.
--parity
=layout то же, что --layout (чем объясняется буква p в -p).
--path
=path Используется только с --fail: запоминает указанный путь, чтобы новое устройство на том же месте могло быть автоматически добавлено в тот же массив без метаданных; обычно устанавливается скриптом udev.
--pid-file
=file Когда mdadm работает в режиме демона, писать pid демонического процесса в указанный файл вместо вывода его в стандартный поток.
--prefer
=component предпочесть более длинное имя устройства в /dev, содержащее указанный компонент пути (например --prefer=by-uuid); работает для --detail и --monitor.
--program
--query
Обследовать устройство, чтобы выяснить (1) является ли оно md-устройством и (2) является ли компонентом md-массива, и представить найденную информацию.
--quiet
Не выводить чисто информационные сообщения: mdadm молчит, пока не появится что-то действительно важное.
--raid-devices
=number задать число активных устройств в массиве; вместе с числом запасных оно должно равняться количеству перечисленных компонентов; значение 1 требует предварительного --force и недопустимо для RAID4/5/6.
--re-add
Вновь добавить устройство, ранее удалённое из массива: если метаданные подтверждают членство, а его слот свободен, устройство возвращается на то же место (восстановление может потребоваться полностью, по bitmap или не потребоваться вовсе).
--readonly
Запустить массив только для чтения, а не на чтение-запись: запись невозможна, resync/recovery/reshape не запускаются; работает в режимах Create, Assemble, Manage и Misc.
--readwrite
Снимают флаг 'write-mostly' с последующих добавляемых или повторно добавляемых устройств.
--rebuild-map
Перестроить файл карты (/run/mdadm/map), который mdadm использует для отслеживания того, какие массивы сейчас собираются.
--remove
Удалить перечисленные устройства (они не должны быть активны — только faulty или spare); допускаются слова failed, detached и имена наборов вроде set-A.
--replace
Пометить перечисленные устройства как требующие замены: как только появится spare, оно будет перестроено и заменит помеченное устройство, которое остаётся в строю до конца восстановления, а затем помечается faulty.
--restore
--rounding
=K задать множитель округления для Linear-массива: размер каждого компонента округляется вниз до кратного ему величины; синоним --chunk, подчёркивающий иной смысл для Linear (по умолчанию 0K).
--run
Настаивать на запуске массива mdadm, даже если часть компонентов выглядит активной в другом массиве или файловая система; подавляет обычный запрос подтверждения.
--scan
Искать недостающую информацию в файле конфигурации или /proc/mdstat: разрешает mdadm брать отсутствующие сведения (устройства-компоненты, устройства массива, идентификаторы, адрес уведомлений) оттуда.
--set-faulty
то же, что --fail.
--size
=K задать объём (в килобайтах), используемый с каждого диска в RAID 1/4/5/6/10 и для RAID 0 на внешних метаданных; кратно размеру блока, оставляет около 128Kb под суперблок, значение max берёт минимальный диск.
--spare-devices
=number задать число запасных (eXtra) устройств в начальном массиве; запасные можно добавлять и удалять позже, а суммарное число компонентов в командной строке должно совпадать с RAID-устройствами плюс запасные.
--stop
Деактивировать массив, освободив все ресурсы.
--super-minor
=minor задать младший номер устройства, для которого создан массив: устройства с другим младшим номером исключаются (массив /dev/md1 имеет старший 9, младший 1).
--syslog
Сообщать обо всех событиях через 'syslog': сообщения получают facility 'daemon' и различающиеся приоритеты.
--test
Если серьёзных ошибок нет, завершаться с кодом 2, когда изменений массива не произошло, и 0 при хотя бы одном изменении; полезно с косвенными спецификаторами missing, detached или faulty.
--udev-rules
=POLICY Сгенерировать правила udev в файл, обрабатывающий горячее подключение bare-устройств, согласно ПОЛИТИКАМ, определённым в /etc/mdadm.conf (или /etc/mdadm/mdadm.conf); см. mdadm.conf(5).
--update
=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.
--update-subarray
=field Если устройство — контейнер, а аргумент указывает на подряд (subarray) в контейнере, попытаться обновить заданное поле суперблока этого подряда (подробности — в разделе MISC MODE).
--uuid
=uuid задать uuid собираемого массива: устройства без этого uuid исключаются.
--verbose
Более подробно сообщать о происходящем (можно указать дважды для особой подробности; влияет пока только на --detail --scan и --examine --scan).
--version
Вывести сведения о версии mdadm.
--wait
Для каждого указанного md-устройства дождаться завершения resync, recovery или reshape перед возвратом; успех только если реально дождался каждого перечисленного устройства.
--wait-clean
Для каждого указанного md-устройства (или каждого из /proc/mdstat при --scan) как можно скорее пометить массив чистым; для нативных массивов возвращает управление сразу, так как ядро обрабатывает переходы dirty-clean при выключении.
--with
=device указать после списка --replace устройства, которыми преимущественно заменяются помеченные; они уже должны быть запасными в этом массиве.
--write-behind
=number включить режим write-behind (только RAID1); аргумент задаёт максимальное число незавершённых записей (по умолчанию 256), требуется write-intent bitmap, попытки идут лишь на write-mostly диски.
--write-journal
=device задать устройство журнала для массива RAID-4/5/6; журнальное устройство должно быть SSD с разумным ресурсом.
--write-mostly
пометить последующие устройства из команд --build, --create или --add флагом 'write-mostly' (только RAID1): драйвер md избегает чтения с них, полезно при зеркалировании по медленному каналу.
--write-zeroes
при создании массива послать запросы записи нулей на все блочные устройства, чтобы обнулить область данных и обойтись без начальной синхронизации (ведёт себя как --assume-clean); значимо только с --create.
--zero-superblock
Если устройство содержит допустимый md-суперблок, затереть его нулями; с --force затирается место, где суперблок мог бы быть, даже если он не выглядит допустимым (осторожно с кластерным RAID).
-1
Проверить массивы только один раз (генерирует события NewArray, DegradedArray и SparesMissing).
-A
-B
-C
-D
-E
-F
-G
-I
Добавить или удалить одно устройство из подходящего массива и, возможно, запустить этот массив.
-N
-Q
-R
-S
-U
-V
-W
-X
-Y
-Z
-a
-b
-c
-d
-e
-f
-h
-i
-k
-l
-m
-n
-o
-p
-q
-r
Удалить перечисленные устройства (неактивные: faulty или spare); кроме имени файла (например /dev/sda1) допускаются слова failed, detached и имена наборов вида set-A.
-s
-t
-u
-v
-w
Пометить массив как readwrite.
-x
-y
-z