Iscsi

De Wiki doc

Le protocole ISCSI permet de partager un disque dur (sous forme physique ou logique) sur le réseau en transportant les commandes SCSI dans des paquets IP. On peut ce servir d'un disque partagé via ISCSI pour démarrer un système Debian ou Windows depuis le réseau, faire des tests ou simplement ajouter un périphérique de stockage sur sa machine.

Dans ce tuto, nous verrons :

  • La mise en place d'un serveur ISCSI
    • Pour Debian Jessie (8.0)
    • Pour Debian Stretch (9.0)
  • La mise en place d'un client ISCSI

Pré-requis :

  • Debian 8 ou 9
  • un périphérique de type bloc (disque dur, SSD , clé USB, fichier image disque...) à partager

Port utilisé :

  • 3260/tcp

Partie serveur

Pour Debian Jessie

Seul la mise en place d'un partage logique (un fichier créé avec dd) sera expliqué, la procédure avec un vrai disque n'étant pas fondamentalement différente.

Installation du paquet

apt update && apt install iscsitarget

Création d'un fichier disque

Création du volume à partager sous forme de fichier à l'aide de dd

dd if=/dev/zero of=fs.iscsi.disk bs=1M count=10000

On peut mettre ce fichier de 10Go dans un répertoire pour pas que ça soit le foutoir

mkdir /root/iscsi && mv fs.iscsi.disk !$

Partage du disque sur le réseau

vim /etc/iet/ietd.conf

Ajouter ceci:

 Target iqn.2017-01:fs.iscsi.disk
	 Lun 0 Path=/root/iscsi/fs.iscsi.disk,Type=fileio

Si on partage une partition de disque dur physique, mettre ça

 Target iqn.2010-01:sdb2
	 Lun 0 Path=/dev/sdb2,Type=fileio

Activation du service

vim /etc/default/iscsitarget
ISCSITARGET_ENABLE=true

Redémarrer le service

/etc/init.d/iscsitarget restart

Afficher le contenu du partage

cat /proc/net/iet/volume

la commande devrait renvoyer ceci

 tid:1 name:iqn.2010-01:sdb2
	 lun:0 state:0 iotype:fileio iomode:wt path:/root/iscsi/fs.iscsi.disk

Pour Debian Stretch

Vous avez trouvé la configuration sous Jessie trop facile ? Rassurez-vous la procédure pour Debian 9 va rattraper le coup en rehaussant artificiellement la difficulté pour je ne sais quelle raison de développeur masochiste (c'est à la mode en ce moment dans le logiciel libre... Systemd; NFTable...). En effet, le merveilleux iscsitarget n'est plus maintenu et il a été viré comme un malpropre des dépôts Stretch. Ce qui suit va être un peut fouillis mais on s'y retrouve.

Installation du paquet

apt install targetcli-fb

Configuration du service

La configuration du service s'effectue via un prompt dédié (c'est également depuis ce dernier que les fichier-disques seront créés).

Une fois dans le shell du service, une arborescence généré à partir d'une représentation du fichier de configuration JSON disponible à /etc/rtslib-fb-target/saveconfig.json permet d'interagir avec les volumes ISCSI.

targetcli

ASTUCE

La commande exit enregistre automatiquement les modifications à la sortie du shell. L'outil enregistre les 10 dernières modifications du fichier à chaque enregistrement dans /etc/rtslib-fb-target/saveconfig.json.

l’arborescence se présente comme ceci:

/> ls
o- / ............................................................................. [...]
  o- backstores .................................................................. [...]
  | o- block ...................................................... [Storage Objects: 0]
  | o- fileio ..................................................... [Storage Objects: 0]
  | o- pscsi ...................................................... [Storage Objects: 0]
  | o- ramdisk .................................................... [Storage Objects: 0]
  o- iscsi ................................................................ [Targets: 0]
  o- loopback ............................................................. [Targets: 0]
  o- vhost ................................................................ [Targets: 0]

Création d'un volume ficher-disque

Vous pouvez utiliser un fichier comme volume ISCSI. Dans ce cas, l'action sera à exécuter dans /backstores/fileio.

/> cd /backstores/fileio
/backstores/fileio> create storage_file /tmp/test.iscsi 32G

Nous pouvons voir dés à présent le changement dans l'arborescence

/backstores/fileio> ls /
o- / ............................................................................. [...]
  o- backstores .................................................................. [...]
  | o- block ...................................................... [Storage Objects: 0]
  | o- fileio ..................................................... [Storage Objects: 1]
  | | o- storage_file ............... [/tmp/test.iscsi (32.0GiB) write-back deactivated]
  | o- pscsi ...................................................... [Storage Objects: 0]
  | o- ramdisk .................................................... [Storage Objects: 0]
  o- iscsi ................................................................ [Targets: 0]
  o- loopback ............................................................. [Targets: 0]
  o- vhost ................................................................ [Targets: 0]

Création d'un volume disque physique

Vous pouvez également utiliser un périphérique physique comme volume ISCSI. Dans ce cas, l'action sera a exécuter dans /backstores/block.

/> cd /backstores/block
/backstores/block> create initiator1 /dev/sdb
Created block storage object initiator1 using /dev/sdb.

Création d'une cible ISCSI

