This is an old revision of the document!
====== Debian etch ====== ===== Preparing an existing installation for iSCSI ===== This howto is based on the following assumptions: * a base debian >= etch with all the security updates * the system is installed on a single partition "/" on /dev/sda1 * there is an already done iscsi target on an iscsi server * there is a working dhcp server Since two fundamental tools from open-iscsi are not included in the debian package, they have to be compiled from the sources with the following steps (i have used a different machine for all the compilation stuff). Install the appropriate devel packages: apt-get build-dep open-iscsi apt-get install libdb4.3-dev Download the sources and compile them: wget http://www.open-iscsi.org/bits/open-iscsi-2.0-865.13.tar.gz (this is the latest tarball at this time) tar xzf open-iscsi-2.0-865.13.tar.gz cd open-iscsi-2.0-865.13 make -C usr make -C utils/fwparam_ibft The two files needed are ''usr/iscsistart'' and ''utils/fwparam_ibft/fwparam_ibft'' so they have to be copied in ''/usr/sbin''. Create two scripts shown below. These scripts have to be executable. * ''/etc/initramfs-tools/hooks/iscsi_tcp'' will copy the ''iscsi_tcp'', ''iscsi_iser'' kernel modules followed by their dependancies, ''/usr/sbin/iscsistart'' and ''/usr/sbin/fwparam_ibft'' to the initial ramdisk. * ''/etc/initramfs-tools/scripts/local-top/iscsi_tcp'' 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 a SCSI device it brings up the appropriate Ethernet device, sets up the ip address passed through dhcp and connects the root file system on the iSCSI target. After you have made sure that ''/etc/initramfs-tools/initramfs.conf'' contains the line BUSYBOX=y you can update the initial ramdisk: dpkg-reconfigure linux-image-$(uname -r) If the modifications were applied to a physical disk on the client machine, you can now [[sanboot:transfer|transfer the contents of your physical disk to the SAN target]]. If the image you wish to export to client systems was modified directly,, you can now [[sanboot:iscsitarget|make the contents of that image available via iSCSI]]. ==== Hint ==== * 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. ==== Scripts ==== === /etc/initramfs-tools/hooks/iscsi_tcp === <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 /usr/sbin/iscsistart ] && copy_exec /usr/sbin/iscsistart /sbin [ -x /usr/sbin/fwparam_ibft ] && copy_exec /usr/sbin/fwparam_ibft /sbin [ -x /sbin/ip ] && copy_exec /sbin/ip /sbin manual_add_modules iscsi_tcp manual_add_modules ib_iser </code>
