This article presents the analysis of a problem I had setting up a RAID1 root filesystem using mdadm on Debian squeeze (6.0-6.0.1) using grub2. The analysis and conclusions are below.
Debian squeeze includes the following packages:
For compatibility with what most other people do, this article will use the names grub2 and grub-legacy. In addition, we will refer to the code written to a system’s MBR as the grub loader, which may be supplemented by grub modules.
My system has two disks: /dev/sda and /dev/sdb. /dev/sda is partitioned by partman during the installation into /dev/sda1 of size 12GB for root, /dev/sda2 of size 500MB for swap, its remaining space was left unallocated. /dev/sdb had no partitions, so all its remaining space was left unallocated. What I wanted was a RAID1 root filesystem and RAID1 swap.
My plan was based on what I had previously done on Debian lenny systems:
- copy the partition table from /dev/sda to /dev/sdb using parted
- create a one-legged (i.e. immediately degraded) RAID1 device /dev/md0 from /dev/sdb1 and a one-legged RAID1 device /dev/md1 from /dev/sdb2 using mdadm
- copy root filesystem from /dev/sda1 into /dev/md0 by running:
mount /dev/md0 /mnt rsync -ax / /mnt/
and update the fstab on /dev/md0 to mount /dev/md0 as root filesystem.
- ensure /dev/sda’s MBR is intelligent enough to find the Linux kernel inside /dev/md0 by running:
grub-install --modules="raid mdraid part_msdos ext2 linux normal help" \ --root-directory=/mnt /dev/sda
- reboot using some manual intervention to boot from /dev/md0 (in order to ensure /dev/sda1 is not in use in order to ensure mdadm is able to add /dev/sda1 to /dev/md0 without complaining that /dev/sda1 is in use)
- add /dev/sda1 to /dev/md0 and /dev/sda2 to /dev/md1 using mdadm
- ensure both disks’ MBRs are intelligent enough to find the Linux kernel inside /dev/md0 using grub-install
- test by physically detaching each disk in turn
Step 5 of the plan outlined in the previous section failed; I could not get the grub loader to load the Linux kernel from /dev/md0. In case this page is googled, here are several of the error messages I encountered:
Welcome to GRUB! error: no such disk. Entering rescue mode... grub rescue> insmod linux error: no such disk. grub rescue> set prefix=(md0)/boot/grub grub rescue> insmod linux error: no such disk. grub rescue> set prefix=(hd1,msdos1)/boot/grub grub rescue> ls $prefix error: file not found. grub rescue> ls / error: no such disk. grub rescue> set root=(hd1,msdos1) grub rescue> ls / grub rescue> set prefix=(hd0,msdos1)/boot/grub grub rescue> insmod linux grub rescue> insmod normal grub rescue> help Unknown command `help' grub rescue> insmod help grub rescue> normal # escape from grub menus to grub shell c grub> set root=(hd0,msdos1) # tab-completion works here grub> linux /boot/vmlinuz-2.6.32-5-amd64 root=/dev/md0 ro # and here too grub> initrd /boot/initrd.img-2.6.32-5-amd64 grub> boot # kernel boots ... Booting processor 1 APIC 0x3 in 0x6000 Not responding Booting processor 2 APIC 0x2 in 0x6000 Not responding Booting processor 3 APIC 0x1 in 0x6000 Not responding # system reboots!
When I was unable to boot from /dev/md0, I decided to try all combinations of:
- telling mdadm to use either metadata version 0.90 or metadata version 1.20,
- either running or not running grub-install before the reboot,
- either interrupting the grub loader at the boot menu and editing the first boot menu selection or escaping to the grub loader’s shell and trying to boot manually or not interrupting the grub loader,
- interactively telling the grub loader to get the Linux kernel either from (md0) or (md/0) or (hd1,msdos1) or (hd0,msdos1),
- telling the Linux kernel that the root filesystem is either /dev/md0 or /dev/sda1,
- either adding or not adding nolapic to the kernel command line.
Some combinations could not be tested because things had already gone wrong (e.g. if it is not possible to tell the grub loader to get the kernel from (md0) then it is not possible to tell the kernel to use /dev/md0 as the root fileystem). Some combinations could not be tested because the combination was not valid (e.g. if the grub loader is not interrupted then there is no opportunity to tell the kernel that the root filesystem is either /dev/md0 or /dev/sda1).
The results of this analysis are best presented as a flowchart (click on the image for the fullsize version):
Notes on various boxes in the diagram:
- mdadm metadata version: either write mdadm’s metadata to disk in version 0.90 format or in 1.20 format. 0.90 format was written by default by mdadm version 126.96.36.199, which was included with Debian lenny. 1.20 format is written by default by mdadm version 3.1.4, whichh is included with Debian squeeze. For more info, see the mdadm(8) man page.
- grub finds grub and load modules: when the grub loader is written onto the MBR with the grub-install command, then some grub modules may be written with it; these are typically used to give the grub loader enough intelligence to find and load other grub modules; these other grub modules are typically used to find and load the Linux kernel. The Debian installer calls grub-install getting it to write the following grub modules to the MBR: raid, mdraid, part_msdos, ext2. After that you can run something like:
set prefix=(hd0,msdos1)/boot/grub insmod <module-name>
to add other modules. The grub-install command shown in the ‘The Plan’ section above writes all the necessary modules to the MBR, so there should be no need to set prefix or run insmod to load anything else (at least for this RAID1 + non-LVM setup).
- menu interrupt mode: at the grub loader’s boot menu, one of three relevant steps may be taken: do nothing allowing the grub loader to execute the commands behind the first menu option, edit the first menu option, escape to the grub loader’s shell.
- grub root: specifies the value of the grub loader’s root environment variable; e.g.:
It is kind of implied that the grub loader’s prefix environment variable will have been set to something similar first; e.g.:
- linux root: specifies the value of the Linux kernel’s root command line option; e.g.:
- nolapic: specifies whether the Linux kernel’s nolapic command line option was used
- OK: system boots up successfully from /dev/md0
- OK: USELESS: system boots up successfully from /dev/sda1, but this is not what we wanted, as it will mean /dev/sda1 is marked as in use, and therefore cannot be added to /dev/md0
- OK: OUT OF SCOPE: this article is concerned with grub2, not grub-legacy (a procedure for installing grub-legacy and RAID1 can be found in the ‘Raiding root and swap (lenny)’ section of Configuring storage services)
- ERROR: NO SUCH DISK: the grub loader reports error: no such disk.
- ERROR: LS EMPTY: the grub loader’s ‘ls /’ command reports nothing
- ERROR: APIC: consistent APIC errors while booting the kernel
- ERROR: ~APIC: occasional APIC errors while booting the kernel
- ERROR: ~SERVICES: occasional service startup errors (e.g. syslogd, ntpd)
Having worked out all the above ways to try to boot and the results, it remains to select the route across the flowchart from “START” to an “OK” that involves the minimum deviation from a standard installation. This is not so difficult as there are only a couple of options.
- The route I selected was the following (click on the image for the fullsize version):
(But note that this route is only required for a short time during the procedure.)
- The complete procedure can be found in the ‘Raiding root and swap (squeeze)’ section of Configuring storage services generation two.
- grub2 thinks (md0) and (md/0) are the same,
- grub-install’s --root option is used to determine where to write supplementary grub modules to and to derive the initial value for the grub loader’s prefix environment variable written onto the MBR.
- The fact that reinstalling grub2 results in an automatically bootable system whereas manually running grub-install does not, suggests some extra steps are being run by grub2′s post-install script (but note that that only writes an MBR to /dev/sda, not to /dev/sdb).
- There are obvious reasons why grub2 has not yet reached version 2.0; one might reasonably consider installing grub-legacy instead of grub2 and waiting to see how much grub2 has evolved by the time Wheezy is released, especially as Xen Dom0s with lenny installed require all PV DomUs to use grub-legacy.
- Once both disks are part of RAID volumes, then do not run grub-install; it will not be possible to boot if you do!
- It’s more than likely that I have misunderstood something about how to use grub-install, but it is not something I could find by googling or referring to official grub documentation or man pages. If somebody knows the full grub-install command I should be running to avoid all these problems then please let me know!