✎ aoebootprepdebianetch - Etherboot/gPXE Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== Booting Debian from an ATA over Ethernet (AoE) target ======

These instructions assume that the client machine can already access
an AoE target upon boot using INT13 so that GRUB's stage2 can be
loaded from the AoE target.

   - Install the ''aoetools'' package and a kernel image that includes the ''aoe'' driver,  ''linux-image-2.6.18-5-*'' from Debian/etch will do fine.
   - Create ''/etc/initramfs-tools/hooks/aoetools'' and ''/etc/initramfs-tools/scripts/local-top/aoetools'' scripts as shown below.\\ The ''hooks/aoetools'' script makes sure that the ''aoe'' kernel module and ''/sbin/aoe-discover'' get added to the initial ramdisk. The ''scripts/local-top/aoetools'' script will be copied to the ramdisk and be run at boot-time, just before the root filesystem is mounted. If the root device string looks like an AoE target, it brings up all Ethernet interfaces that have been recognized by the kernel and sends the `aoe' driver looking for targets.
   - Make sure that /etc/initramfs-tools/initramfs.conf contains ''BUSYBOX=y'' so that Busybox is included in the initrd.
   - Create or update ''/etc/fstab'' and ''/boot/grub/menu.lst'': Replace ''/dev/hd*'' or ''/dev/sd*'' entries in ''/etc/fstab'' with entries of the form ''/dev/etherd/eX.YpZ'' where X is the AoE shelf number, Y is the disk number, and Z is the partition number. Grub should pass something like ''root=/dev/etherd/eX.YpZ'' to the Linux kernel via its command line.
   - Update the initial ramdisks: ''# update-initramfs -u -k all''
   - Disconnect the hard drive in the client machine and boot it.\\ If the system should hang before the root device has been mounted, passing ''break=mount'' on the command line will spawn a shell before `scripts/local-top/aoetools' is run. This should allow for further debugging.


===== hooks/aoetools =====
<code bash>
#!/bin/sh

set  -e

PREREQ=""

prereqs()
{
	echo "$PREREQ"
}

case $1 in
prereqs)
	prereqs
	exit 0
	;;
esac

. /usr/share/initramfs-tools/hook-functions

[ -x /sbin/aoe-discover ] && copy_exec /sbin/aoe-discover /sbin
manual_add_modules aoe
</code>


===== scripts/local-top/aoetools =====
<code bash>
#!/bin/sh

set -e

PREREQ=""

prereqs()
{
	echo "$PREREQ"
}

case $1 in
prereqs)
	prereqs
	exit 0
	;;
esac

case $ROOT in
/dev/etherd/e*)
	INTERFACES=`awk -F: '/eth[0-9]*:/ { print $1 }' < /proc/net/dev`
	for i in $INTERFACES; do
		echo Bringing up interface $i for AoE
		ifconfig $i up
	done
	sleep 5
	modprobe aoe
	aoe-discover
	;;
esac

</code>

 --- //[[bengen+etherboot@hilluzination.de|Hilko Bengen]] 2007/08/24 11:04//**Bold Text**

Trace: • week9 • notes • vmwarebios • 2010 • project_plan • journal • zeroconf_design • autobootchainurl • soc • 2009 • journal • usbwithstorage • staging • usermanual • doc • commandline • hardwareissues • 2006 • gdbstub • notes