Come posso utilizzare iSCSI per montare un LUN iSCSI FSx per ONTAP su un'istanza EC2 Linux?

Risoluzione

Nota: la seguente risoluzione è per le istanze Amazon EC2 che eseguono Amazon Linux 2023 (AL2023), Amazon Linux 2 (AL2), Red Hat Enterprise Linux (RHEL) 8 e CentOS 8.

Prerequisiti:

• L'istanza EC2 consente il traffico in uscita sulla porta TCP 3260.
• Il file system NetApp ONTAP consente il traffico in entrata sulla porta TCP 3260.
• Configura le istanze e i file system iSCSI richiesti.
  Nota: i requisiti per le istanze AL2 sono identici a quelli per le istanze AL2023.

Utilizza iSCSI per montare il file system sull'istanza

Completa i seguenti passaggi:

1. Per installare i pacchetti richiesti, esegui questo comando:

   sudo yum install -y iscsi-initiator-utils device-mapper-multipath

2. Per configurare il multipath per il file system, esegui questi comandi:

   sudo mpathconf --enable --with_multipathd y
   sudo systemctl start multipathd
   sudo systemctl enable multipathd

3. Per recuperare gli indirizzi delle interfacce di archiviazione a blocchi per la SVM (Storage Virtual Machine), utilizza l'interfaccia a riga di comando (CLI) di ONTAP. Esegui questo comando sul file system FSx ONTAP:

   network interface show -vserver svm_name

   Nota: sostituisci svm_name con il nome della tua SVM.
   Esempio di output:

               Logical               Status         Network            Current                    Current Is
   Vserver     Interface             Admin/Oper     Address/Mask       Node                       Port    Home
   ----------- ----------            ----------     ------------------ -------------              ------- ----
   svm_name
               iscsi_1               up/up          iscsi_1_IP/X       FSxId0123456789abcdef8-01  e0e     true
               iscsi_2               up/up          iscsi_2_IP/X       FSxId0123456789abcdef8-02  e0e     true
   2 entries were displayed.

4. Per trovare le destinazioni di iSCSI, individua l'iniziatore della destinazione eseguendo questo comando sull'istanza EC2:

   sudo iscsiadm --mode discovery --op update --type sendtargets --portal iscsi_1_IP

   Nota: sostituisci iscsi_1_IP con l'indirizzo IP dell'interfaccia logica iscsi_1 ricevuto dal comando precedente.
   Esempio di output:

   iscsi_1:3260,1029 iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3
   iscsi_2:3260,1028 iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3

   Nell'esempio di output precedente, l'iniziatore della destinazione è iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3.

5. (Facoltativo) Per stabilire 8 sessioni in ogni iniziatore in ogni nodo ONTAP in ciascuna zona di disponibilità, esegui questo comando:

   sudo iscsiadm --mode node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 --op update -n node.session.nr_sessions -v 8

   Nota: sostituisci iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 con l'iniziatore della tua destinazione.

6. Per accedere alla destinazione di iSCSI, esegui questo comando:

   sudo iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -l

   Nota: sostituisci iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 con l'iniziatore della tua destinazione.

