Avant de commencer

Si plusieurs hôtes montent le même volume Block Storage for Classic sans être gérés de manière coopérative, vos données risquent d'être endommagées. La corruption de volume peut se produire si des modifications sont apportées au volume par plusieurs hôtes en même temps. Vous avez besoin d'un système de fichiers à disque partagé compatible avec les clusters pour éviter les pertes de données, tel que Microsoft Cluster Shared Volumes ( CSV ), Red Hat Global File System ( GFS2 ), VMware® VMFS, et d'autres. Pour plus d'informations, consultez la documentation de votre système d'exploitation.

Il est recommandé d'exécuter le trafic de stockage sur un réseau local virtuel (VLAN) qui ignore le pare-feu. L'exécution du trafic de stockage via des pare-feux logiciels augmente le temps d'attente et a un impact négatif sur les performances de stockage. Pour plus d'informations sur le routage du trafic de stockage vers sa propre interface VLAN, voir FAQ (Foire aux questions).

Avant de commencer, assurez-vous que l'hôte qui doit accéder au volume « Block Storage for Classic » est autorisé. Pour plus d'informations, voir Autoriser l'hôte dans la console Autoriser l'hôte depuis la CLI Autoriser l'hôte avec Terraform.

Installez les utilitaires iSCSI et multi-accès.

Assurez-vous que votre système est à jour et qu'il comprend les paquets iscsi-initiator-utils et device-mapper-multipath.

1. Utilisez la commande suivante pour installer les packages.

   dnf install iscsi-initiator-utils device-mapper-multipath
   

2. Démarrez les services.

   chkconfig multipathd on
   

   chkconfig iscsid on
   

Configurez le multi-accès

Vous configurez DM Multipath à l'aide de l'utilitaire mpathconf , qui crée le fichier de configuration multipath /etc/multipath.conf``.

• Si le fichier /etc/multipath.conf existe, l'utilitaire mpathconf peut le modifier.
• Si le fichier /etc/multipath.conf n'existe pas, l'utilitaire mpathconf crée le fichier /etc/multipath.conf.

1. Tapez la commande « mpathconf » avec l'option « --enable ».

   # mpathconf --enable --user_friendly_names n
   

