/
RPi 4B iscsi how-to

RPi 4B iscsi how-to

Jun 16, 2020

 

Inspiration from hiroom2.com. Kudos!

Foreword

These steps are meant to be completed on a Linux computer that serves as a netboot server of the MicroMEC cluster. The steps can of course be adopted for other use cases.

  • Our netboot server (ie. iscsi target server) is called bootserv.

  • The netboot server is available on the LAN and can be pinged using the name bootserv.

  • We refer to the RPi 4B with an id: 0dc0a15d and a name: rpi4-1.

  • We use sudo and start the preparations in /tmp on the netboot server.

Security Note

The setup is meant for a private lab. Security considerations for exposing the rootfs via the LAN are not discussed in this how-to as of now.

Prerequisites

  • A computer running Debian Linux. Any Linux flavor can be used, but our instructions refer to Debian.

  • 15GB free space on the hard drive.

  • Installed packages: tgt, open-iscsi.

  • Fast LAN (preferably Gigabit Ethernet).

Steps

  1. Download a ready made .

The downloaded image has a rootfs which is about 1.5GB large. For MicroMEC we need a rootfs that is 4GB at least. We will need to copy the rootfs from the buster image to a large enough image file.

  1. Extract the downloaded Raspbian Buster lite image

    $ cd /tmp $ mkdir raspbian_buster $ unzip 2020-02-13-raspbian-buster-lite.zip Archive: 2020-02-13-raspbian-buster-lite.zip inflating: 2020-02-13-raspbian-buster-lite.img

  2. Setup a virtual loopback device using the extracted image

    $ sudo losetup -fP 2020-02-13-raspbian-buster-lite.img $ lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT loop0 7:0 0 1.7G 0 loop ├─loop0p1 259:0 0 256M 0 part └─loop0p2 259:1 0 1.5G 0 part ...

  3. Mount the rootfs partition from the extracted image. The rootfs is available via /dev/loop0p2 in our case.

    $ mkdir raspbian_rootfs $ sudo mount /dev/loop0p2 raspbian_rootfs

  4. Create a virtual loop back device that will hold the resized rootfs

    $ cd /tmp $ dd if=/dev/zero of=0dc0a15d-raspbian-rootfs.img bs=400M count=10 $ sudo mkfs.ext4 0dc0a15d-raspbian-rootfs.img $ sudo losetup -fP 0dc0a15d-raspbian-rootfs.img

  5. Check which loopback devices are allocated by the kernel:

    $ losetup -a /dev/loop1: []: (/tmp/0dc0a15d-raspbian-rootfs.img) /dev/loop0: []: (/tmp/2020-02-13-raspbian-buster-lite.img)

  6. Mount the new virtual block device

    $ mkdir 0dc0a15d-rootfs-mount $ sudo mount -o loop /dev/loop1 0dc0a15d-rootfs-mount

  7. Copy the content of the Rasbian Buster rootfs to the mounted block device

    $ sudo cp -R /tmp/raspbian_rootfs/* 0dc0a15d-rootfs-mount/

  8. Unmount the file and move it to the place where it will be served.

    $ sudo umount 0dc0a15d-rootfs-mount $ sudo losetup -D $ sudo mkdir /srv/iscsi $ sudo mv 0dc0a15d-raspbian-rootfs.img /srv/iscsi

  9. Prepare the iscsi target and publish it

    $ sudo tgtadm --lld iscsi --op new --mode target --tid 1 -T iqn.org.micromec:rpi4-1-raspbian-rootfs $ sudo tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 -b /srv/iscsi/0dc0a15d-raspbian-rootfs.img $ sudo tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL

    Note

    If your iscsi server has other targets then you will need to pick a different tid.

    At this point the rootfs is available on the local network.

  10. Save the configuration on the netboot server to remain persistent

    $ sudo tgt-admin --dump | sudo tee /etc/tgt/conf.d/micromec-cluster.conf

Local Testing

  1. Check the iscsi target locally

    Discover the iscsi target

    $ sudo iscsiadm --mode discovery --op update --type sendtargets --portal localhost 127.0.0.1:3260,1 iqn.org.micromec:rpi4-1-raspbian-rootfs

    Login to the iscsi target

    $ sudo iscsiadm -m node --targetname iqn.org.micromec:rpi4-1-raspbian-rootfs -p localhost -l Logging in to [iface: default, target: iqn.org.micromec:rpi4-1-raspbian-rootfs, portal: 127.0.0.1,3260] (multiple) Login to [iface: default, target: iqn.org.micromec:rpi4-1-raspbian-rootfs, portal: 127.0.0.1,3260] successful.

    Check if a new partition appears in the list:

    $ cat /proc/partitions major minor #blocks name ..... 8 32 4096000 sdc

    Mount the partition to a mount point

    $ mkdir /tmp/test-rootfs $ sudo mount /dev/sdc /tmp/test-rootfs $ ls -alrt /tmp/test-rootfs

    Umount the partition

    $ sudo umount /tmp/test-rootfs

    Logout from all iscsi targets

    $ sudo iscsiadm -m node -U all

Remote Testing

  1. Check the iscsi target remotely

    Login to an other Linux computer which also has the open-iscsi tools installed.

    Discover the iscsi target

    $ sudo iscsiadm --mode discovery --op update --type sendtargets --portal bootserv 192.168.4.1:3260,1 iqn.org.micromec:rpi4-1-raspbian-rootfs

    Login to the iscsi target

    $ sudo iscsiadm -m node --targetname iqn.org.micromec:rpi4-1-raspbian-rootfs -p bootserv -l Logging in to [iface: default, target: iqn.org.micromec:rpi4-1-raspbian-rootfs, portal: 192.168.4.1,3260] Login to [iface: default, target: iqn.org.micromec:rpi4-1-raspbian-rootfs, portal: 192.168.4.1,3260] successful.

    Check the available partitions

    $ cat /proc/partitions major minor #blocks name ..... 8 16 4096000 sdb

    Mount the partition to a mount point

    $ mkdir /tmp/test-rootfs $ sudo mount /dev/sdb /tmp/test-rootfs $ ls -alrt /tmp/test-rootfs

    Umount the partition

    $ sudo umount /tmp/test-rootfs

    Logout from all iscsi targets

    $ sudo iscsiadm -m node -U all