Kyvernon

Werkwijze Voor: beheerders

iSCSI

Schakel software-iSCSI in op een host, voeg discovery- en statische targets toe, stel CHAP in, voer een rescan uit en maak een datastore op een LUN.

Een host bereikt iSCSI-opslag via zijn software-iSCSI-adapter. U schakelt de adapter in, geeft aan waar de targets zijn, voert een rescan uit om de LUN's te vinden en maakt een datastore op een LUN. De licentie moet de functie remote_storage.iscsi bevatten, en u hebt de bevoegdheid Host.Config.Storage op de host nodig. Houd de adressen van de portals van de opslagarray bij de hand, bijvoorbeeld 198.51.100.10, de naam (IQN) van elk target voor statische targets, en de CHAP-gebruikersnaam en het CHAP-geheim wanneer de array erom vraagt.

In de console

  1. Selecteer in de inventaris de host, open het tabblad Configureren en selecteer het gebied iSCSI.

    Software-iSCSI van een host met detectie en statische doelen (Groter weergeven)
  2. Schakel Software-iSCSI-initiator in. Zolang de adapter uit staat, meldt de pagina dat en zijn de targets en de rescan niet beschikbaar.
  3. Om dynamische discovery te gebruiken, selecteert u Detectietarget toevoegen, voert u het adres van de portal in, een hostnaam of een IP-adres, en de poort, standaard 3260, en selecteert u Toevoegen. De host vraagt de portal welke targets die aanbiedt. De tabel Targets voor dynamische detectie toont ze.

  4. Als u het target kent, selecteert u in plaats daarvan Statische target toevoegen. Voer het Adres, de Poort en de Targetnaam (IQN) in, die met iqn. of eui. begint, en selecteer Toevoegen.

    Een statisch iSCSI-doel toevoegen (Groter weergeven)

  5. Als de array CHAP nodig heeft, selecteert u CHAP bewerken. Kies onder Geldt voor de hele adapter of één target, schakel CHAP gebruiken in, voer de Gebruikersnaam en het Geheim in, en schakel voor wederzijdse CHAP Wederzijdse CHAP gebruiken in en voer het tweede paar in. Selecteer Opslaan. De controller bewaart de geheimen en toont ze nooit meer. Laat het geheim leeg om het opgeslagen geheim van dezelfde gebruikersnaam te behouden.

    CHAP-instellingen van de iSCSI-adapter (Groter weergeven)
  6. Selecteer Opnieuw scannen. De host meldt zich aan bij de targets en de tabel LUN's die de host ziet toont wat hij ziet: het apparaat, het LUN-nummer, de grootte en het target. Een LUN met meerdere paden verschijnt één keer.
  7. Om de datastore te maken, selecteert u Datastore toevoegen onder Meer acties van de host, kiest u het type iSCSI-LUN, voert u een naam in en kiest u de LUN, en selecteert u Datastore toevoegen. Datastores beschrijft het dialoogvenster.

Waarschuwing

Een lege LUN krijgt een bestandssysteem wanneer de datastore wordt gemaakt. Een LUN die al andere gegevens bevat, wordt geweigerd. Controleer de LUN in de tabel voordat u de datastore maakt.

Om een target te verwijderen, selecteert u Verwijderen op de rij en bevestigt u. De host gebruikt het niet langer, en datastores op de LUN's ervan worden onbereikbaar vanaf deze host. Schakel de initiator uit met dezelfde schakelaar als in stap 2.

Resultaat

Na de rescan toont de host de LUN's van de targets waarbij hij zich heeft aangemeld. Nadat de datastore is gemaakt, verschijnt hij in de inventaris met het type Blok (iSCSI, FC), en kunnen er bestanden op worden opgeslagen.

Automatisering

Met de 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> is de identifier van de host, zoals host-1. De poort is 3260 als u hem weglaat. set-iscsi-auth neemt ook --mutual-chap-name en --mutual-chap-secret, en --chap-disabled wist CHAP van de adapter. rescan-iscsi neemt één adapter, standaard vmhba64. vmfs-disks toont de LUN's die een datastore kunnen bevatten, elk met zijn canonieke naam (naa.…), capaciteit, target, portal en LUN-nummer; een LUN met meerdere paden toont zijn multipath-apparaat onder /dev/mapper. vmfs-create-options --device-path <device> toont de opties voor één apparaat, en de datastore wordt aangeduid met canonieke naam, WWID of apparaatpad. Om een target te verwijderen, gebruikt u remove-iscsi-send-targets of remove-iscsi-static-targets met de opties van het toevoegen. Om de adapter uit te schakelen, voert u set-software-iscsi --disabled uit.

Met de API

BewerkingVerzoek
In- of uitschakelenPUT /v1/hosts/{id}/iscsi/software met {"enabled": true}
Send targetsPOST of DELETE /v1/hosts/{id}/iscsi/send-targets met {"targets": [{"address": "198.51.100.10"}]}
Statische targetsPOST of DELETE /v1/hosts/{id}/iscsi/static-targets met address, iqn en port per target
CHAPPUT /v1/hosts/{id}/iscsi/authentication
RescanPOST /v1/hosts/{id}/iscsi/rescan (optioneel hbaDevice) en POST /v1/hosts/{id}/iscsi/rescan-all
LUN's tonenGET /v1/hosts/{id}/vmfs-disks, GET /v1/hosts/{id}/vmfs-create-options
De datastore makenPOST /v1/hosts/{id}/datastores met type vmfs, name en disk

Het CHAP-verzoek neemt chapAuthEnabled, chapName, chapSecret, de velden voor wederzijdse CHAP mutualChapAuthenticationType, mutualChapName en mutualChapSecret, en optioneel een targetSet met sendTargets en staticTargets om CHAP alleen voor die targets in te stellen. Laat chapSecret weg om het opgeslagen geheim van dezelfde naam te behouden.

Versie 0.1. Laatst gewijzigd: 2026-11-14