Kyvernon

Procédure Pour: administrateurs

iSCSI

Activer l'iSCSI logiciel sur un hôte, ajouter des cibles de découverte et statiques, définir CHAP, réanalyser et créer un datastore sur un LUN.

Un hôte accède au stockage iSCSI par son adaptateur iSCSI logiciel. Vous activez l'adaptateur, indiquez où se trouvent les cibles, réanalysez pour trouver les LUN et créez un datastore sur un LUN. La licence doit inclure la fonctionnalité remote_storage.iscsi, et vous avez besoin du privilège Host.Config.Storage sur l'hôte. Ayez à portée de main les adresses des portails de la baie de stockage, par exemple 198.51.100.10, le nom (IQN) de chaque cible pour les cibles statiques, ainsi que le nom d'utilisateur et le secret CHAP lorsque la baie les exige.

Dans la console

  1. Dans l'inventaire, sélectionnez l'hôte, ouvrez l'onglet Configuration et sélectionnez la zone iSCSI.

    iSCSI logiciel d'un hôte avec la découverte et les cibles statiques (Agrandir)
  2. Activez Initiateur iSCSI logiciel. Tant qu'il est désactivé, la page l'indique et les cibles ainsi que la réanalyse ne sont pas disponibles.
  3. Pour utiliser la découverte dynamique, sélectionnez Ajouter une cible de découverte, saisissez l'adresse du portail, un nom d'hôte ou une adresse IP, et le port, 3260 par défaut, puis sélectionnez Ajouter. L'hôte demande au portail quelles cibles il propose. Le tableau Cibles de découverte dynamique les liste.

  4. Lorsque vous connaissez la cible, sélectionnez plutôt Ajouter une cible statique. Saisissez l'Adresse, le Port et l'Nom de la cible (IQN), qui commence par iqn. ou eui., puis sélectionnez Ajouter.

    Ajouter une cible iSCSI statique (Agrandir)

  5. Lorsque la baie exige CHAP, sélectionnez Modifier CHAP. Sous S’applique à, choisissez l'adaptateur entier ou une cible, activez Utiliser CHAP, saisissez le Nom d’utilisateur et le Secret, et pour un CHAP mutuel, activez Utiliser le CHAP mutuel et saisissez la seconde paire. Sélectionnez Enregistrer. Le contrôleur stocke les secrets et ne les affiche plus jamais. Laissez le secret vide pour conserver celui déjà stocké pour le même nom d'utilisateur.

    Paramètres CHAP de l'adaptateur iSCSI (Agrandir)
  6. Sélectionnez Réanalyser. L'hôte se connecte aux cibles et le tableau LUN vus par l’hôte liste ce qu'il voit : le périphérique, le numéro de LUN, la taille et la cible. Un LUN accessible par plusieurs chemins apparaît une seule fois.
  7. Pour créer le datastore, sélectionnez Ajouter un datastore sous Autres actions de l'hôte, choisissez le type LUN iSCSI, saisissez un nom et choisissez le LUN, puis sélectionnez Ajouter un datastore. Datastores décrit la boîte de dialogue.

Attention

Un LUN vierge reçoit un système de fichiers lors de la création du datastore. Un LUN qui contient déjà d'autres données est refusé. Vérifiez le LUN dans le tableau avant de créer le datastore.

Pour supprimer une cible, sélectionnez Supprimer sur sa ligne et confirmez. L'hôte cesse de l'utiliser, et les datastores situés sur ses LUN deviennent inaccessibles depuis cet hôte. Désactivez l'initiateur avec le même interrupteur qu'à l'étape 2.

Résultat

Après la réanalyse, l'hôte liste les LUN des cibles auxquelles il s'est connecté. Une fois le datastore créé, il apparaît dans l'inventaire avec le type Bloc (iSCSI, FC), et des fichiers peuvent y être stockés.

Automatisation

Avec la CLI

Shell
kyvernon host set-software-iscsi <host> --enabled
kyvernon host add-iscsi-send-targets <host> --address 198.51.100.10
kyvernon host add-iscsi-static-targets <host> --address 198.51.100.10 \
  --iqn iqn.2026-11.com.example:array1.vol1 --port 3260
kyvernon host set-iscsi-auth <host> --chap-enabled --chap-name <user> --chap-secret <secret>
kyvernon host rescan-all-iscsi <host>
kyvernon host vmfs-disks <host>
kyvernon host create-datastore <host> --type vmfs --name san-01 --disk <canonical-name>

<host> est l'identifiant de l'hôte, par exemple host-1. Le port est 3260 lorsque vous l'omettez. set-iscsi-auth accepte aussi --mutual-chap-name et --mutual-chap-secret, et --chap-disabled désactive CHAP de l'adaptateur. rescan-iscsi prend un adaptateur, vmhba64 par défaut. vmfs-disks liste les LUN pouvant contenir un datastore, chacun avec son nom canonique (naa.…), sa capacité, sa cible, son portail et son numéro de LUN ; un LUN à plusieurs chemins affiche son périphérique multipath sous /dev/mapper. vmfs-create-options --device-path <device> affiche les options d'un périphérique, et le datastore se désigne par nom canonique, WWID ou chemin de périphérique. Pour supprimer une cible, utilisez remove-iscsi-send-targets ou remove-iscsi-static-targets avec les options de l'ajout. Pour désactiver l'adaptateur, exécutez set-software-iscsi --disabled.

Avec l'API

OpérationDemande
Activer ou désactiverPUT /v1/hosts/{id}/iscsi/software avec {"enabled": true}
Cibles de découvertePOST ou DELETE /v1/hosts/{id}/iscsi/send-targets avec {"targets": [{"address": "198.51.100.10"}]}
Cibles statiquesPOST ou DELETE /v1/hosts/{id}/iscsi/static-targets avec address, iqn et port par cible
CHAPPUT /v1/hosts/{id}/iscsi/authentication
RéanalysePOST /v1/hosts/{id}/iscsi/rescan (hbaDevice facultatif) et POST /v1/hosts/{id}/iscsi/rescan-all
Lister les LUNGET /v1/hosts/{id}/vmfs-disks, GET /v1/hosts/{id}/vmfs-create-options
Créer le datastorePOST /v1/hosts/{id}/datastores avec type vmfs, name et disk

La demande CHAP prend chapAuthEnabled, chapName, chapSecret, les champs mutuels mutualChapAuthenticationType, mutualChapName et mutualChapSecret, et facultativement un targetSet avec sendTargets et staticTargets pour définir CHAP pour ces seules cibles. Omettez chapSecret pour conserver le secret stocké du même nom.

Version 0.1. Dernière modification : 2026-11-14