1DMRAID(8) System Manager's Manual DMRAID(8)
2
6 dmraid - discover and activate software (ATA)RAID
7
9 dmraid
10 {-a|--activate} {y|n|yes|no}
11 [-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
12 [-f|--format FORMAT[,FORMAT...]]
13 [-p|--no_partitions]
14 [--separator SEPARATOR]
15 [-t|--test]
16 [RAID-set...]
17 dmraid
19 {-b|--block_devices}
20 [-c|--display_columns][FIELD[,FIELD...]]...
21 [-d|--debug]... [-v|--verbose]...
22 [--separator SEPARATOR]
23 [device-path...]
24 dmraid
26 {-h|--help}
27 dmraid
29 {-l|--list_formats}
30 [-d|--debug]... [-v|--verbose]...
31 dmraid
33 {-n|--native_log}
34 [-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
35 [-f|--format FORMAT[,FORMAT...]]
36 [--separator SEPARATOR]
37 [device-path...]
38 dmraid
40 {-r|--raid_devices}
41 [-c|--display_columns][FIELD[,FIELD...]]...
42 [-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
43 [-D|--dump_metadata]
44 [-f|--format FORMAT[,FORMAT...]]
45 [--separator SEPARATOR]
46 [device-path...]
47 dmraid
49 {-r|--raid_devices}
50 [-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
51 [-E|--erase_metadata]
52 [-f|--format FORMAT[,FORMAT...]]
53 [--separator SEPARATOR]
54 [device-path...]
55 dmraid
57 {-s|--sets}...[a|i|active|inactive]
58 [-c|--display_columns][FIELD[,FIELD...]]...
59 [-d|--debug]... [-v|--verbose]... [-i|--ignorelocking]
60 [-f|--format FORMAT[,FORMAT...]]
61 [-g|--display_group]
62 [--separator SEPARATOR]
63 [RAID-set...]
64 dmraid
66 {-V/--version}
67
70 dmraid discovers block and software RAID devices (eg, ATARAID) by using
71 multiple different metadata format handlers which support various for‐
72 mats (eg, Highpoint 37x series). It offers activating RAID sets made
73 up by 2 or more discovered RAID devices, display properties of devices
74 and sets (see option -l for supported metadata formats). Block device
75 access to activated RAID sets occurs via device-mapper nodes /dev/map‐
76 per/RaidSetName. RaidSetName starts with the format name (see -l
77 option) which can be used to access all RAID sets of a specific format
78 easily with certain options (eg, -a below).
79 OPTIONS
82 -a, --activate {y|n} [RAID set...]
83 Activates or deactivates all or particular software RAID set.
84 In case metadata format handlers are chosen with -f , only RAID
85 sets with such format(s) can be activated or deactivated. Use‐
86 ful if devices have multiple metadata signatures. When activat‐
87 ing RAID sets, -p disables the activation of partitions on them.
88 RAID set names given on command line don't need to be fully
89 specified (eg, "dmraid -ay sil" would activate all discovered
90 Silicon Image Medley RAID sets).
91 {-b|--block_devices} [device-path...]
94 List all or particular discovered block devices with their prop‐
95 erties (size, serial number). Add -c to display block device
96 names only and -cc for CSV column output of block device proper‐
97 ties. See description of -c below for FIELD identifiers.
98 [-d|--debug]...
101 Enable debugging output. Opion can be given multiple times
102 increasing the debug output level.
103 [-c|--display_columns][FIELD[,FIELD...]]...
106 Display properties of block devices, RAID sets and devices in
107 column(s). Optional list specifying which FIELDs to display.
108 For -b:
109 d[evpath]|p[ath], sec[tors]|si[ze], ser[ialnumber].
110 For -r:
111 de[vpath]|p[ath], f[ormat], r[aidname], t[ype], st[atus],
112 se[ctors]|si[ze], da[taoffset]|o[ffset].
113 For -s:
114 f[ormat], r[aidname], t[ype], sta[tus], str[ide],
115 se[ctors]|si[ze], su[bsets], d[evices], sp[ares].
116 [-f|--format FORMAT[,FORMAT...]]
118 Use metadata format handler(s) to discover RAID devices. See -l
119 for a list of supported format handler names. This is useful to
120 select particular formats in case multiple metadata signatures
121 are found on a device. A comma seperated list of format names
122 can be specified which may not contain white space.
123 {-h|--help}
126 Display help text.
127 {-i|--ignorelocking}
130 Don't take out any locks. Useful in early boot where no
131 read/write access to /var is available.
132 {-l|--list_formats}
135 List all available metadata format handlers with their names and
136 descriptions. Supported RAID levels are listed in parenthesis:
137 S: Span (concatination)
139 0: RAID0 (stripe)
140 1: RAID1 (mirror)
141 10: RAID10 (mirror on top of stripes)
142 01: RAID10 (stripe on top of mirrors)
143 {-n|--native_log} [device-path...]
146 Display metadata in native, vendor-specific format. In case a
147 metadata format handler is chosen with -f only RAID devices with
148 such format will be displayed in native format. If device-
149 path(s) is/are given on the command line, native metadata output
150 is restricted to those listed.
151 {-r|--raid_devices} [device-path...]
154 List all discovered RAID devices with format, RAID level, sec‐
155 tors used and data offset into the device. In case a metadata
156 format handler is chosen with -f , only RAID devices with such
157 format can be discovered. Useful if devices have multiple meta‐
158 data signatures. If -D is added to -r the RAID metadata gets
159 dumped into files named devicename_formatname.dat. The offset
160 in sectors where the metadata is located on the device is writ‐
161 ten into files named devicename_formatname.offset and the size
162 of the device into files named devicename_formatname.size.
163 If -E is added to -r the RAID metadata on the devices gets con‐
165 ditionally erased. Useful to erase old metadata after new one
166 of different type has been stored on a device in order to avoid
167 discovering both. If you enter -E option -D will be enforced in
168 order to have a fallback in case the wrong metadata got erased.
169 Manual copying back onto the device is needed to recover from
170 erasing the wrong metadata using the dumped files device‐
171 name_formatname.dat and devicename_formatname.offset. Eg, to
172 restore all *.dat files in the working directory to the respec‐
173 tive devices:
174 for f in *.dat
176 do
177 dd if=$f of=/dev/${f%%_*} \
178 seek=`cat ${f%%dat}offset` bs=1
179 done
180 If device-path(s) is/are given on the command line, the above
182 actions are restricted to those listed. Add -c to display RAID
183 device names only and -cc for CSV column output of RAID device
184 properties. See description of -c above for FIELD identifiers.
185 --separator SEPARATOR
188 Use SEPARATOR as a delimiter for all options taking or display‐
189 ing lists.
190 -s... [a|i] [RAID-set...]
193 Display properties of RAID sets. Multiple RAID set names can be
194 given on the command line which don't need to be fully specified
195 (eg, "dmraid -s hpt" would display all discovered Highpoint RAID
196 sets). Enter -s twice to display RAID subsets too. Add -c to
197 display names of RAID sets only, -cc for CSV column output of
198 RAID set properties and -ccc for inclusion of block devices in
199 the listing. Doesn't imply -s -s to show RAID subsets (implied
200 for group sets, e.g. isw). Add -g to include information about
201 group RAID sets (as with Intel Software RAID) in the listing.
202 See description of -c above for FIELD identifiers.
203 [-v|--verbose]...
206 Enable verbose runtime information output. Opion can be given
207 multiple times increasing the verbosity level.
208
211 "dmraid -l" lists all supported metadata formats with their names along
212 with some descriptive information, eg:
213 hpt37x : (+) Highpoint HPT37X
214 hpt45x : (+) Highpoint HPT45X
215 isw : (+) Intel Software RAID
216 lsi : (0) LSI Logic MegaRAID
217 nvidia : (+) NVidia RAID
218 pdc : (+) Promise FastTrack
219 sil : (+) Silicon Image(tm) Medley(tm)
220 via : (+) VIA Software RAID
221 dos : (+) DOS partitions on SW RAIDs
222 (0): Discover, (+): Discover+Activate
223 "dmraid -ay" activates all software RAID sets discovered.
225 "dmraid -an" deactivates all active software RAID sets which are not
227 open (eg, mounted filesystem on them).
228 "dmraid -ay -f pdc" (pdc looked up from "dmraid -l") activates all
230 software RAID sets with Promise format discovered and ignores all other
231 supported formats.
232 "dmraid -r" discovers all software RAID devices supported on your sys‐
234 tem, eg:
235 /dev/dm-46: hpt45x, "hpt45x_chidjhaiaa-0", striped, ok, 320172928 sec‐
236 tors, data@ 0
237 /dev/dm-50: hpt45x, "hpt45x_chidjhaiaa-0", striped, ok, 320172928 sec‐
238 tors, data@ 0
239 /dev/dm-54: hpt45x, "hpt45x_chidjhaiaa-1", striped, ok, 320172928 sec‐
240 tors, data@ 0
241 /dev/dm-58: hpt45x, "hpt45x_chidjhaiaa-1", striped, ok, 320172928 sec‐
242 tors, data@ 0
243 "dmraid -s -s hpt45x_chidjhaiaa" displays properties of set
246 "hpt45x_chidjhaiaa", eg:
247 *** Superset
248 name : hpt45x_chidjhaiaa
249 size : 640345856
250 stride : 128
251 type : raid10
252 status : ok
253 subsets: 2
254 dev : 4
255 spare : 0
256 ---> Subset
257 name : hpt45x_chidjhaiaa-0
258 size : 640345856
259 stride : 128
260 type : stripe
261 status : ok
262 subsets: 0
263 dev : 2
264 spare : 0
265 ---> Subset
266 name : hpt45x_chidjhaiaa-1
267 size : 640345856
268 stride : 128
269 type : stripe
270 status : ok
271 subsets: 0
272 dev : 2
273 spare : 0
274 "dmraid -s -ccs hpt45" displays properties in column format of all sets
276 and subsets with hpt45* format, eg:
277 hpt45x_chidjhaiaa,640345856,128,raid10,ok,4,0
278 hpt45x_chidjhaiaa-a,640345856,128,stripe,ok,2,0
279 hpt45x_chidjhaiaa-b,640345856,128,stripe,ok,2,0
280 "dmraid -r --sep : -cpath:size" display paths and sizes in sectors for
282 RAID devices in column format using ':' as a delimiter, eg:
283 /dev/dm-8:320173055
284 /dev/dm-12:320173055
285 /dev/dm-22:320173055
286 /dev/dm-26:320173055
287 /dev/dm-30:586114703
288 /dev/dm-34:586114703
289 /dev/dm-38:586114703
290 /dev/dm-42:586114703
291 /dev/dm-46:156301487
292 /dev/dm-50:156301487
293 /dev/dm-54:390624896
294 /dev/dm-58:390624896
295 /dev/dm-62:390624896
296 /dev/dm-66:390624896
297
300 dmraid returns an exit code of 0 for success or 1 for error.
301
304 Heinz Mauelshagen <Mauelshagen@RedHat.com>
305Heinz Mauelshagen DMRAID TOOL DMRAID(8)