diff options
-rw-r--r-- | debian/FAQ | 66 | ||||
-rw-r--r-- | debian/TODO | 7 | ||||
-rw-r--r-- | debian/changelog | 3 | ||||
-rw-r--r-- | debian/mdadm.docs | 1 |
4 files changed, 76 insertions, 1 deletions
diff --git a/debian/FAQ b/debian/FAQ new file mode 100644 index 00000000..1b43886a --- /dev/null +++ b/debian/FAQ @@ -0,0 +1,66 @@ +Frequently asked questions -- Debian mdadm +========================================== + +Also see /usr/share/doc/mdadm/README.recipes.gz + +1. How do I change the preferred minor of a RAID array? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + See item 12 in /usr/share/doc/mdadm/README.recipes.gz and read the mdadm + manpage (search for 'preferred'). + +2. How does mdadm determine which /dev/mdX or /dev/md/X to use? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + The logic used by mdadm to determine the device node name in the mdadm + --examine output (which is used to generate mdadm.conf) depends on several + factors. Here's how mdadm determines it: + + It first checks the superblock version of a given array (or each array in + turn when iterating all of them). Run + + mdadm --detail /dev/mdX | sed -ne 's,.*Version : ,,p' + + to determine the superblock version of a running array, or + + mdadm --examine /dev/sdXY | sed -ne 's,.*Version : ,,p' + + to determine the superblock version from a component device of an array. + + Version 0 superblocks (00.90.XX) + '''''''''''''''''''''''''''''''' + You need to know the preferred minor number stored in the superblock, + so run either of + + mdadm --detail /dev/mdX | sed -ne 's,.*Preferred Minor : ,,p' + mdadm --examine /dev/sdXY | sed -ne 's,.*Preferred Minor : ,,p' + + Let's call the resulting number MINOR. Also see FAQ 1 further up. + + Given MINOR, mdadm will output /dev/md<MINOR> if the device node + /dev/md<MINOR> exits. + Otherwise, it outputs /dev/md/<MINOR> + + Version 1 superblocks (01.XX.XX) + '''''''''''''''''''''''''''''''' + Version 1 superblocks actually seem to ignore preferred minors and instead + use the value of the name field in the superblock. Unless specified + explicitly during creation (-N|--name) the name is determined from the + device name used, using the following regexp: 's,/dev/md/?(.*),$1,', thus: + + /dev/md0 -> 0 + /dev/md/0 -> 0 + /dev/md_d0 -> _d0 + /dev/md/d0 -> d0 + /dev/md/name -> name + (/dev/name does not seem to work) + + mdadm will append the name to '/dev/md/', so it will always output device + names under the /dev/md/ directory. + + If you want to change the name, you can do so during assembly: + + mdadm -A -U name -N newname /dev/mdX /dev/sd[abc]X + + I know this all sounds inconsistent and upstream has some work to do. + We're on it. + + -- martin f. krafft <madduck@debian.org> Wed, 02 Aug 2006 16:38:29 +0100 diff --git a/debian/TODO b/debian/TODO new file mode 100644 index 00000000..478ff7b3 --- /dev/null +++ b/debian/TODO @@ -0,0 +1,7 @@ +debian mdadm TODO list +====================== + +- level:module is 1:1 and the initramfs stuff makes use of that. However, + check what happens with raid456 module! +- use mdadm.conf during initramfs assembly to make sure super-minor is + honoured. diff --git a/debian/changelog b/debian/changelog index c9d59aef..07f8fba6 100644 --- a/debian/changelog +++ b/debian/changelog @@ -21,8 +21,9 @@ mdadm (2.5.2-10) UNRELEASED; urgency=low for given devices. * checkarray: now supports -x|--cancel switch to cancel running checks. * mkconf: now also outputs MAILADDR. + * Added /usr/share/doc/mdadm/FAQ to answer some FAQs. - -- martin f. krafft <madduck@debian.org> Wed, 2 Aug 2006 16:18:18 +0100 + -- martin f. krafft <madduck@debian.org> Wed, 2 Aug 2006 17:00:08 +0100 mdadm (2.5.2-9) unstable; urgency=low diff --git a/debian/mdadm.docs b/debian/mdadm.docs index 327fa9e0..839ccb5d 100644 --- a/debian/mdadm.docs +++ b/debian/mdadm.docs @@ -2,6 +2,7 @@ debian/README.recipes debian/README.initramfs-transition debian/README.mdrun debian/README.checkarray +debian/FAQ md.txt rootraiddoc.97.html RAID5_versus_RAID10.txt |