主要功能

（对于存储管理系统）

使用空闲的设备创建一个新的阵列，每个设备具有元数据块

创建RAID时使用的命令

将原来属于一个阵列的每个块设备组装为阵列

在存储管理系统一般不使用该模式

创建或组装不需要元数据的阵列，每个设备没有元数据块

在存储管理系统一般不使用该模式

管理已经存储阵列中的设备，比如增加热备磁盘或者设置某个磁盘失效，然后从阵列中删除这个磁盘

用于增加热备盘

移除失效盘

报告或者修改阵列中相关设备的信息，比如查询阵列或者设备的状态信息

用于查询RAID信息

改变阵列中每个设备被使用的容量或阵列中的设备的数目，改变阵列属性（不能改变阵列的级别）

在存储管理系统一般不使用该模式

监控一个或多个阵列，上报指定的事件，可以实现全局热备

监控RAID，写入日志

子选项

备注

–verbose

显示更详细的信息

用于 –detail –scan 或者 –examine –scan

–force

某些选项强制执行

–config=

指定配置文件，默认是”/etc/mdadm.conf”或者是”/etc/mdadm/mdadm.conf”，假如配置文件名是 “partitions”，则mdadm会读取/proc/partitions的设备用于scan。

假如配置文件名是”none”，则mdadm会认为配置文件是空的。

–scan

从配置文件或者/proc/mdstat中扫描信息。

–metadata=

定义组件设备上超级块的类型。对于–create，默认是0.90。

0,0.90 ： 限制一个RAID中的设备数为28个，限制组件设备大小为2TB

1,1.0,1.1,1.2 ：不同的子版本号标识在不同的地方存储超级块。1.0在设备的结尾，1.1在设备的开头，1.2在设备的4K处。

–homehost=

在创建一个RAID时，homehost名会记录在超级块中。在1.X超级块中，它是RAID名字的前缀。0.90超级块中，homehost名的的SHA1值会保存在UUID的后半部分。

当使用Auto-Assemble时，只有相同homehost名的RAID才会被组建。

–build

–grow

–raid-devices=

指定一个RAID中active devices的数目。

–spare-devices=

指定创建一个RAID时spare devices中的数目。

–size=

在RAID1/4/5/6中每个设备所能利用的数据容量。这个值必须是 chunk size的整数倍。而且必须留128K的设备空间用于RAID超级块。假如没有指定，则默认使用最小设备空间。

该选项能用–grow 进行扩容。

–chunk=

条带大小

–rounding=

在linear array中的rounding factor，等于条带大小

–level

设置RAID级别，RAID级别有（有些是同义词，比如raid5和5）：

Linear,raid0,0,stripe,raid1,1,mirror,raid4,4,raid5,5,raid6,6,raid10,10,multipath,mp,faulty。

–build只支持linear,stripe,raid0,0,raid1,multipath,mp,faulty。

–grow不支持改变RAID级别。

–layout=

(–parity=)

设置RAID5、RAID10数据布局类型，控制faulty级别的failure的模式。

--bitmap=

这个选项对性能可能有影响，具体查看《mdadm手册翻译》

设置一个文件用于保存write-intent位图。

当文件名是”internal”时，位图复制保存在RAID组件设备（一个RAID的所有组件设备）的超级块中。当–grow，文件名是”none”时，位图会被移除。

–bitmap-chunk=

这个选项对性能可能有影响，具体查看《mdadm手册翻译》

设置位图中每位所映射块的大小。

当使用”internal”位图时，映射块的大小是自动设置的（根据超级块中可用空间）。

–write-mostly

–build、–create、–add后的设备都被标记上”wirte-mostly”。这个选项只对RAID1有效，即”md”driver会避免从RAID1的所有设备读取数据。假如镜像的速度很慢，这是非常有用的。

–write-behind=

该选项只对RAID1有效。这个选项会设置最大的写队列深度，默认值是256。使用write-behind的前提是先设置write-intent bitmap，先设置设备为write-mostly。

–assume-clean

