Booter iSCSI sous Debian Wheezy

• Pourquoi ?
  • Pour permettre le démarrage directement sur le réseau d'une machine
• Quoi ?
  • Utiliser le protocole iSCSI pour offrir un OS complet sur un périphérique équivalent à un disque
• Quand ?
  • N'importe quand. Seule une demi-heure est nécessaire dans environnement maîtrisé (sous Linux/Debian) pour réaliser cette opération.
• Qui ?
  • N'importe quel administrateur de 2 machines (ayant un minimum de connaissances, notamment pour le copier/coller des commandes suivantes)
• Où ?
  • Sur un réseau local ou distant (un réseau haut débit est préférable, un réseau local également mais iSCSI utilise TCP/IP)
• Combien ?
  • Pour l'hôte de cibles iSCSI ou pour le client, n'importe quelle machine suffit, du moment que la machine cliente peut démarrer en PXE
• Comment ?
  • C'est ce que nous allons voir

Le protocole iSCSI permet à un hôte d'offrir un espace disque (du mode bloc) à un hôte distant.

Linux/Debian intègre dans la Wheezy (version 7) tout ce qui permet d'accéder à des volumes iSCSI ou de les créer.

• Open-ISCSI pour accéder à des ressources offertes en iSCSI
• iSCSItarget pour offrir des targets iSCSI avec un module noyau
• TGT pour offrir des targets iSCSI sans module noyau

De mon expérience (près de 5 ans sur iSCSItarget et un 1 et demi mois sur TGT), j'aurai tendance à préférer iSCSItarget. Le principal avantage de TGT réside dans son absence de module noyau et donc facile implantation sur un serveur, mais il a un problème de taille : impossible de retirer un volume déclaré !

• une machine portant les “cibles” iSCSI, appelée MyHost
  • elle dispose d'un espace disque disponible en mode bloc (fichiers, disques, volumes)
  • elle a installé une implémentation de cibles iSCSI
• une machine portant un serveur TFTP avec les images PXE, appelée MyPXE
• une machine pouvant démarrer en PXE, d'adresse MAC simplement 00:AA:BB:CC:DD:EE, disposant d'une IP fournie par DHCP

Il est supposé que la machine MyHost dispose d'une infrastructure LVM :

• son VG est MyVG
• le nom du LV à créer est MyLViSCSI

• Création du volume LVM de 20G sur le VG Raid6

  lvcreate -L 20G -n MyLViSCSI MyVG

• Formatage en Ext3

  mkfs.ext3 -m 0 /dev/MyVG/MyLViSCSI

• Montage du volume sur le système hôte

  mkdir /media/MyLViSCSI
  mount -o noatime /dev/MyVG/MyLViSCSI /media/MyLViSCSI

• Etablissement d'un label sur la partition

  e2label /dev/MyVG/MyLViSCSI MyLViSCSI

• Installation au besoin de debootstrap

  apt-get install debootstrap

• Installation du système de base Wheezy, architecture x86_64 ou i386

  # pour une architecture x86_64
  debootstrap --arch amd64 wheezy /media/MyLViSCSI http://ftp.fr.debian.org/debian
  # pour une architecture i386
  debootstrap --arch i386 wheezy /media/MyLViSCSI http://ftp.fr.debian.org/debian

• Passage dans l'environnement

  chroot /media/MyLViSCSI

• Création d'une nouvelle liste de paquets

  tee /etc/apt/sources.list <<EOF
  deb http://ftp.fr.debian.org/debian/ wheezy main contrib non-free
  deb-src http://ftp.fr.debian.org/debian/ sid main contrib non-free
  deb-src http://ftp.fr.debian.org/debian/ experimental main contrib non-free
  deb http://security.debian.org/ wheezy/updates main contrib non-free
  deb-src http://security.debian.org/ wheezy/updates main contrib non-free
  EOF

• Mise à jour de la base des paquets :

  apt-get update

• Montage du /proc pendant l'installation

  mount -t proc none /proc

• Initialisation du mot de passe superutilisateur

  echo "root:MyStrongPassword" | chpasswd

• Installation de paquets nécessaires

  apt-get -y install dhcp3-common openssh-server locales initramfs-tools dhcp3-client aufs-tools firmware-linux-nonfree firmware-linux firmware-bnx2 open-iscsi iftop htop iotop emacs mtr lsof tshark mbw memtest86 cpuburn bonnie dbench iozone3 console-setup less && apt-get clean
  # Pour les architectures i686
  apt-get -y install linux-image-3.2.0-4-686-pae
  # Pour les architectures x86_64
  apt-get -y install linux-image-3.2.0-4-amd64

• Purge des archives de paquets :

  apt-get clean

• Suppression du démarrage du démon iSCSI (en noyau 3.2, le script plante et empêche le démarrage)

  insserv -r open-iscsi

• Paramétrage d'un boot iSCSI

  touch /etc/iscsi/iscsi.initramfs
  update-initramfs -k all -u

• Vérification de la présence du support iSCSI lsinitramfs /boot/initrd.img-* | grep “local-top/iscsi” retourne :

  scripts/local-top/iscsi
  scripts/local-top/iscsi

• Paramétrage de l'interface de démarrage iSCSI<note important>En cas d'interfaces multiples, il est INDISPENSABLE de préciser l'interface de démarrage, sinon…</note>

  sed -i "s/DEVICE\=/DEVICE\=eth0/g" /etc/initramfs-tools/initramfs.conf

