Comment monter un système de fichiers FSx for ONTAP sur une instance Linux EC2 à l’aide de NVMe sur TCP ?

Résolution

Remarque : La résolution suivante concerne les instances EC2 qui exécutent Red Hat Enterprise Linux (RHEL) 9.3.

Prérequis :

• L'instance autorise le trafic sortant sur le port TCP 4420.
• Le système de fichiers NetApp ONTAP autorise le trafic entrant sur le port TCP 4420.
• Configurez votre système de fichiers FSx for ONTAP avec NVMe/TCP.
  Remarque : Pour plus d'informations sur ce que vous devez faire avant de configurer votre système de fichiers avec NVMe/TCP, consultez la section Avant de commencer.
• Utilisez un système de fichiers de deuxième génération doté de six paires de haute disponibilité (HA) ou moins.

Monter votre système de fichiers sur votre instance RHEL à l’aide de NVMe/TCP

Procédez comme suit :

1. Pour installer les packages requis, exécutez la commande suivante sur l'instance :

   sudo yum install -y nvme-cli

2. Pour charger le module de noyau NVMe/TCP, exécutez la commande suivante sur l'instance :

   sudo modprobe nvme-tcp

3. Récupérez les adresses des interfaces de stockage par blocs pour la machine virtuelle de stockage (SVM) sur laquelle vous avez créé vos périphériques NVMe. Exécutez la commande suivante sur le serveur ONTAP :

   network interface show -vserver svm_name -data-protocol nvme-tcp

   Remarque : Remplacez svm_name par le nom de votre SVM. iSCSI et NVMe/TCP utilisent le format d'échange logique (LIF) iscsi_1.
   Exemple de sortie :

               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. Pour identifier les sous-systèmes NVMe, exécutez la commande suivante sur l'instance :

   sudo nvme discover -t tcp -w client_IP -a iscsi_1_IP

   Remarque : Remplacez iscsi_1_IP par votre adresse IP iscsi_1 et client_IP par l'adresse IP du client.

5. Pour vous connecter au sous-système NVMe, exécutez la commande suivante sur l'instance :

   sudo nvme connect-all -t tcp -w client_IP -a iscsi_1_IP -l 1800

   Remarque : Remplacez iscsi_1_IP par votre adresse IP iscsi_1 et client_IP par l'adresse IP du client.

6. Pour vérifier que la connexion fonctionne comme prévu, exécutez la commande suivante sur l'instance :

   sudo nvme list

   Dans la sortie, vérifiez la colonne Modèle pour /dev/nvmeXny.

7. (Facultatif) Pour créer un système de fichiers, exécutez la commande suivante sur l'instance :

   sudo mkfs.xfs /dev/nvmeXnY

   Remarque : Pour trouver /dev/nvmeXnY, vérifiez le résultat de la commande nvme list. Recherchez la colonne Modèle contenant la valeur du contrôleur NetApp ONTAP.

8. Pour créer un point de montage et le monter sur celui-ci, exécutez les commandes suivantes sur l'instance :

   sudo mkdir /mnt/fsx-nvme
   sudo mount /dev/nvmeXnY /mnt/fsx-nvme

   Remarque : Remplacez /mtn/fsx-nvme par le chemin de votre répertoire.

9. (Facultatif) Pour configurer le montage automatique lors du démarrage, ajoutez la ligne suivante au fichier /etc/fstab :

   /dev/nvmeXnY /mnt/fsx-nvme xfs _netdev,x-systemd.automount,x-systemd.requires=network-online.target 0 0

   Remarque : Remplacez nvmeXnY par votre nom NVMe et /mnt/fsx-nvme par votre chemin de fichier.
   Puis, créez un service systemd pour la connexion NVMe avec le chemin de fichier /etc/systemd/system/.
   Exemple de fichier :

   [Unit]
   Description=NVMe connection to FSx
   After=network.target
   
   
   [Service]
   Type=oneshot
   RemainAfterExit=yes
   ExecStart=/usr/sbin/nvme connect -t tcp -n "nqn.1992-08.com.netapp:sn.abcde" -w port -a fs-ABCDE.fsx.region.amazonaws.com -s 4420
   ExecStop=/usr/sbin/nvme disconnect -n "nqn.1992-08.com.netapp:sn.abcde"
   
   
   [Install]
   WantedBy=multi-user.target

10. Pour activer le service, exécutez la commande suivante :

sudo systemctl enable nvme-fsx.service

Résoudre les problèmes de montage NVMe/TCP

Important : Il est recommandé de créer un compte sur NetApp. Vous devez disposer d'un compte NetApp pour accéder à la documentation de résolution de problèmes liés à NetApp.

Si vous rencontrez des problèmes lors du montage de votre système de fichiers, effectuez les actions de dépannage suivantes :

• Pour vérifier la connectivité sur le port requis, exécutez la commande suivante :

  telnet fs-ABCDE.fsx.region.amazonaws.com 4420

  Remarque : Remplacez fs-ABCDE par le nom de votre système de fichiers et region par votre région AWS.

• Pour vérifier si la détection NVMe fonctionne comme prévu, exécutez la commande suivante :

  sudo nvme discover -t tcp -w port -a fs-ABCDE.fsx.region.amazonaws.com -s 4420

  Remarque : Remplacez port par votre port, fs-ABCDE par le nom de votre système de fichiers et region par votre région.

• Pour vérifier l'existence de problèmes dans vos connexions NVMe, exécutez la commande suivante :

  sudo nvme list

• Pour vérifier la présence d'erreurs dans les journaux, exécutez la commande suivante :

  dmesg | grep nvme or journalctl -u nvme-fsx

Configurer le serveur FSx for ONTAP

Pour vérifier que le service NVMe est en cours d'exécution, exécutez les commandes suivantes :

vserver nvme show
vserver nvme subsystem show

Pour vérifier que vous avez correctement configuré votre espace de noms, exécutez la commande suivante :

vserver nvme namespace show

Pour vérifier que vous avez ajouté le nom qualifié NVMe (NQN) de l'hôte au sous-système NVMe, exécutez la commande suivante :

vserver nvme subsystem host show

Pour vérifier que le mappage entre l'espace de noms et le sous-système est correct, exécutez la commande suivante :

vserver nvme subsystem map show

Informations connexes

Comment monter un volume FSX for ONTAP sur mon instance Linux EC2 à l’aide de NFS ?

Comment monter un partage CIFS FSx for ONTAP sur une instance Linux EC2 qui n'est pas jointe à un domaine Active Directory ?

Comment monter une LUN iSCSI FSx for ONTAP sur une instance Linux EC2 à l’aide d’iSCSI ?