✎ 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 ======

   - 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 shell>
#!/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 shell>
#!/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>

Trace: • contributing • notes • msdhcp • realtek8139roms • devmanual • ubuntu_iscsi2 • soc • commandline • journal • sanboot • vmwarebios • suse • week3 • vmware • 2009 • doc • wrapup • 2010 • journal • usermanual