raidreconf.8

create raid tool at linux

.\" -*- nroff -*-
.TH raidreconf 8
.SH NAME
raidreconf \- reconfigure RAID arrays
.SH SYNOPSIS
\fBraidreconf\fR -h {--help}

- or -

\fBraidreconf\fR -V {--version}

- or -

\fBraidreconf\fR -o oldraidtab -n newraidtab -m /dev/md?

- or -

\fBraidreconf\fR -i /dev/sd?? -n newraidtab -m /dev/md?

- or -

\fBraidreconf\fR -n newraidtab -m /dev/md? -e /dev/sd??

.SH WARNING
\fBYou should back up all data BEFORE any attempt is made to reconfigure
a RAID device.  YOU HAVE BEEN WARNED.\fR

The author will give you no guarantee whatsoever, that this program
works in any specific way at all. It may well destroy all data on any
device connected directly, indirectly, or not at all, to any system
this software is used on.  Please use this stuff with care, if you
decide to use it at all.

Ok, that said, let's see how to actually use it  :-)

.SH DESCRIPTION
\fBraidreconf\fR will read two raidtab files, an old one, and a
new one.  It will then re-build your old array to match the
configuration for the new array, while retaining all data possible.

It can also be used to import a single block-device into a RAID array
(using more block devices), or export a RAID array to a single block-device.

\fBraidreconf\fR can, of course, only retain your original data if you
\fIgrow\fR the configuration.  If you \fIshrink\fR the configuration
from say, \fBP\fR bytes to \fBQ\fR bytes, \fBraidreconf\fR will retain
the first \fBQ\fR bytes of your original data, but everything from
\fBQ\fR bytes to the end of the old array (to \fBP\fR bytes) will be
lost.

Currently \fBraidreconf\fR can \fIgrow\fR and \fIshrink\fR RAID-0 and RAID-5 
arrays, and import non-RAID devices into a new RAID-0 or RAID-5.

The whole purpose of \fBraidreconf\fR is to be able to add disks to an
existing array, or convert it to a new type (eg. RAID-0 to RAID-5)
\fIwithout\fR losing data. \fBraidreconf\fR will move the existing
data around on your array, to match the layout of the new array.

.SH OPTIONS
.IP "\fB\-h {--help}\fP"
Raidreconf will print a short help message, and exit.

.IP "\fB\-V {--verbose}\fP"
Raidreconf will print it's version information, and exit.

.IP "\fB\-o {--old} oldraidtab\fP"
Specifies the path name of the old (current) raidtab.  NOTE:
\fBraidreconf\fR performs some tests to ensure that this configuration file 
matches the raid superblocks stored on the disk, but there may be scenarios 
where the two are in conflict, but aren't detected as such.  Be very careful 
to specify this file properly.

.IP "\fB-n {--new} newraidtab\fP"
Specifies the path name of the new raidtab.  After \fBraidreconf\fR
finishes, copy the newraidtab to the oldraidtab location, as raidreconf
doesn't perform this (potentially dangerous) operation.

.IP "\fB-m {--mddev} /dev/md?\fP"
Specifies the name of the raid array to modify.

.IP "\fB-i {--import} /dev/sd??\fP"
Specifies the name of the device to import from.

.IP "\fB-e {--export} /dev/sd??\fP"
Specifies the name of the device to export to.

.SH BUGS
Perhaps many.  Well, the basic RAID-0 growth, shrink and import
algorithms seem to work, but there are lots and lots of consistency
checks and graceful error handling missing.

The RAID-5 algorithms are simplistic, with little optimization other than
that provided by the buffer layer.  Conversions between non-RAID, RAID-0,
and RAID-5 all *seem* to work, but there may be some bugs left yet.

If an error occurs during reconfiguration, a power failure for example,
restore from backup (you DID make a backup, right?), and try again.

Although RAID-4 is not supported, and almost no one uses it, it would be 
almost trivial to add.

.SH REPORTING BUGS
Since this is highly experimental software, there are a number of known
bugs already.  The author would of course like to know about bugs, but
at this stage in development you shouldn't waste too much of your time
trying to hunt them down.  They're probably known, and maybe already
fixed in the author's tree.

Report bugs to <[e-mail]>. ?????

.SH AUTHOR
\fBraidreconf\fR was written in 1999 by Jakob Oestergaard
<[e-mail]>

The RAID-5 routines were written by Daniel S. Cox in 2001 <[e-mail]>

.SH SEE ALSO
.IR mkraid (8),
.IR raidtab (5),
.IR raidstart (8),
.IR raidhotadd (8),
.IR raidhotremove (8),
.IR raidstop (8)