RPi iSCSI Initiator - Revision history

Jabbera: /* Part 2 - iSCSI root */

2013-01-10T23:39:32Z

‎Part 2 - iSCSI root

NidO at 17:45, 2 October 2012

2012-10-02T17:45:52Z

NidO at 17:45, 2 October 2012

2012-10-02T17:45:24Z

NidO: /* Part 2 - iSCSI root */

2012-10-02T17:40:14Z

‎Part 2 - iSCSI root

NidO: /* Assumptions/Pre-requisites */

2012-10-02T17:27:42Z

‎Assumptions/Pre-requisites

NidO at 17:24, 2 October 2012

2012-10-02T17:24:11Z

NidO: /* Part 2 - iSCSI root */

2012-06-06T01:14:16Z

‎Part 2 - iSCSI root

NidO: /* Part 2 - iSCSI root */

2012-06-06T01:12:50Z

‎Part 2 - iSCSI root

NidO: /* Part 1 - iSCSI Support */

2012-06-05T17:25:44Z

‎Part 1 - iSCSI Support

NidO: /* Part 1 - iSCSI Support */

2012-06-05T17:25:18Z

‎Part 1 - iSCSI Support

@@ Line 118: / Line 118: @@
 <pre>cd /
-cp -R bin/ Desktop/ dev/ etc/ home/ lib/ media/ opt/ root/ sbin/ sd/ selinux/ srv/ tmp/ usr/ var/ /mnt/iscsi</pre>
+cp -a bin/ Desktop/ dev/ etc/ home/ lib/ media/ opt/ root/ sbin/ sd/ selinux/ srv/ tmp/ usr/ var/ /mnt/iscsi</pre>
 If you have any top-level folders you've written to your pi which youll want on your iscsi-booted system these should also be copied in the above.

@@ Line 184: / Line 184: @@
 cd initramfs
-gunzip -c -9 /boot/initrd.img-3.1.9+ \
+gunzip -c -9 /boot/initrd.img-3.2.27+ \
    | cpio -i -d -H newc --no-absolute-filenames</pre>

@@ Line 178: / Line 178: @@
 update-initramfs -c -k $(uname -r)</pre>
-We now have a compressed initramfs image (which will be named initrd.img-3.1.9+ on the current Debian image), it's easier to build this uncompressed however, so now we need to extract the image to a /boot subfolder:
+We now have a compressed initramfs image (which will be named initrd.img-3.2.27+ on the current Debian image), it's easier to build this uncompressed however, so now we need to extract the image to a /boot subfolder:
 <pre>

@@ Line 109: / Line 109: @@
 Now create a mountpoint for the volume, we'll use /mnt/iscsi:
-</pre>mkdir /mnt/iscsi</pre>
+<pre>mkdir /mnt/iscsi</pre>
 Mount the volume:
-</pre>mount -t ext4 /dev/sda1 /mnt/iscsi</pre>
+<pre>mount -t ext4 /dev/sda1 /mnt/iscsi</pre>
 Once the partition is mounted, we need to copy our existing debian install to this. There are a number of fancy ways of doing so but a simple recursive copy of the relevant folders works fine, which we'll use for the sake of simplicity:

@@ Line 13: / Line 13: @@
 *At least a basic knowledge of iscsi, and that you already have a suitable target setup on your SAN/NAS/wherever.
 *You are working as the root user - If you're using a non-root user, most commands will need to be prefixed with a sudo.