• Suppression du hostname pour le paramétrage automatique du HOST

  rm /etc/hostname

• Définition de l'interface de loopback

  tee /etc/network/interfaces <<EOF
  auto lo
  iface lo inet loopback
  EOF

• Démontage du /proc

  umount /proc

• Sortie de l'environnement chrooté

  exit

• Arrêt des services démarrés à l'installation

  lsof | grep /media/MyLViSCSI | awk '{ print $2 }' | sort -u | xargs -I '{}' kill '{}' 

• Copie des composants pour le PXE

  cp /media/MyLViSCSI/boot/initrd.img-3.2.0-4-686-pae /root/initrd.img-3.2.0-4-686-pae-iSCSI
  cp /media/MyLViSCSI/boot/vmlinuz-3.2.0-4-686-pae /root/vmlinuz-3.2.0-4-686-pae-iSCSI
  cp /media/MyLViSCSI/boot/initrd.img-3.2.0-4-amd64 /root/initrd.img-3.2.0-4-amd64-iSCSI
  cp /media/MyLViSCSI/boot/vmlinuz-3.2.0-4-amd64 /root/vmlinuz-3.2.0-4-amd64-iSCSI

• Copie des clés autorisées

  mkdir /media/MyLViSCSI/root/.ssh
  cp -a /root/.ssh/authorized_keys /media/MyLViSCSI/root/.ssh/

• Démontage de la partition

  umount /media/MyLViSCSI

• Copie des composants de démarrage sur le serveur PXE

  # Le serveur TFTP/PXE est MyPXE :
  scp /root/*iSCSI PyPXE:/srv/tftp

• Création d'un partage iSCSI nécessitant les paramètres
  • IQN (pour iSCSI Qualified Name) : iqn.2012-04.MySite.MyHost:MyLViSCSI
  • identifiant : inputname
  • mot de passe : MyInputPwd
  • chemin : /dev/MyVG/MyLViSCSI
• Paramétrage de la cible IET

  # Renommage de l'ancien fichier de configuration
  cp /etc/iet/ietd.conf /etc/iet/ietd.conf-$(date +%Y%m%d)
  # Ajout de l'entree précedente
  tee -a /etc/iet/ietd.conf <<EOF
  Target iqn.2013-06.MySite.MyHost:MyLViSCSI
  	IncomingUser inputname MyInputPwd
  	Lun 0 Path=/dev/MyVG/MyLViSCSI,BlockSize=4096,Type=fileio
  EOF

• Activation des partages

  ietadm --op new --tid=100 --params Name=iqn.2013-06.MySite.MyHost:MyLViSCSI
  ietadm --op new --tid=100 --lun=0 --params Path=/dev/MyVG/MyLViSCSI,BlockSize=4096,Type=fileio
  ietadm --op new --tid=100 --lun=0 --user --params IncomingUser=inputname,Password=MyInputPwd

• Vérification des partages par la commande cat /proc/net/iet/volume | grep MyLViSCSI

  cat /proc/net/iet/volume  | grep MyLViSCSI
  tid:86 name:iqn.2013-03.MySite.MyHost:MyLViSCSI
  	lun:0 state:0 iotype:fileio iomode:wt blocks:5242880 blocksize:4096 path:/dev/MyVG/MyLViSCSI

• Déplacement dans le dossier de configuration TFTP, anciennement /srv/tftp, maintenant

  cd /srv/tftp/pxelinux.cfg

• Déclaration de l'entrée TFTP pour notre entrée
  • ISCSI_TARGET_NAME : IQN
  • ISCSI_TARGET_IP : hôte de cibles iSCSI
  • ISCSI_INITIATOR : IQN
  • ISCSI_USERNAME : identifiant
  • ISCSI_PASSWORD : mot de passe
  • ISCSI_TARGET_GROUP : groupe, généralement 1

    tee iscsi <<EOF
    DEFAULT linux64
    
    LABEL linux64
    KERNEL vmlinuz-3.2.0-4-amd64-iSCSI
    APPEND console=tty1 initrd=initrd.img-3.2.0-4-amd64-iSCSI ip=dhcp rw ISCSI_TARGET_NAME=iqn.2013-06.MySite.MyHost:MyLViSCSI ISCSI_TARGET_IP=MyHost ISCSI_INITIATOR=iqn.2013-06.MySite.MyHost:default ISCSI_USERNAME=inputname ISCSI_TARGET_GROUP=1 ISCSI_PASSWORD=MyInputPwd root=LABEL=MyLViSCSI rootflags=data=journal
    
    LABEL linux32
    KERNEL vmlinuz-3.2.0-4-686-pae-iSCSI
    APPEND console=tty1 initrd=initrd.img-3.2.0-4-686-pae-iSCSI ip=dhcp rw ISCSI_TARGET_NAME=iqn.2013-06.MySite.MyHost:MyLViSCSI ISCSI_TARGET_IP=MyHost ISCSI_INITIATOR=iqn.2013-06.MySite.MyHost:default ISCSI_USERNAME=inputname ISCSI_TARGET_GROUP=1 ISCSI_PASSWORD=MyInputPwd root=LABEL=MyLViSCSI rootflags=data=journal
    EOF

• Création des liens pour chaque machine spécifique. Ll'adresse MAC de la forme : 00:AA:BB:CC:DD:EE doit être écrite sous la forme 01-00-aa-bb-cc-dd-ee en MINUSCULE !

  ln -sf iscsi 01-00-aa-bb-cc-dd-ee

— Emmanuel Quemener 2013/06/13 06:05