dmraid
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]
[-p|--no_partitions]
[-t|--test]
[RAID-set...]
dmraid
{-b|--block_devices}
[-c|--display_columns]...
[-d|--debug]... [-v|--verbose]...
dmraid
{-h|--help}
dmraid
{-l|--list_formats}
[-d|--debug]... [-v|--verbose]...
dmraid
{-n|--native_log}
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-f|--format FORMAT]
[device-path...]
dmraid
{-r|--raid_devices}
[-c|--display_columns]...
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-D|--dump_metadata]
[-f|--format FORMAT]
[device-path...]
dmraid
{-r|--raid_devices}
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-E|--erase_metadata]
[-f|--format FORMAT]
[device-path...]
dmraid
{-s|--sets}...[a|i|active|inactive]
[-c|--display_columns]...
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-f|--format FORMAT]
[-g|--display_group]
[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 for-
mats (eg, Highpoint 37x series). It offers activating RAID sets made
up by 2 or more discovered RAID devices, display properties of devices
and sets (see option -l for supported metadata formats). Block device
access to activated RAID sets occurs via device-mapper nodes /dev/map-
per/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 a 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}
List all 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.
[-d|--debug]...
Enable debugging output. Opion can be given multiple times
increasing the debug output level.
[-c|--display_columns]
Display properties of block devices, RAID sets and devices in
column(s).
[-f|--format FORMAT[,FORMAT...]]
Use metadata format handler(s) to discover RAID devices. See -l
for a list of supported 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 format 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. Supported 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 handler 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, sec-
tors 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 meta-
data 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 writ-
ten 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 con-
ditionally 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 device-
name_formatname.dat and devicename_formatname.offset. Eg, to
restore all *.dat files in the working directory to the respec-
tive 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.
-s... [a|i] [RAID-set...]
Display properties of RAID sets. Multiple RAID set names can be
given on the command 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.
[-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 descriptive 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 sys-
tem, eg:
/dev/dm-46: hpt45x, "hpt45x_chidjhaiaa-0", striped, ok, 320172928 sec-
tors, data@ 0
/dev/dm-50: hpt45x, "hpt45x_chidjhaiaa-0", striped, ok, 320172928 sec-
tors, data@ 0
/dev/dm-54: hpt45x, "hpt45x_chidjhaiaa-1", striped, ok, 320172928 sec-
tors, data@ 0
/dev/dm-58: hpt45x, "hpt45x_chidjhaiaa-1", striped, ok, 320172928 sec-
tors, 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 : operational
subsets: 2
dev : 4
spare : 0
---> Subset
name : hpt45x_chidjhaiaa-0
size : 640345856
stride : 128
type : stripe
status : operational
subsets: 0
dev : 2
spare : 0
---> Subset
name : hpt45x_chidjhaiaa-1
size : 640345856
stride : 128
type : stripe
status : operational
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,operational,4,0
hpt45x_chidjhaiaa-a,640345856,128,stripe,operational,2,0
hpt45x_chidjhaiaa-b,640345856,128,stripe,operational,2,0
DIAGNOSTICS
dmraid returns an exit code of 0 for success or 1 for error.
AUTHOR
Heinz Mauelshagen <Mauelshagen@RedHat.com>
Heinz Mauelshagen DMRAID TOOL DMRAID(8)
Man(1) output converted with
man2html