-*You have repartitioned your SD card to increase the amount of space in / over the default 1.6GB provided by the Debian image (around 2GB is needed in total) - A good guide on doing this is available [https://projects.drogon.net/raspberry-pi/initial-setup1/ Here].
+*You have expanded your SD card to increase the amount of space in / over the default 1.6GB/1.9GB, to at least 2GB - More recent images can do this automatically using raspi-config, for older images or a manual process see [https://projects.drogon.net/raspberry-pi/initial-setup1/ Here].
 =Part 1 - iSCSI Support=

@@ Line 6: / Line 6: @@
 =Introduction=
-This guide is split into two parts, part 1 deals with rebuilding the standard Debian image to include iscsi support so that the pi can access an iscsi target (and function as a target itself if needed, but this guide deals with setting up as an initiator), part 2 then extends on this to enable booting from an iscsi root. For the sake of simplicity we will be performing on-device kernel recompiles, these take 4-6 hours, you can simply perform a cross-compile elsewhere to speed this up if you prefer.
+This guide is split into two parts, part 1 deals with rebuilding the standard Raspbian/Debian image to include iscsi support so that the pi can access an iscsi target (and function as a target itself if needed, but this guide deals with setting up as an initiator), part 2 then extends on this to enable booting from an iscsi root. For the sake of simplicity we will be performing on-device kernel recompiles, these take 4-6 hours, you can simply perform a cross-compile elsewhere to speed this up if you prefer.
 =Assumptions/Pre-requisites=

← Older revision		Revision as of 01:14, 6 June 2012
Line 91:		Line 91:

	This section will cover moving your Debian install's root to an iscsi volume, then generating a new kernel with included initramfs that will load open-iscsi to be able to mount your iscsi volume as root, essentially performing a network boot of your pi using iSCSI (by the end of this the pi's SD card will still be needed for the initial kernel/initramfs load, but after that the card will be removable).		This section will cover moving your Debian install's root to an iscsi volume, then generating a new kernel with included initramfs that will load open-iscsi to be able to mount your iscsi volume as root, essentially performing a network boot of your pi using iSCSI (by the end of this the pi's SD card will still be needed for the initial kernel/initramfs load, but after that the card will be removable).
		+	Part 2 assumes you have already followed Part 1, both to end up with an iscsi-capable kernel and have the relevant tools installed to be able to rebuild your kernel.

	First up, we need to prepare the iscsi volume with a working install of Debian.		First up, we need to prepare the iscsi volume with a working install of Debian.

← Older revision		Revision as of 01:12, 6 June 2012
Line 90:		Line 90:
	=Part 2 - iSCSI root=		=Part 2 - iSCSI root=