告诉mdadm这个array已经clean。当array从一个严重的故障中恢复时，这个选项会保证没有数据会被覆盖。当创建RAID1和RAID10时，这个选项也能避免初始化同步。但是使用该选项必须要很谨慎。

–backup-file=

当使–grow为RAID5增加组件设备数时，该文件保存关键数据。（该文件不能在该RAID5上，以免发生死锁。）

–name

给一个RAID设置名字，只在1.X超级块中有用，它是简单的字符串，用于assembling时识别RAID组件设备。

–run

强制激活RAID。（当一个RAID中的某些组件设备被其他RAID或者文件系统占用时）。使用这个选项，设备上有旧的元数据信息的提示会被忽略。

–force

mdadm无条件接受指定的参数。

使用该选项可以只使用一个设备创建RAID；

创建RAID5时使用该选项，使得RAID5初始化不使用recovery模式，而是校验同步所有组件设备上的数据（比recovery模式要慢）。详情请见命令举例中的创建RAID

–auto=

创建md设备文件。选项是{no,yes,md,mdp,part,p}{NN}。默认是yes。

“yes”要求RAID设备名是标准格式的，然后设备文件类型和minor号会自动确定。

比如RAID设备名是”/dev/mdx” 查看/proc/partitions可以看到mdx的major号是9，minor号是x。

当使用”md”时，RAID设备名可以是非标准格式，比如”/dev/md/zhu”，然后创建两个设备文件/dev/md/zhu 还有 /dev/mdx，并给这两个设备文件分配相同的major号和minor号（也就是这两个设备文件指向同一个设备）。分配minor号的方法是：分配一个没有使用过的minor号，这个minor号就是/dev/mdx中的数字x。查看/proc/partitions和/proc/mdstat，RAID设备名还是/dev/mdx。

当使用”mdp,p,part”时，RAID设备名可以是非标准格式，比如”/dev/md/zhu”，除了创建设备文件/dev/md/zhu 还有 /dev/mdx外，还会创建 /dev/md/zhup1, /dev/md/zhup2, /dev/md/zhup3, /dev/md/zhup4，这些是分区设备文件。

–symlink=no

默认下–auto会创建/dev/md/zhu的软连接 /dev/md_zhu。假如使用该选项，则不会创建软连接。

–uuid=

重组RAID，要求组件设备的uuid相同

–super-minor=

minor号会保存在每个组件设备中的超级块中，可以根据这个重组RAID。

–name=

根据RAID名重组RAID。

–force

即使一些超级块上的信息过时了，也可以强制重组。

–run

即使RAID中的组件设备不完整（例如原来创建4块盘的RAID5，现在只发现3块成员盘），RAID也被重组，并启动。

（假如不用–run，RAID只被重组，但是不启动）

–no-degraded

和–scan选项一起使用。

禁止RAID中的组件设备不完整时启动RAID，知道RAID中的组件完整。

–auto

如–create中的 –auto

–bitmap

指定bitmap文件（当RAID创建时所指定的bitmap文件），假如RAID使用internal类型的bitmap，则不需指定。

–backup-file=

当增加RAID5的组件设备数，指定backup-file文件。在RAID5重构过程中，假如系统当机，backup-file文件会保存关键数据，使得重启系统之后，重构可以继续进行。假如没有指定backup-file，mdadm会使用热备盘上的空间作为备份空间。

–update=

更新RAID中每个组件设备的超级块信息。选项有sparc2.2、summaries、uuid、name、homehost、resync、byteorder、super-minor

–auto-update-homehost

只对auto assembly情况下有用。

–add

给RAID在线添加设备(可用于添加热备盘)

–re-add

给RAID重新添加一个以前被移除的设备。

假如一个RAID使用write-intent bitmap时，它的一个设备被移除后又被重新添加，bitmap可以避免完全重建，而是只更新那些设备被移除后已经被更新过的块数据。

–reomve

移除设备，只能移除failed(失效)和spare(热备)设备。(因此假如要移除RAID5中的一个活动设备，需要先使用–fail选项使该设备的状态变成failed，然后才能移除。)

