Proxmox Backup Server

Setup ISCSI for PBS

Documentation complète et claire pour configurer un LUN iSCSI de 75 Go sur un serveur TrueNAS avec un client Linux, en utilisant le système de fichiers XFS. Cette documentation couvre toutes les étapes effectuées, de la configuration sur TrueNAS à l'intégration sur le client Linux, incluant le dépannage et les vérifications. Elle est structurée pour être facile à suivre et réutilisable.

---

Configuration d’un LUN iSCSI de 75 Go sur TrueNAS avec un client Linux

Introduction

Cette documentation décrit comment configurer un LUN iSCSI de 75 Go sur un serveur TrueNAS, le connecter à un client Linux (Debian/Ubuntu) avec authentification CHAP, formater le disque en XFS, et le rendre utilisable avec un montage automatique. Le processus inclut la configuration du serveur TrueNAS, la connexion du client, le formatage du disque, et les vérifications nécessaires.

• Serveur TrueNAS : Adresse IP 192.168.2.20, port iSCSI 3260.

• Client Linux : Debian/Ubuntu avec open-iscsi installé.

• Taille du LUN : 75 Go.

• Système de fichiers : XFS.

• Authentification : CHAP avec utilisateur pbs et mot de passe skyfik123456.

---

Prérequis

• TrueNAS :

  • Accès à l’interface web (http://192.168.2.20).

  • Un pool de stockage avec au moins 75 Go d’espace disponible (ici, pool PBS_BACKUP avec 95.34 GiB disponibles).

  • Service iSCSI activé.

• Client Linux :

  • Paquet open-iscsi installé (dpkg -l | grep iscsi pour vérifier).

  • Accès réseau au serveur TrueNAS (port 3260 ouvert).

  • Droits root pour exécuter les commandes.

---

Étape 1 : Configuration sur TrueNAS

1.1 Créer un zvol pour le LUN

Le LUN iSCSI est basé sur un zvol (volume ZFS) dans le pool PBS_BACKUP.

1. Accéder à l’interface TrueNAS :

   • Connectez-vous à http://192.168.2.20.

   • Allez dans Stockage > Pools.

2. Créer ou vérifier le zvol :

   • Naviguez jusqu’au pool PBS_BACKUP.

   • Créez un zvol nommé PBS_BACKUP/PBS_BACKUP/pbs (ou vérifiez s’il existe) :

     • Cliquez sur les trois points du pool PBS_BACKUP > Ajouter Zvol.

     • Nom : pbs.

     • Taille : 75G (75 GiB).

     • Compression : LZ4 (par défaut, hérité du dataset parent).

     • Sauvegardez.

   • Vérifiez la taille via la console TrueNAS :

     zfs get volsize PBS_BACKUP/PBS_BACKUP/pbs

     Sortie attendue :

     NAME                      PROPERTY  VALUE    SOURCE
     PBS_BACKUP/PBS_BACKUP/pbs volsize   75G      local

1.2 Configurer l’étendue iSCSI

L’étendue lie le zvol au service iSCSI.

1. Allez dans Partage > iSCSI > Étendues > Ajouter.

2. Configurez l’étendue :

   • Nom : pbs.

   • Type d’étendue : Device.

   • Périphérique : Sélectionnez PBS_BACKUP/PBS_BACKUP/pbs.

   • Taille du bloc logique : 512.

   • Activé : Coché.

   • RPM LUN : SSD (ou selon votre matériel).

   • Sauvegardez.

1.3 Configurer l’accès autorisé (CHAP)

L’authentification CHAP sécurise l’accès au LUN.

1. Allez dans Partage > iSCSI > Accès autorisé > Ajouter.

2. Configurez :

   • Utilisateur : pbs.

   • Secret : mot-de-passe-12-caractère-au-moins.

   • Méthode d’authentification : CHAP.

   • ID de groupe : 1.

   • Discovery Authentication : CHAP (pour activer l’authentification lors de la découverte).

   • Sauvegardez.

1.4 Configurer la cible iSCSI

La cible définit l’accès au LUN.

1. Allez dans Partage > iSCSI > Cibles > Ajouter.

2. Configurez :

   • Nom de la cible : pbs.

   • ID de groupe du portail : 1 (lié à 192.168.2.20:3260).

   • Méthode d’authentification : CHAP.

   • Numéro du groupe d’authentification : 1.

   • ID de groupe de l’initiateur : 3 (ALL Initiators Allowed). ( ou spécifier l'iq du PBS avec cat /etc/iscsi/initiatorname.iscsi)

   • Sauvegardez.

3. Associez l’étendue à la cible :

   • Dans Cibles > pbs > Associated Targets > Ajouter.

   • Sélectionnez l’étendue pbs.

   • Sauvegardez.

1.5 Configurer le portail iSCSI

Le portail définit l’adresse et le port d’écoute.

1. Allez dans Partage > iSCSI > Portails > Ajouter.

2. Configurez :

   • ID de groupe du portail : 1.

   • Écouter : 192.168.2.20:3260.

   • Description : pbs.

   • Sauvegardez.

1.6 Activer le service iSCSI

1. Allez dans Services > iSCSI.

2. Cochez Activé et configurez pour démarrer automatiquement.

3. Redémarrez le service si des modifications ont été apportées.

---

Étape 2 : Configuration sur le client Linux

2.1 Installer open-iscsi

Vérifiez que open-iscsi est installé :

dpkg -l | grep iscsi

Sortie attendue :

ii  libopeniscsiusr  2.1.8-1  amd64  iSCSI userspace library
ii  open-iscsi       2.1.8-1  amd64  iSCSI initiator tools

Si non installé, installez-le :

apt update
apt install open-iscsi

Activez et démarrez le service iscsid :

systemctl enable iscsid
systemctl start iscsid

2.2 Configurer l’authentification CHAP

Modifiez le fichier de configuration /etc/iscsi/iscsid.conf pour activer CHAP pour la découverte et la session.

1. Ouvrez le fichier :

   nano /etc/iscsi/iscsid.conf

2. Configurez les paramètres suivants :

Le mot est celui défini sur le truenas

node.session.auth.authmethod = CHAP
node.session.auth.username = pbs
node.session.auth.password = mot-de-passe-12-caractère-au-moins
discovery.sendtargets.auth.authmethod = CHAP
discovery.sendtargets.auth.username = pbs
discovery.sendtargets.auth.password = mot-de-passe-12-caractère-au-moins

1. Sauvegardez et redémarrez le service :

systemctl restart iscsid

2.3 Découvrir la cible iSCSI

Découvrez la cible iSCSI sur le serveur TrueNAS :

iscsiadm -m discovery -t sendtargets -p 192.168.2.20:3260

Sortie attendue : ( un une info spécifiant un iqn )

192.168.2.20:3260,1 iqn.2005-10.org.freenas.ctl:pbs

2.4 Se connecter à la cible

Connectez-vous à la cible iSCSI :

iscsiadm -m node -T iqn.2005-10.org.freenas.ctl:pbs -p 192.168.2.20:3260 --login

Sortie attendue :

Logging in to [iface: default, target: iqn.2005-10.org.freenas.ctl:pbs, portal: 192.168.2.20,3260]
Login to [iface: default, target: iqn.2005-10.org.freenas.ctl:pbs, portal: 192.168.2.20,3260] successful.

2.5 Vérifier le disque

Vérifiez que le LUN apparaît comme un disque de 75 Go :

lsblk

Sortie attendue :

NAME         MAJ:MIN RM  SIZE RO TYPE MOUNTPOINTS
sdb            8:16   0   75G  0 disk

---

Étape 3 : Formater et monter le disque

3.1 Vérifier le système de fichiers

Vérifiez si le disque a un système de fichiers :

lsblk -f
blkid /dev/sdb

Si la colonne FSTYPE est vide ou si blkid ne retourne rien, le disque n’est pas formaté.

3.2 Formater le disque en XFS

Formatez le disque en XFS ( bon les saubegardes volumineuses ) :

mkfs.xfs /dev/sdb

Sortie attendue :

meta-data=/dev/sdb               isize=512    agcount=4, agsize=4915200 blks
         =                       sectsz=512   attr=2, projid32bit=1
         =                       crc=1        finobt=1, sparse=1, rmapbt=0
         =                       reflink=1    bigtime=1 inobtcount=1 nrext64=0
data     =                       bsize=4096   blocks=19660800, imaxpct=25
         =                       sunit=0      swidth=0 blks
naming   =version 2              bsize=4096   ascii-ci=0, ftype=1
log      =internal log           bsize=4096   blocks=16384, version=2
         =                       sectsz=512   sunit=0 blks, lazy-count=1
realtime =none                   extsz=4096   blocks=0, rtextents=0
Discarding blocks...Done.

3.3 Créer un point de montage

Créez un répertoire pour monter le disque :

mkdir /mnt/iscsi

3.4 Monter le disque

Montez le disque XFS :

mount /dev/sdb /mnt/iscsi

3.5 Vérifier le montage

Vérifiez la taille et le type de système de fichiers :

df -h /mnt/iscsi
lsblk -f

Sortie attendue :

Filesystem      Size  Used Avail Use% Mounted on
/dev/sdb         75G   33M   75G   1% /mnt/iscsi

NAME         FSTYPE  FSVER  LABEL UUID                                   FSAVAIL FSUSE% MOUNTPOINTS
sdb          xfs            xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx    75G     1% /mnt/iscsi

---

Étape 4 : Configurer le montage et la connexion automatique

4.1 Configurer le montage automatique

Ajoutez une entrée dans /etc/fstab pour monter le disque au démarrage :

nano /etc/fstab

Ajoutez :

/dev/sdb /mnt/iscsi xfs defaults,_netdev 0 0

4.2 Configurer la connexion iSCSI automatique

Configurez le nœud iSCSI pour une connexion automatique :

iscsiadm -m node -T iqn.2005-10.org.freenas.ctl:pbs -p 192.168.2.20:3260 -o update -n node.startup -v automatic

4.3 Tester la configuration

Redémarrez le système pour vérifier l’automatisation :

reboot

Après le redémarrage, vérifiez :

lsblk -f
df -h /mnt/iscsi

---

Étape 5 : Dépannage

5.1 Problèmes d’authentification CHAP

Si la découverte ou la connexion échoue avec une erreur comme initiator failed authorization :

• Vérifiez que les identifiants CHAP (pbs/skyfik123456) sont identiques dans :

  • /etc/iscsi/iscsid.conf (client).

  • Accès autorisé dans TrueNAS.

• Assurez-vous que discovery.sendtargets.auth.* est configuré dans /etc/iscsi/iscsid.conf :

  discovery.sendtargets.auth.authmethod = CHAP
  discovery.sendtargets.auth.username = pbs
  discovery.sendtargets.auth.password = mot-de-passe-12-caractère-au-moins

5.2 Taille du disque incorrecte

Si /dev/sdb n’affiche pas 75 Go :

• Vérifiez la taille du zvol sur TrueNAS :

  zfs get volsize PBS_BACKUP/PBS_BACKUP/pbs

• Forcez une rescanne SCSI sur le client :

  echo "- - -" > /sys/class/scsi_host/hostX/scan

  Trouvez hostX avec :

  ls /sys/class/scsi_host/

5.3 Problèmes de montage

Si le montage échoue :

• Vérifiez les journaux :

  • Client Linux :

    journalctl -u iscsid
    tail -f /var/log/syslog

  • TrueNAS :

    tail -f /var/log/messages

• Assurez-vous que les outils XFS sont installés :

  apt install xfsprogs

5.4 Vérifier l’intégrité du système de fichiers XFS

Si des problèmes surviennent avec XFS :

xfs_repair /dev/sdb

---

Étape 6 : Notes sur XFS et recommandations

• Avantages de XFS :

  • Performances élevées pour les gros fichiers et les charges de travail intensives (idéal pour les sauvegardes).

  • Supporte les volumes jusqu’à 8 exaoctets.

• Limitations :

  • XFS ne peut pas être réduit (uniquement agrandi avec xfs_growfs).

  • Moins flexible que ext4 pour certains cas d’usage.

• Optimisation :

  • Si vous utilisez le LUN pour des sauvegardes, envisagez des options de montage comme noatime dans /etc/fstab pour réduire les écritures inutiles :

    /dev/sdb /mnt/iscsi xfs defaults,_netdev,noatime 0 0

---

Résumé

• TrueNAS :

  • Zvol PBS_BACKUP/PBS_BACKUP/pbs créé avec une taille de 75 Go.

  • Étendue, cible, et portail iSCSI configurés avec authentification CHAP (pbs/skyfik123456).

• Client Linux :

  • open-iscsi configuré avec CHAP pour la découverte et la session.

  • LUN connecté comme /dev/sdb (75 Go).

  • Disque formaté en XFS avec mkfs.xfs.

  • Montage configuré sur /mnt/iscsi avec option automatique dans /etc/fstab.

  • Connexion iSCSI automatique activée.

• Vérifications :

  • Taille correcte confirmée avec lsblk.

  • Système de fichiers XFS vérifié avec lsblk -f et blkid.

---

Annexe : Commandes utiles

• Vérifier le système de fichiers :

  lsblk -f
  blkid /dev/sdb

• Redimensionner XFS (si le zvol est agrandi) :

  xfs_growfs /mnt/iscsi

• Vérifier l’espace du pool TrueNAS :

  zpool list PBS_BACKUP

---

Cette documentation devrait vous permettre de reproduire ou maintenir la configuration.