/backstores/fileio> cd /iscsi
/iscsi> create
Created target iqn.2003-01.org.linux-iscsi.debian.x8664:sn.3d2f122e1db9.
Created TPG 1.
Global pref auto_add_default_portal=true
Created default portal listening on all IPs (0.0.0.0), port 3260.

Affectation de l'unité logique à la cible ISCSI

cd iqn.2003-01.org.linux-iscsi.debian.x8664:sn.3d2f122e1db9/tpg1/
/iscsi/iqn.20...122e1db9/tpg1> luns/ create /backstores/fileio/storage_file
Created LUN 0.

Limiter les accès

Par défaut, le service écoute sur toute les adresses IP (toute les interfaces réseau). Si vous voulez limiter ceci, il faut supprimer cette règle par défaut et ajouter la votre.

/iscsi/iqn.20...122e1db9/tpg1> ls                                                       
o- tpg1 .................................................... [no-gen-acls, auth per-acl]
  o- acls .................................................................... [ACLs: 1]
  | o- iqn.1993-08.org.debian:01:fc5ea35ecf4 .............. [1-way auth, Mapped LUNs: 1]
  |   o- mapped_lun0 ................................... [lun0 fileio/storage_file (rw)]
  o- luns .................................................................... [LUNs: 1]
  | o- lun0 .................................... [fileio/storage_file (/tmp/test.iscsi)]
  o- portals .............................................................. [Portals: 1]
    o- 0.0.0.0:3260 ............................................................... [OK]

/iscsi/iqn.20...122e1db9/tpg1> cd portals/
/iscsi/iqn.20.../tpg1/portals> delete 0.0.0.0 ip_port=3260
Deleted network portal 0.0.0.0:3260
/iscsi/iqn.20...122e1db9/tpg1/portals> create 192.168.183.2 3260
Using default IP port 3260
Created network portal 192.168.183.2:3260.
/iscsi/iqn.20...122e1db9/tpg1> ls
o- tpg1 .................................................... [no-gen-acls, auth per-acl]
  o- acls .................................................................... [ACLs: 1]
  | o- iqn.1993-08.org.debian:01:fc5ea35ecf4 .............. [1-way auth, Mapped LUNs: 1]
  |   o- mapped_lun0 ................................... [lun0 fileio/storage_file (rw)]
  o- luns .................................................................... [LUNs: 1]
  | o- lun0 .................................... [fileio/storage_file (/tmp/test.iscsi)]
  o- portals .............................................................. [Portals: 1]
    o- 192.168.183.2:3260 ............................................................ [OK]

Note: 192.168.183.2 est l'adresse IP d'eth0 de mon serveur.

ACL

Par défaut, cette usine à gaz n’accepte rien (on ce demande bien pourquoi d'ailleurs...). Il faut obligatoirement créer une ACL qui corrige ça.

/iscsi/iqn.20...122e1db9/tpg1> acls/ create iqn.1993-08.org.debian:01:fc5ea35ecf4
Created Node ACL for iqn.1993-08.org.debian:01:fc5ea35ecf4
Created mapped LUN 0.

ATTENTION

L'entrée "iqn.1993-08.org.debian:01:fc5ea35ecf4" est le nom de l'initiateur ISCSI et se trouve dans le fichier /etc/iscsi/initiatorname.iscsi.

Ce n'est pas terminé. Par défaut, le service n'autorise que les connexions avec mot de passe. Comme on s'en tape (on pourra en mettre un à la fin si vous voulez), on va virer ça.

/iscsi/iqn.20...122e1db9/tpg1> set attribute authentication=0 demo_mode_write_protect=0
Parameter authentication is now '0'.
Parameter demo_mode_write_protect is now '0'.

Ouf, c'est bon le client peut se connecter. Et bien avouez que c'est quand même plus tiré par les cheveux qu'au bon vieux temps (et tout ça pour exactement le même résultat ! La complexité n'apporte strictement aucun avantages !)

Partie client

Installation des paquets

apt install open-iscsi

Lister les volume en partage sur une IP donnée

iscsiadm -m discovery -t sendtargets -p IP_DU_SERVEUR

Le résultat de la commande doit être celui-ci :

IP_DU_SERVEUR:3260,1 iqn.2010-01:fs.iscsi.disk

Connexion au volume

iscsiadm -m node -T iqn.2010-01:fs.iscsi.disk -p IP_DU_SERVEUR --login

La commande doit renvoyer ceci :

Logging in to [iface: default, target: iqn.2010-01:fs.iscsi.disk, portal: IP_DU_SERVEUR,3260] (multiple)
Login to [iface: default, target: iqn.2010-01:fs.iscsi.disk, portal: IP_DU_SERVEUR,3260] successful

Le log /var/log/messages indique qu'un nouveau disque a été détecté et donne son nom (sur ma VM qui a comme disque principal vda, le volume ISCSI s'appel sda. Il y a des chances pour que sur une machine physique ce soit sdb...)

Il suffit maintenant de créer une table de partition, une partition avec un formatage et de monter cette partition comme s'il s'agissait d'un vrai disque dur, comme expliqué dans notre documentation sur le partitionnement d'un disque dur sous Linux.

Démonter le volume

iscsiadm -m node -T iqn.2010-01:fs.iscsi.disk -p IP_DU_SERVEUR --logout

Sources