该选项后面跟的是设备名(比如是 /dev/sdc)，也可以是failed和detached关键字。Failed使得所以失效的部件被移除，detached使得所以被拔出的硬盘被移除。

–fail

使RAID中某个设备变成failed状态。

该选项后面跟的是设备名(比如是 /dev/sdc)，也可以是detached关键字。

–query

查询一个RAID或者一个RAID组件设备的信息

–detail

查询一个RAID的详细信息

–examine

查询组件设备上的超级块信息

–sparc2.2

用于修正超级块信息，详情请见用户手册。

–examnie-bitmap

查看bitmap文件中的信息

–run

启动不完整的RAID(比如本来是有4块盘的RAID5,现在3块盘也可以启动)。

–stop

–readonly

使RAID只能只读

–readwrite

使RAID能读写

–zero-superblock

假如一个组件设备包含有效的超级块信息，那么这个超级块会被写0覆盖。假如使–force选项，则不管超级块中是否有信息，都会被写0覆盖。

–test

假如–detail一起使用，则mdadm的返回值是RAID的状态值。

0 代表正常

1 代表降级，即至少有一块成员盘失效

2 代表有多快成员盘失效，整个RAID也失效了(对于RAID1/5/6/10都适用)。

4 读取raid信息失败

(–follow)

–mail

设置警报邮件

–program

当监测到一个事件发生时，关于该事件的信息会作为参数被发给该程序

–syslog

所有事件都会通过syslog报告

–delay

Mdadm会隔多少秒轮询各个RAID，默认是60秒

–daemonise

Mdadm会创建一个子进行作为后台监控程序。该子进程的PID号会输入到stdout上。

–pid-file

当–daemonise一起使用时，子进程的PID号会写入该文件中

–oneshot

只会检测RAID一次。它会检测NewArray、DegradedArray、SparesMissing事件。

在cron脚本中运行”mdadm –monitor –scan –oneshot”会定期报告。

–test

对每个RAID产生TestMessage，用于测试mail、program是否正确。

128bit的值，用16进制表示。

当创建RAID时使用–name指定的名字(跟RAID设备名概念不一样)。不是所有的超级块版本都支持–name。

当一个RAID，该RAID的设备名是/dev/mdX，minor号码就是X。

该属性值后面跟着设备名或者设备名模式(它们用逗号隔开)。注意：这些设备名必须包含在DEVICE中。

RAID的级别

一个完整的RAID中活动设备数。

RAID中所设定的热备盘数目。

RAID组名，所有具有相同spare-group名的RAID会共享热备盘（前提是使用mdadm –monitor监控RAID）。mdadm会自动把一个RAID中的热备盘移动到另一个RAID（这个RAID有faild盘或者missing盘，而且没有热备盘）中。

指定write-intent bitmap文件。功能跟”–assemble –bitmap-file”一样。

指定超级块版本。

owner=

代替系统默认的USER ID（root）

group=

代替系统默认的GROUP ID（disk）

mode=

权限

auto=

metadata=

超级块的版本

symlinks=no

不用软连接

# /dev/md0 is known by it’s UID.
ARRAY /dev/md0 UUID=3aaa0122:29827cfa:5331ad66:ca767371
# /dev/md1 contains all devices with a minor number of
# 1 in the superblock.
ARRAY /dev/md1 superminor=1
# /dev/md2 is made from precisey these two devices
ARRAY /dev/md2 devices=/dev/hda1,/dev/hdb1

# /dev/md4 and /dev/md5 are a spare-group and spares
# can be moved between them
ARRAY /dev/md4 uuid=b23f3c6d:aec43a9f:fd65db85:369432df
spare-group=group1
ARRAY /dev/md5 uuid=19464854:03f71b1b:e0df2edd:246cc977
spare-group=group1
# /dev/md/home is created if need to be a partitionable md array
# any spare device number is allocated.
ARRAY /dev/md/home UUID=9187a482:5dde19d9:eea3cc4a:d646ab8b
auto=part

MAILADDR root@mydomain.tld
PROGRAM /usr/sbin/handle-mdadm-events
CREATE group=system mode=0640 auto=part-8
HOMEHOST <system>