r129 - mdadm/trunk/debian

Sun Aug 20 23:24:45 UTC 2006

Author: madduck
Date: 2006-08-20 23:24:41 +0000 (Sun, 20 Aug 2006)
New Revision: 129

Modified:
   mdadm/trunk/debian/README.Debian
   mdadm/trunk/debian/README.upgrading-2.5.3
   mdadm/trunk/debian/TODO
   mdadm/trunk/debian/UPGRADE-STRATEGY
   mdadm/trunk/debian/changelog
   mdadm/trunk/debian/mdadm-raid
   mdadm/trunk/debian/mdadm.postinst
Log:
docs update and minor touchups

Modified: mdadm/trunk/debian/README.Debian
===================================================================

--- mdadm/trunk/debian/README.Debian	2006-08-20 23:24:05 UTC (rev 128)
+++ mdadm/trunk/debian/README.Debian	2006-08-20 23:24:41 UTC (rev 129)
@@ -5,11 +5,13 @@
 documentation for the kernel md driver is included in
 /usr/share/doc/mdadm/md.txt.gz as well as the md(4) manpage. *Do* read those!
 
-The configuration file
-~~~~~~~~~~~~~~~~~~~~~~
-This version of mdadm now needs /etc/mdadm/mdadm.conf, which it will try to
+Upgrading and the configuration file
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This version of mdadm now NEEDS /etc/mdadm/mdadm.conf, which it will try to
 generate during installation, if nonexistent.
 
+PLEASE MAKE SURE TO READ /usr/share/doc/mdadm/README.upgrading-2.5.3.gz !
+
 You can use the output of /usr/share/mdadm/mkconf to generate your very own
 mdadm.conf file, and look into
 /usr/share/doc/mdadm/examples/mdadm.conf-example for inspiration.

Modified: mdadm/trunk/debian/README.upgrading-2.5.3
===================================================================
--- mdadm/trunk/debian/README.upgrading-2.5.3	2006-08-20 23:24:05 UTC (rev 128)
+++ mdadm/trunk/debian/README.upgrading-2.5.3	2006-08-20 23:24:41 UTC (rev 129)
@@ -1,4 +1,4 @@
-upgrading to mdadm 2.5.3 from previous versions
+Upgrading to mdadm 2.5.3 from previous versions
 ===============================================
 
 With version 2.5.3, the Debian mdadm package now requires a mdadm.conf file.
@@ -41,6 +41,9 @@
     metadata, and whatever other subsystem uses MD arrays on your machine
     have a corresponding line in the configuration file.
 
+    Make sure to verify that your bootloader refers to the proper device name,
+    in case your root filesystem is on an MD array.
+
     In particular, verify that the device node name is exactly the same;
     /dev/md6 is *not* identical to /dev/md/6. Partitionable arrays are
     a slight exception: if /dev/md_d0p3 is referenced, you need an entry for
@@ -54,6 +57,16 @@
 
     Identifying arrays by UUID is the preferred method.
 
+Once you have verified that the configuration file is accurate, you need to
+let mdadm know, and update the initial ramdisk. This is accomplished with the
+following two commands:
+
+  rm -f /var/lib/mdadm/CONF-UNCHECKED
+  update-initramfs -u -k all
+
+Depending on your setup, mdadm should print an appropriate informational
+message. Please make sure that it is in accordance with what you would expect.
+
 What to do if my system does not boot anymore?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 First thing: don't panic! If your system does not boot anymore as a result of

Modified: mdadm/trunk/debian/TODO
===================================================================
--- mdadm/trunk/debian/TODO	2006-08-20 23:24:05 UTC (rev 128)
+++ mdadm/trunk/debian/TODO	2006-08-20 23:24:41 UTC (rev 129)
@@ -3,15 +3,14 @@
 
 - check whether mdadm.conf and system are consistent during initramfs creation
   and fail otherwise (#381303).
-- then switch to using system mdadm.conf in initramfs.
-- add debconf question to determine naming scheme. Reuse logic from udev
-  script mdadm-name-generator.sh to preseed the question, store answer in
-  /etc/default, make mdadm-name-generator.sh actually use that value. Or just
-  get rid of mdadm-name-generator.sh and move everything to debconf.config,
-  then install udev rules for each naming scheme to /usr/share/mdadm and use
-  ucf to install the appropriate one to /etc.
 - version-1 is a nightmare. E.g. on partitionable arrays, with / on
   /dev/md_d0p3, mdadm -Es ignores /dev/md_d0 and just uses the name, so
   /dev/md/<arrayname>.
+- figure out something about device names.
 
+- VERIFY SARGE UPGRADE
+- verify operation without udev
+  - udev removed before mdadm installed
+  - udev removed after mdadm installed
+
 $Id$

Modified: mdadm/trunk/debian/UPGRADE-STRATEGY
===================================================================
--- mdadm/trunk/debian/UPGRADE-STRATEGY	2006-08-20 23:24:05 UTC (rev 128)
+++ mdadm/trunk/debian/UPGRADE-STRATEGY	2006-08-20 23:24:41 UTC (rev 129)
@@ -1,6 +1,8 @@
 mdadm: upgrading from sarge -- braindump
 ========================================
 
+THIS IS AN OBSOLETE DOCUMENT
+
 The mdrun deprecation means we have to find a proper way to migrate from
 sarge. The plan is to support
 

Modified: mdadm/trunk/debian/changelog
===================================================================
--- mdadm/trunk/debian/changelog	2006-08-20 23:24:05 UTC (rev 128)
+++ mdadm/trunk/debian/changelog	2006-08-20 23:24:41 UTC (rev 129)
@@ -7,6 +7,10 @@
       0 instead of _d0) for device names like md_dX. I actually think this is
       a bug and hope upstream will use dX (e.g. d0) instead in a future
       version.
+    - we specify --symlink=no and thus disable the new feature to create
+      /dev/mdX symlinks to /dev/md/X devices until the entire device node mess
+      is cleared up. No need to introduce yet another complicating factor at
+      this stage.
   * Instead of trying to do a whole lot of magic with respect to detecting
     RAID devices to start, mdadm from now on requires a valid mdadm.conf file
     to be installed. It still tries to do what it can, but there are no

Modified: mdadm/trunk/debian/mdadm-raid
===================================================================
--- mdadm/trunk/debian/mdadm-raid	2006-08-20 23:24:05 UTC (rev 128)
+++ mdadm/trunk/debian/mdadm-raid	2006-08-20 23:24:41 UTC (rev 129)
@@ -28,6 +28,7 @@
   local dev=${1##*/}
   case "$dev" in
     md*|md_*|mdp*|mdp_*) echo "$dev";;
+    d*) echo "md_${dev}";;
     *) echo "md${dev}";;
   esac
 }
@@ -91,7 +92,7 @@
         IFSOLD=${IFS:-}
         IFS='
 '
-        for line in $($MDADM --assemble --scan --auto=yes 2>&1); do
+        for line in $($MDADM --assemble --scan --auto=yes --symlink=no 2>&1); do
           IFS=$IFSOLD
           set -- $line
           shift

Modified: mdadm/trunk/debian/mdadm.postinst
===================================================================
--- mdadm/trunk/debian/mdadm.postinst	2006-08-20 23:24:05 UTC (rev 128)
+++ mdadm/trunk/debian/mdadm.postinst	2006-08-20 23:24:41 UTC (rev 129)
@@ -8,7 +8,7 @@
 
 . /usr/share/debconf/confmodule
 # See #369953 for ordering
-set -eux
+set -eu
 
 case "${1:-}" in
   configure|reconfigure)


