table of contents
DMRAID(8) | System Manager's Manual | DMRAID(8) |
NAME¶
dmraid - discover, configure and activate software (ATA)RAIDSYNOPSIS¶
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.
- [-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:
- {-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
- -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:
- --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:DIAGNOSTICS¶
dmraid returns an exit code of 0 for success or 1 for error.AUTHOR¶
Heinz Mauelshagen <Mauelshagen@RedHat.com>DMRAID TOOL | Heinz Mauelshagen |