7. Per individuare il dispositivo multipath, esegui questo comando:

   sudo multipath -ll

   Esempio di output:

   3600a09806c5742314e5d52766e79614f dm-xyz NETAPP ,LUN C-Mode
   size=10G features='4 queue_if_no_path pg_init_retries 50 retain_attached_hw_handle' hwhandler='0' wp=rw
   |-+- policy='service-time 0' prio=50 status=active |
   |- 0:0:0:1 sda 8:0 active ready running |
   |- 1:0:0:1 sdc 8:32 active ready running |
   |- 3:0:0:1 sdg 8:96 active ready running | `
   - 4:0:0:1 sdh 8:112 active ready running `
   -+- policy='service-time 0' prio=10 status=enabled
   |- 2:0:0:1 sdb 8:16 active ready running
   |- 7:0:0:1 sdf 8:80 active ready running
   |- 6:0:0:1 sde 8:64 active ready running
   `- 5:0:0:1 sdd 8:48 active ready running

   Nell'esempio di output precedente, il collegamento simbolico è 3600a09806c5742314e5d52766e79614f. Puoi trovare il link simbolico nel percorso /dev/mapper/wwid, dove wwid è l'identificatore univoco del LUN su tutti i dispositivi.

8. Per creare un file system, esegui questo comando:

   sudo mkfs.xfs /dev/mapper/wwid

   Nota: sostituisci wwid con l'identificatore univoco del tuo LUN.

9. Per creare un punto di montaggio ed effettuare il montaggio sul punto creato, esegui questi comandi:

   sudo mkdir /mnt/fsx-iscsi
   sudo mount /dev/mapper/wwid /mnt/fsx-iscsi

10. (Facoltativo) Per configurare il montaggio automatico durante l'avvio, attiva il servizio iSCSI eseguendo questi comandi:

sudo systemctl enable iscsid
sudo systemctl enable iscsi

Quindi aggiungi la riga seguente al file /etc/fstab:

/dev/mapper/wwid /mnt/fsx-iscsi xfs _netdev,x-systemd.automount,x-systemd.requires=network-online.target 0 0

Nota: sostituisci wwid con l'identificatore univoco del tuo LUN e /mnt/fsx-iscsi con il percorso del tuo file. Crea un file di servizio systemd per l'accesso iSCSI con il percorso del file /etc/systemd/system/.
Esempio di file:

[Unit]
Description=iSCSI connection to FSx
After=network.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/sbin/iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -p iscsi_1_IP -l
ExecStop=/sbin/iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -p iscsi_1_IP -u

[Install]
WantedBy=multi-user.target

Nota: sostituisci iscsi_1_IP con l'indirizzo IP della tua interfaccia logica iscsi_1 e region con la tua Regione AWS. Per attivare e avviare il servizio, esegui questi comandi:

sudo systemctl enable iscsi-fsx.service
sudo systemctl start iscsi-fsx.service
sudo systemctl status iscsi-fsx.service

Risolvi i problemi di montaggio relativi a ISCSI

Importante: è consigliabile creare un account NetApp. Devi avere un account NetApp per accedere alla knowledge base di NetApp.

Risolvi i problemi relativi al server EC2 Linux

Se riscontri problemi durante il montaggio del file system, completa la seguente procedura di risoluzione dei problemi:

• Per verificare la connettività sulla porta richiesta, esegui questo comando:

  telnet iscsi_1_IP 3260

  Nota: sostituisci iscsi_1_IP con l'indirizzo IP della tua interfaccia logica iscsi_1.

• Per verificare se il rilevamento iSCSI funziona come previsto, esegui questo comando:

  sudo iscsiadm -m discovery --op update -t sendtargets -p iscsi_1_IP

  Nota: sostituisci iscsi_1_IP con l'indirizzo IP della tua interfaccia logica iscsi_1.

• Per verificare lo stato delle sessioni iSCSI attive e identificare i problemi, esegui questo comando:

  sudo iscsiadm -m session

• Per verificare che il multipath funzioni come previsto, esegui questo comando:

  sudo multipath -ll

• Per verificare la presenza di errori nei log, esegui uno di questi comandi:

  dmesg | grep iSCSI

  -oppure-

  journalctl -u iscsid

Per risolvere ulteriormente problemi di montaggio, consulta Troubleshoot iSCSI LUNs not visible on the host (Risoluzione dei problemi relativi ai LUN iSCSI non visibili sull'host) sul sito web NetApp.

Risolvi i problemi relativi al server FSx per ONTAP

Per verificare che il servizio iSCSI sia in esecuzione, esegui questi comandi:

vserver iscsi show
iscsi session show

Per verificare la presenza di problemi nella configurazione del LUN, esegui questo comando:

lun show -vserver vserver_name

Nota: sostituisci vserver_name con il nome del tuo server.

Per verificare di aver configurato correttamente l'accesso allo storage, visualizza la mappatura tra i LUN e i gruppi di iniziatori eseguendo questo comando:

lun mapping show

Per verificare la configurazione di igroup e confermare che include l'iniziatore, esegui questo comando:

igroup show -instance