✎ debian_aoe_migrate - 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.

====== Migrating Debian GNU/Linux 4.0 (etch) or later to an AoE target ======

Install the ''aoetools'' package and a kernel image that includes the
''aoe'' driver, i.e. one of the ''linux-image-2.6.18-*'' drivers
that ship with Debian/etch.

Create two scripts as shown below
   * ''/etc/initramfs-tools/hooks/aoetools'' will copy the ''aoe'' kernel module and ''/sbin/aoe-discover'' to the initial ramdisk.
   * ''/etc/initramfs-tools/scripts/local-top/aoetools'' is copied to the ram disk and 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 recognized Ethernet interfaces and activates the AoE driver.

After you have made sure that ''/etc/initramfs-tools/initramfs.conf''
contains the line
   BUSYBOX=y
you can update the initial ramdisk:
   # update-initramfs -u -k all

FIXME Create/update ''/etc/fstab''

FIXME Create/update ''/boot/grub/menu.lst''

You can now [[santransfer|transfer]] the contents of your physical
disk to an image stored on the SAN or continue by [[sanexport|making]]
the contents of your image available.

==== Hints ====
   * If the system hangs 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.


===== Configuration files =====
==== /etc/initramfs-tools/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>

==== /etc/initramfs-tools/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>

Trace: • debian_aoe_migrate • project_plan • 3com • andytim_todo • notes • notes • notes • notes • notes • features_added • notes • pictures • oldundiproposal