−	~~Coming shortly~~	+	This section will cover moving your Debian install's root to an iscsi volume, then generating a new kernel with included initramfs that will load open-iscsi to be able to mount your iscsi volume as root, essentially performing a network boot of your pi using iSCSI (by the end of this the pi's SD card will still be needed for the initial kernel/initramfs load, but after that the card will be removable).
		+
		+	First up, we need to prepare the iscsi volume with a working install of Debian.
		+
		+	I will assume you already have an iscsi session connected to a target (and that the target volume is empty and unpartitioned), this volume will most likely be /dev/sda unless you have other disks in the system. NOTE we will be making destructive changes to your target volume (partitioning and formatting it), all of the below assumes the use of /dev/sda, do check this on your pi first if there's any risk of you having other devices mounted.
		+
		+	First off, partition your iSCSI target:
		+
		+	<pre>fdisk -uc /dev/sda</pre>
		+
		+	n to add a new partition, p to create a primary partition, 1 to create partition 1, accept first and last sector defaults to use the entire volume. w to write the new partition.
		+
		+	Now write an ext4 filesystem to the new partition created:
		+
		+	<pre>mkfs.ext4 /dev/sda1</pre>
		+
		+	Now create a mountpoint for the volume, we'll use /mnt/iscsi:
		+
		+	</pre>mkdir /mnt/iscsi</pre>
		+
		+	Mount the volume:
		+
		+	</pre>mount -t ext4 /dev/sda1 /mnt/iscsi</pre>
		+
		+	Once the partition is mounted, we need to copy our existing debian install to this. There are a number of fancy ways of doing so but a simple recursive copy of the relevant folders works fine, which we'll use for the sake of simplicity:
		+
		+	<pre>cd /
		+	cp -R bin/ Desktop/ dev/ etc/ home/ lib/ media/ opt/ root/ sbin/ sd/ selinux/ srv/ tmp/ usr/ var/ /mnt/iscsi</pre>
		+
		+	If you have any top-level folders you've written to your pi which youll want on your iscsi-booted system these should also be copied in the above.
		+
		+	<pre>mkdir /mnt/iscsi/proc
		+	mkdir /mnt/iscsi/sys
		+	mkdir /mnt/iscsi/boot</pre>
		+
		+	From this point, we should now have a working install in place on our iscsi volume - In order to test this we can swap our root to /mnt/iscsi (the iscsi volume's mount point):
		+
		+	<pre>mkdir /mnt/iscsi/oldroot
		+	pivot_root /mnt/iscsi/ /mnt/iscsi/oldroot/
		+	mount -t proc none /proc</pre>
		+
		+	This has now swapped your root to the iscsi volume, assuming you still appear to have a working system (basic system commands etc still work) you're all good so far. If you're feeling brave, you can test this further by pulling the SD card from your pi, and it should continue functioning as normal.
		+
		+	We now need to disable a couple of services while running on the iscsi root (as these will cause boot problems with the initramfs we setup later:
		+
		+	<pre>update-rc.d -f open-iscsi remove
		+	update-rc.d -f ifplugd remove</pre>
		+
		+	While we're rooted to the iscsi volume we can also alter its fstab, so open /etc/fstab, remove any current mount point for / (most likely /dev/mmcblk0p2) and add a new one as:
		+
		+	<pre>/dev/sda1 / ext4 defaults,noatime,nodiratime 0 0</pre>
		+
		+	We now need to get back to our standard SD install, depending on what you've done above the most straightforward way is to simply power down the device, put the SD card back in (if you removed it) and start your pi back up again.
		+
		+	Now that we have a working install on the iscsi target, we need to configure the kernel to be able to boot directly from this.
		+
		+	First up, getting a network connection. We'll assume a wired connection, wireless is perfectly possible but will depend on whether you're using an adaptor the kernel natively supports or needs a module, which can get complicated quickly. We need to ensure a valid network address is being set early during boot, to do this edit /boot/cmdline.txt with your favourite editor.
		+
		+	A default cmdline.txt will look like this:
		+
		+	<pre>dwc_otg.lpm_enable=0 console=ttyAMA0,115200 kgdboc=ttyAMA0,115200 console=tty1 root=/dev/mmcblk0p2 rootfstype=ext4 rootwait</pre>
		+
		+	If you are assigning IPs via DHCP, change it to:
		+
		+	<pre>dwc_otg.lpm_enable=0 console=ttyAMA0,115200 kgdboc=ttyAMA0,115200 console=tty1 ip=dhcp root=/dev/mmcblk0p2 rootfstype=ext4 rootwait</pre>
		+
		+	If you assign IPs manually, simply enter the IP for the device to use as:
		+
		+	<pre>dwc_otg.lpm_enable=0 console=ttyAMA0,115200 kgdboc=ttyAMA0,115200 console=tty1 ip=XX.XX.XX.XX root=/dev/mmcblk0p2 rootfstype=ext4 rootwait</pre>
		+
		+	Open/create /etc/iscsi/iscsi.initramfs - This file needs to contain initiator/target details for your iscsi volume, in the following format:
		+
		+	<pre>ISCSI_INITIATOR=initiatorname
		+	ISCSI_TARGET_NAME=targetname
		+	ISCSI_TARGET_IP=target_ip</pre>
		+
		+	targetname and target_ip need to be entered per your iscsi volume's correct target name and address, initiatorname can be any validly formatted name (eg. iqn.2012-06.org.raspberrypi:01)
		+
		+	We now need to install initramfs-tools:
		+
		+	<pre>apt-get install initramfs-tools</pre>
		+
		+	Now to build the initramfs:
		+
		+	<pre>cd /boot
		+	update-initramfs -c -k $(uname -r)</pre>
		+
		+	We now have a compressed initramfs image (which will be named initrd.img-3.1.9+ on the current Debian image), it's easier to build this uncompressed however, so now we need to extract the image to a /boot subfolder:
		+
		+	<pre>
		+	mkdir initramfs
		+	cd initramfs
		+
		+	gunzip -c -9 /boot/initrd.img-3.1.9+ \
		+	\| cpio -i -d -H newc --no-absolute-filenames</pre>
		+
		+	With that done it's now back to our kernel sources to modify the kernel's configuration to include the initramfs:
		+
		+	<pre>cd /root/raspberrypi/linux
		+	make menuconfig</pre>
		+
		+	In the menuconfig UI, navigate to "General Setup" then enable "Initial RAM filesystem and RAM disk (initramfs/initrd) support". Then edit "Initramfs source file(s)" and set its path to /boot/initramfs/, okay the path, then select "Built-in initramfs compression mode" and set this to gzip. Save and exit menuconfig.
		+
		+	Now it's time to make our new kernel with included iscsi-enabled initramfs, this will however be much quicker than the full recompile in Part 1 (this should take no more than ~10 minutes:
		+
		+	<pre>make</pre>
		+
		+	As earlier, we now need to generate a pi-usable kernel image from this and copy it to /boot, taking a backup of the current kernel in the process:
		+
		+	<pre>cd /root/raspberrypi/tools/mkimage/
		+	python imagetool-uncompressed.py /root/raspberrypi/linux/arch/arm/boot/Image
		+
		+	cp /boot/kernel.img /boot/kernel.img-backup
		+	cp kernel.img /boot/kernel.img</pre>
		+
		+	Now edit /boot/cmdline.txt and alter
		+
		+	<pre>root=/dev/mmcblk0p2</pre>
		+	to
		+	<pre>root=/dev/sda1</pre>
		+
		+	Save the file, and you should now be ready to reboot to your configured iSCSI volume! If you have a screen plugged in for the boot process and you keep your eyes open you should see your pi mount sda1 as its root device rather than mmcblk0p2. Once this has happened, you should be able to disconnect the device's SD card and it'll continue functioning from the network.
		+
		+	Should you have any problems with booting from the network using your initramds-enabled kernel, you can revert to local booting using your old kernel by loading your SD card up into a host machine, copying kernel.img-backup back to kernel.img, and modifying cmdline.txt to set root= back to /dev/mmcblk0p2.

← Older revision		Revision as of 17:25, 5 June 2012
Line 40:		Line 40:

	Once the UI has loaded, navigate to the "Device Drivers" section (enter to navigate between pages, space to change an option), then "SCSI device support", then "SCSI Transports". Change the "iSCSI Transport Attributes" option twice (so that it shows a ) to build it into the kernel. Go back a page, hit space for "SCSI low-level drivers" to enable this option, then enter to descend into it, then space twice for a on "iSCSI Initiator over TCP/IP".		Once the UI has loaded, navigate to the "Device Drivers" section (enter to navigate between pages, space to change an option), then "SCSI device support", then "SCSI Transports". Change the "iSCSI Transport Attributes" option twice (so that it shows a ) to build it into the kernel. Go back a page, hit space for "SCSI low-level drivers" to enable this option, then enter to descend into it, then space twice for a on "iSCSI Initiator over TCP/IP".
		+
	Once these options are enabled, exit the UI and save changes. To ensure these are set, run:		Once these options are enabled, exit the UI and save changes. To ensure these are set, run:

@@ Line 46: / Line 46: @@
 This should return the following:
-CONFIG_SCSI_ISCSI_ATTRS=y
+<pre>CONFIG_SCSI_ISCSI_ATTRS=y
 CONFIG_ISCSI_TCP=y
-"# CONFIG_ISCSI_BOOT_SYSFS is not set"
+# CONFIG_ISCSI_BOOT_SYSFS is not set</pre>
 With this in place, compile your new kernel: