dmraid(8)
NAME
dmraid - discover, configure and activate software (ATA)RAID
SYNOPSIS
dmraid
{-a|--activate} {y|n|yes|no}
[-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
[-f|--format FORMAT[,FORMAT...]]
[{-P|--partchar} CHAR]
[-p|--no_partitions]
[-Z|--rm_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| --rebuild}
RAID-set
[device-path]
dmraid
{-x| --remove}
[RAID-set]
dmraid
-f FORMAT-handler {-C| --create} set
--type raidlevel
[--size=setsize --strip stridesize]
--disk "device-path, device-path [, device-path ...]"
dmraid [ -f|--format FORMAT-handler] -S|--spare [RAID-set] -M|--media
"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 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/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, and -Z will make dmraid tell the kernel to remove the
partitions from the disks underlying the set, ie if sda is part
of the set, remove sda1, sda2, etc. This prevents applications
from directly accessiong the disks bypassing dmraid. 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 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) Note: Intel OROM displays
this as RAID10
{-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.
[{-P|--partchar} CHAR]
Use CHAR as the separator between the device name and the
partition number.
{-R| --rebuild} RAID-set [device-path]
Rebuild raid array after a drive has failed and a new drive is
added. For Intel chipset based systems, there are two methods
in which a new drive is added to the system.
1. Using OROM to identify a new drive
During system reboot, enter OROM and mark the new drive as
the rebuild drive.
After booting to the OS, use the dmraid command to rebuild.
Example: dmraid -R raid_set
2. Using dmraid to identify a new drive
Boot to the OS and use the dmraid command with the new drive
as the second parameter.
Example: dmraid -R raid_set /dev/sdc
3. Using hot spare drive
Mark a drive as hot spare using the "dmraid -f isw -S"
command. Then use the dmraid command to start the rebuild.
Example: dmraid -R raid_set
{-x|--remove} [RAID-set]
Delete one or all existing software RAID devices from the
metadata.
-f FORMAT-handler {-C|--create} --type raidlevel [--size=setsize
--strip stripsize] --disk device-path, device-path [,device-path]
Delete one or all existing Configure a software RAID device and
store the configuration data in a group of hard drive devices
consisting of this array. This command requires the following
options:
-f FORMAT-handler
metadata format (see "dmraid -l")
--type digit[digit...]
specify the raid level of the software RAID set.
0: raid0
1: raid1
5: raid5
01: raid01 (isw raid10)
--size: [digits[k|K|m|M|g|G][b|B]]
specify the size of the RAID set.The number is an integer
followed by [kKmMgG] and/or [bB].
b: byte (default)
B: block (512 bytes)
K or K: on the base of 1024
m or M: on the base of 1024*1024
g or G: on the base of 1024*1024*1024
If this option is missing, it's set to the default value pre-
configured by the vendor. Note that different vendors may apply
different constraints on the granularity of the size or the
minimal value.
--strip: [digits[k|K|m|M|g|G][b|B]]
specify the strip size of a RAID1, RAID5, and RAID10 RAID
set (as above)
--disk: device-path[{,| }device-path...]
specify the array of the hard drives, e.g. /dev/sda.
-f FORMAT-handler -S -M device-path
-S -M device-path
This command adds hot spare support for one or more RAID sets.
1. When used with a format handler, which supports hot spare
sets (e.g. isw), a hot spare is marked to be used when
rebuilding any RAID set of that format. 2. When used when
specifying a RAID set, the drive is added to that RAID set and
will be used only to rebuild that set. Note: If the specified
name does not match an existing RAID-set, a set with the new
name will be created.
{-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 a subdirectory named
dmraid.format_name (eg. format_name = isw) in files named
devicename.dat. The byte offset where the metadata is located
on the device is written into files named devicename.offset and
the size of the device in sectors into files named
devicename.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%%.dat} \
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 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.
See description of -c above for FIELD identifiers. Note: Size
is given in sectors (not bytes).
[-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 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 "dmraid -f isw -C Raid0 --type 0 --strip 8k --size 20g --disk "/dev/sdb /dev/sdc"" creates an ISW volume with a name of "Raid0", 20Gig bytes in total, and 8kilo bytes strip size on two disks. "dmraid -f isw -C Test0 --type 0 --disk "/dev/sdd /dev/sde"" creates an ISW volume with the default size and strip size. "dmraid -f isw -C Test10 --type 01 --strip 128B --disk "/dev/sda /dev/sdb /dev/sdc /dev/sdd" creates a stacked RAID device, RAID10 (isw format), with a name of "Test10", 128 blocks (512bytes) strip size , and the default volume size on 4 disks. "dmraid -f isw -S -M /dev/sde" marks the device /dev/sde as a hot spare for rebuild "dmraid -R isw_djaggchdde_RAID1 /dev/sde" starts rebuild of the RAID volume on device /dev/sde
DIAGNOSTICS
dmraid returns an exit code of 0 for success or 1 for error.
AUTHOR
Heinz Mauelshagen <Mauelshagen@RedHat.com>
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
