DMRAID(8) DMRAID(8)
NAME
dmraid - discover and activate software (ATA)RAID
SYNOPSIS
dmraid
{-a|--activate} {y|n|yes|no}
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-f|--format FORMAT[,FORMAT...]]
[-p|--no_partitions]
[--separator SEPARATOR]
[-t|--test]
[RAID-set...]
dmraid
{-b|--block_devices}
[-c|--display_columns][FIELD[,FIELD...]]...
[-d|--debug]... [-v|--verbose]...
[--separator SEPARATOR]
[device-path...]
dmraid
{-h|--help}
dmraid
{-l|--list_formats}
[-d|--debug]... [-v|--verbose]...
dmraid
{-n|--native_log}
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-f|--format FORMAT[,FORMAT...]]
[--separator SEPARATOR]
[device-path...]
dmraid
{-r|--raid_devices}
[-c|--display_columns][FIELD[,FIELD...]]...
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-D|--dump_metadata]
[-f|--format FORMAT[,FORMAT...]]
[--separator SEPARATOR]
[device-path...]
dmraid
{-r|--raid_devices}
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-E|--erase_metadata]
[-f|--format FORMAT[,FORMAT...]]
[--separator SEPARATOR]
[device-path...]
dmraid
{-s|--sets}...[a|i|active|inactive]
[-c|--display_columns][FIELD[,FIELD...]]...
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-f|--format FORMAT[,FORMAT...]]
[-g|--display_group]
[--separator SEPARATOR]
[RAID-set...]
dmraid
{-V/--version}
DESCRIPTION
dmraid discovers block and software RAID devices (eg, ATARAID) by using multiple different
metadata format handlers which support various formats (eg, Highpoint 37x series). It
offers activating RAID sets made up by 2 or more discovered RAID devices, display proper-
ties of devices and sets (see option -l for supported metadata formats). Block device
access to activated RAID sets occurs via device-mapper nodes /dev/mapper/RaidSetName.
RaidSetName starts with the format name (see -l option) which can be used to access all
RAID sets of a specific format easily with certain options (eg, -a below).
OPTIONS
-a, --activate {y|n} [RAID set...]
Activates or deactivates all or particular software RAID set. In case metadata
format handlers are chosen with -f , only RAID sets with such format(s) can be
activated or deactivated. Useful if devices have multiple metadata signatures.
When activating RAID sets, -p disables the activation of partitions on them. RAID
set names given on command line don't need to be fully specified (eg, "dmraid -ay
sil" would activate all discovered Silicon Image Medley RAID sets).
{-b|--block_devices} [device-path...]
List all or particular discovered block devices with their properties (size, serial
number). Add -c to display block device names only and -cc for CSV column output
of block device properties. See description of -c below for FIELD identifiers.
[-d|--debug]...
Enable debugging output. Opion can be given multiple times increasing the debug
output level.
[-c|--display_columns][FIELD[,FIELD...]]...
Display properties of block devices, RAID sets and devices in column(s). Optional
list specifying which FIELDs to display.
For -b:
d[evpath]|p[ath], sec[tors]|si[ze], ser[ialnumber].
For -r:
de[vpath]|p[ath], f[ormat], r[aidname], t[ype], st[atus], se[ctors]|si[ze],
da[taoffset]|o[ffset].
For -s:
f[ormat], r[aidname], t[ype], sta[tus], str[ide], se[ctors]|si[ze], su[bsets],
d[evices], sp[ares].
[-f|--format FORMAT[,FORMAT...]]
Use metadata format handler(s) to discover RAID devices. See -l for a list of sup-
ported format handler names. This is useful to select particular formats in case
multiple metadata signatures are found on a device. A comma seperated list of for-
mat names can be specified which may not contain white space.
{-h|--help}
Display help text.
{-i|--ignorelocking}
Don't take out any locks. Useful in early boot where no read/write access to /var
is available.
{-l|--list_formats}
List all available metadata format handlers with their names and descriptions. Sup-
ported RAID levels are listed in parenthesis:
S: Span (concatination)
0: RAID0 (stripe)
1: RAID1 (mirror)
10: RAID10 (mirror on top of stripes)
01: RAID10 (stripe on top of mirrors)
{-n|--native_log} [device-path...]
Display metadata in native, vendor-specific format. In case a metadata format han-
dler is chosen with -f only RAID devices with such format will be displayed in
native format. If device-path(s) is/are given on the command line, native metadata
output is restricted to those listed.
{-r|--raid_devices} [device-path...]
List all discovered RAID devices with format, RAID level, sectors used and data
offset into the device. In case a metadata format handler is chosen with -f , only
RAID devices with such format can be discovered. Useful if devices have multiple
metadata signatures. If -D is added to -r the RAID metadata gets dumped into files
named devicename_formatname.dat. The offset in sectors where the metadata is
located on the device is written into files named devicename_formatname.offset and
the size of the device into files named devicename_formatname.size.
If -E is added to -r the RAID metadata on the devices gets conditionally erased.
Useful to erase old metadata after new one of different type has been stored on a
device in order to avoid discovering both. If you enter -E option -D will be
enforced in order to have a fallback in case the wrong metadata got erased. Manual
copying back onto the device is needed to recover from erasing the wrong metadata
using the dumped files devicename_formatname.dat and devicename_formatname.offset.
Eg, to restore all *.dat files in the working directory to the respective devices:
for f in *.dat
do
dd if=$f of=/dev/${f%%_*} \
seek='cat ${f%%dat}offset' bs=1
done
If device-path(s) is/are given on the command line, the above actions are
restricted to those listed. Add -c to display RAID device names only and -cc for
CSV column output of RAID device properties. See description of -c above for FIELD
identifiers.
--separator SEPARATOR
Use SEPARATOR as a delimiter for all options taking or displaying lists.
-s... [a|i] [RAID-set...]
Display properties of RAID sets. Multiple RAID set names can be given on the com-
mand line which don't need to be fully specified (eg, "dmraid -s hpt" would display
all discovered Highpoint RAID sets). Enter -s twice to display RAID subsets too.
Add -c to display names of RAID sets only, -cc for CSV column output of RAID set
properties and -ccc for inclusion of block devices in the listing. Doesn't imply -s
-s to show RAID subsets (implied for group sets, e.g. isw). Add -g to include
information about group RAID sets (as with Intel Software RAID) in the listing.
See description of -c above for FIELD identifiers.
[-v|--verbose]...
Enable verbose runtime information output. Opion can be given multiple times
increasing the verbosity level.
EXAMPLES
"dmraid -l" lists all supported metadata formats with their names along with some descrip-
tive information, eg:
hpt37x : (+) Highpoint HPT37X
hpt45x : (+) Highpoint HPT45X
isw : (+) Intel Software RAID
lsi : (0) LSI Logic MegaRAID
nvidia : (+) NVidia RAID
pdc : (+) Promise FastTrack
sil : (+) Silicon Image(tm) Medley(tm)
via : (+) VIA Software RAID
dos : (+) DOS partitions on SW RAIDs
(0): Discover, (+): Discover+Activate
"dmraid -ay" activates all software RAID sets discovered.
"dmraid -an" deactivates all active software RAID sets which are not open (eg, mounted
filesystem on them).
"dmraid -ay -f pdc" (pdc looked up from "dmraid -l") activates all software RAID sets with
Promise format discovered and ignores all other supported formats.
"dmraid -r" discovers all software RAID devices supported on your system, eg:
/dev/dm-46: hpt45x, "hpt45x_chidjhaiaa-0", striped, ok, 320172928 sectors, data@ 0
/dev/dm-50: hpt45x, "hpt45x_chidjhaiaa-0", striped, ok, 320172928 sectors, data@ 0
/dev/dm-54: hpt45x, "hpt45x_chidjhaiaa-1", striped, ok, 320172928 sectors, data@ 0
/dev/dm-58: hpt45x, "hpt45x_chidjhaiaa-1", striped, ok, 320172928 sectors, data@ 0
"dmraid -s -s hpt45x_chidjhaiaa" displays properties of set "hpt45x_chidjhaiaa", eg:
*** Superset
name : hpt45x_chidjhaiaa
size : 640345856
stride : 128
type : raid10
status : ok
subsets: 2
dev : 4
spare : 0
---> Subset
name : hpt45x_chidjhaiaa-0
size : 640345856
stride : 128
type : stripe
status : ok
subsets: 0
dev : 2
spare : 0
---> Subset
name : hpt45x_chidjhaiaa-1
size : 640345856
stride : 128
type : stripe
status : ok
subsets: 0
dev : 2
spare : 0
"dmraid -s -ccs hpt45" displays properties in column format of all sets and subsets with
hpt45* format, eg:
hpt45x_chidjhaiaa,640345856,128,raid10,ok,4,0
hpt45x_chidjhaiaa-a,640345856,128,stripe,ok,2,0
hpt45x_chidjhaiaa-b,640345856,128,stripe,ok,2,0
"dmraid -r --sep : -cpath:size" display paths and sizes in sectors for RAID devices in
column format using ':' as a delimiter, eg:
/dev/dm-8:320173055
/dev/dm-12:320173055
/dev/dm-22:320173055
/dev/dm-26:320173055
/dev/dm-30:586114703
/dev/dm-34:586114703
/dev/dm-38:586114703
/dev/dm-42:586114703
/dev/dm-46:156301487
/dev/dm-50:156301487
/dev/dm-54:390624896
/dev/dm-58:390624896
/dev/dm-62:390624896
/dev/dm-66:390624896
DIAGNOSTICS
dmraid returns an exit code of 0 for success or 1 for error.
AUTHOR
Heinz Mauelshagen <>
Heinz Mauelshagen DMRAID TOOL DMRAID(8)
|