2. Modifiez le fichier /etc/multipath.conf en y indiquant la configuration minimale suivante.

   defaults {
   user_friendly_names no
   max_fds max
   flush_on_last_del yes
   queue_without_daemon no
   dev_loss_tmo infinity
   fast_io_fail_tmo 5
   }
   # All data in the following section must be specific to your system.
   blacklist {
   wwid "SAdaptec*"
   devnode "^hd[a-z]"
   devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
   devnode "^cciss.*"
   }
   devices {
   device {
   vendor "NETAPP"
   product "LUN"
   path_grouping_policy group_by_prio
   features "2 pg_init_retries 50"
   no_path_retry queue
   prio "alua"
   path_checker tur
   failback immediate
   path_selector "round-robin 0"
   hardware_handler "1 alua"
   rr_weight uniform
   rr_min_io 128
   }
   

La section « initial defaults » du fichier de configuration permet de configurer votre système de manière à ce que les noms des périphériques multipath se présentent sous la forme /dev/mapper/mpath n, où mpath n correspond au WWID (World Wide Identifier) du périphérique.

3. Enregistrez le fichier de configuration et quittez l'éditeur, si nécessaire.

4. Exécutez la commande suivante :

   # systemctl start multipathd.service
   

   Si vous devez modifier le fichier de configuration multipath après avoir démarré le démon multipath, vous devez exécuter la commande « systemctl reload multipathd.service » pour que les modifications prennent effet.

Mettez à jour le fichier /etc/iscsi/initiatorname.iscsi

Mettez à jour le fichier /etc/iscsi/initiatorname.iscsi en y indiquant l'IQN obtenu depuis la console IBM Cloud®. Saisissez la valeur en minuscules.

InitiatorName=<value-from-the-Portal>

Configurer les données d'identification

Modifiez les paramètres suivants dans /etc/iscsi/iscsid.conf en utilisant le nom d'utilisateur et le mot de passe de la console IBM Cloud®. Utilisez des majuscules pour les noms CHAP (Challenge-Handshake Authentication Protocol).

node.session.auth.authmethod = CHAP
node.session.auth.username = <Username-value-from-Portal>
node.session.auth.password = <Password-value-from-Portal>
discovery.sendtargets.auth.authmethod = CHAP
discovery.sendtargets.auth.username = <Username-value-from-Portal>
discovery.sendtargets.auth.password = <Password-value-from-Portal>

Laissez les autres paramètres CHAP commentés. Le stockage « IBM Cloud® » utilise uniquement l'authentification unidirectionnelle. N'activez pas l'authentification CHAP mutuelle.

Reconnaissez le périphérique de stockage et connectez-vous.

L'utilitaire iscsiadm est un outil en ligne de commande qui facilite la détection et la connexion aux cibles d' iSCSI, ainsi que l'accès et la gestion de la base de données open-iscsi. Lors de cette étape, reconnaissez le périphérique à l'aide de l'adresse IP cible obtenue à partir de la console IBM Cloud® .

1. Exécutez la reconnaissance sur la grappe iSCSI.

   Block Storage for Classic nécessite une détection dynamique des cibles utilisant la méthode SendTargets. N'utilisez pas la configuration statique des nœuds, car elle n'est pas évolutive et peut entraîner des problèmes de connectivité lorsque des modifications sont apportées au stockage (comme l'autorisation ou la désautorisation d'accès des hôtes aux LUN). La découverte dynamique garantit que votre hôte détecte automatiquement toute modification apportée aux portails cibles.

   iscsiadm -m discovery -t sendtargets -p <ip-value-from-IBM-Cloud-console>
   

   Si les informations d'IP et les détails d'accès sont affichés, la reconnaissance est réussie.

2. Connectez-vous à la grappe iSCSI.

   iscsiadm -m node --login
   

Vérification de la configuration

1. Validez la création de la session iSCSI.

   iscsiadm -m session -o show
   

2. Validez l'existance de plusieurs chemins.

   multipath -l
   

   Cette commande affiche les chemins d'accès. Si la configuration est correcte, chaque volume comporte un seul groupe, avec un nombre de chemins d'accès égal au nombre de sessions d' iSCSI. Il est possible de monter un volume en utilisant un seul chemin d'accès, mais il est important que les connexions soient établies sur les deux chemins afin d'éviter toute interruption de service.

   Si MPIO n'est pas configuré correctement, votre périphérique de stockage peut se déconnecter et apparaître comme étant hors ligne en cas de panne réseau ou de maintenance par les équipes d'IBM Cloud®. MPIO offre un niveau supplémentaire de connectivité lors de ces événements et maintient une session établie avec le volume grâce à des opérations de lecture/écriture actives.

3. Répertoriez les tables de partition pour le périphérique connecté.

   fdisk -l | grep /dev/mapper
   

   Par défaut, l'unité de stockage se connecte à /dev/mapper/<wwid>. L'ID WWID est persistant tant que le volume existe. La commande génère une sortie semblable à l'exemple ci-après.

   Disk /dev/mapper/3600a0980383030523424457a4a695266: 73.0 GB, 73023881216 bytes
   

   Dans cet exemple, la chaîne « 3600a0980383030523424457a4a695266 » correspond au WWID. Votre application doit utiliser le WWID. Il est également possible d'attribuer des noms plus faciles à lire en utilisant les mots-clés « user_friendly_names » ou « alias » dans multipath.conf.

   Le volume est maintenant monté et accessible sur l'hôte. Vous pouvez créer ensuite un système de fichiers.

Création d'un système de fichiers (facultatif)

Procédez comme indiqué ci-après pour créer un système de fichiers sur le volume récemment monté. Un système de fichiers est nécessaire pour permettre à la plupart des applications d'utiliser le volume. Utilisez fdisk pour les unités inférieures à 2 To et parted pour un disque supérieur à 2 To.

# dnf install parted

Démontage de volumes Block Storage for Classic

Lorsque vous n'avez plus besoin du volume, démontez-le avant de le supprimer.

1. Démontez le système de fichiers.

   umount /dev/mapper/XXXp1 /PerfDisk
   

2. Si vous n'avez pas d'autre volumes dans ce portail cible, vous pouvez vous déconnecter de la cible.

   iscsiadm -m node -t <TARGET NAME> -p <PORTAL IP:PORT> --logout
   

3. Si vous n'avez pas d'autre volumes dans ce portail cible, supprimez l'enregistrement de portail cible pour empêcher les futures tentatives de connexion.

   iscsiadm -m node -o delete -t <TARGET IQN> -p <PORTAL IP:PORT>