Skip to main content
ONTAP SAN Host Utilities
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Dépannage NVMe-oF avec ONTAP Storage pour les utilitaires hôtes Linux

Contributeurs netapp-pcarriga netapp-ranuk
PDF

Dépannage des échecs NVMe-oF pour les hôtes Oracle Linux, RHEL, Rocky Linux et SUSE Linux Enterprise Server avec stockage ONTAP .

Avant de commencer le dépannage, vérifiez que vous utilisez une configuration conforme à la norme. "Matrice d'interopérabilité" Consultez les spécifications, puis passez aux étapes suivantes pour déboguer les éventuels problèmes côté hôte.

Remarque Les instructions de dépannage ne s'appliquent pas aux hôtes AIX, ESXi, Proxmox et Windows.

Activer la journalisation détaillée

Si vous rencontrez un problème avec votre configuration, la journalisation détaillée peut fournir des informations essentielles pour le dépannage.

Étapes

Configurer la journalisation détaillée pour LPFC ou Qlogic (Qla2xxx).

LFC

Définissez le pilote lpfc pour NVMe/FC.

  1. Réglez le lpfc_log_verbose Paramètre du pilote sur l'une des valeurs suivantes pour enregistrer les événements NVMe/FC.

    #define LOG_NVME 0x00100000 /* NVME general events. */
#define LOG_NVME_DISC 0x00200000 /* NVME Discovery/Connect events. */
#define LOG_NVME_ABTS 0x00400000 /* NVME ABTS events. */
#define LOG_NVME_IOERR 0x00800000 /* NVME IO Error events. */

  2. Une fois les valeurs définies, exécutez le dracut-f commande et redémarre l'hôte.

  3. Vérifiez les paramètres :

    # cat /etc/modprobe.d/lpfc.conf options lpfc lpfc_log_verbose=0xf00083

# cat /sys/module/lpfc/parameters/lpfc_log_verbose 15728771
Qla2xxx

Il n'existe pas de journalisation qla2xxx spécifique pour NVMe/FC similaire à celle du lpfc conducteur. Définissez plutôt le niveau de journalisation général qla2xxx.

  1. Ajoutez le ql2xextended_error_logging=0x1e400000 valeur au correspondant modprobe qla2xxx conf fichier.

  2. Exécutez le dracut -f puis redémarrez l'hôte.

  3. Après le redémarrage, vérifiez que la journalisation détaillée a été activée :

    # cat /etc/modprobe.d/qla2xxx.conf

    Vous devriez voir une sortie similaire à l’exemple suivant :

    options qla2xxx ql2xnvmeenable=1 ql2xextended_error_logging=0x1e400000
# cat /sys/module/qla2xxx/parameters/ql2xextended_error_logging
507510784

Erreurs courantes liées à « nvme-cli » et solutions de contournement

Les erreurs affichées par nvme-cli pendant nvme discover, nvme connect, ou nvme connect-all les opérations et les solutions de contournement sont indiquées dans le tableau suivant :

Message d'erreur Cause probable Solution de contournement

Failed to write to /dev/nvme-fabrics: Invalid argument

Syntaxe incorrecte

Vérifiez que vous utilisez la syntaxe correcte pour le nvme discover, nvme connect, et nvme connect-all commandes.

Failed to write to /dev/nvme-fabrics: No such file or directory

Plusieurs problèmes peuvent déclencher cette situation, par exemple, la fourniture d'arguments incorrects vers les commandes NVMe est l'une des causes courantes.

  • Vérifiez que vous avez transmis les arguments corrects (par exemple, chaîne WWNN, chaîne WWPN, etc.) aux commandes.

  • Si les arguments sont corrects, mais que vous voyez toujours cette erreur, vérifiez si l' /sys/class/scsi_host/host*/nvme_info La sortie de la commande est correcte, l'initiateur NVMe est affiché comme Enabled, Et les LIFs cibles NVMe/FC sont correctement affichées sous les sections ports distants. Exemple :

    # cat /sys/class/scsi_host/host*/nvme_info
NVME Initiator Enabled
NVME LPORT lpfc0 WWPN x10000090fae0ec9d WWNN x20000090fae0ec9d DID x012000 ONLINE
NVME RPORT WWPN x200b00a098c80f09 WWNN x200a00a098c80f09 DID x010601 TARGET DISCSRVC ONLINE
NVME Statistics
LS: Xmt 0000000000000006 Cmpl 0000000000000006
FCP: Rd 0000000000000071 Wr 0000000000000005 IO 0000000000000031
Cmpl 00000000000000a6 Outstanding 0000000000000001
NVME Initiator Enabled
NVME LPORT lpfc1 WWPN x10000090fae0ec9e WWNN x20000090fae0ec9e DID x012400 ONLINE
NVME RPORT WWPN x200900a098c80f09 WWNN x200800a098c80f09 DID x010301 TARGET DISCSRVC ONLINE
NVME Statistics
LS: Xmt 0000000000000006 Cmpl 0000000000000006
FCP: Rd 0000000000000073 Wr 0000000000000005 IO 0000000000000031
Cmpl 00000000000000a8 Outstanding 0000000000000001

  • Si le résultat de la nvme_info commande n'affiche pas les LIFs cibles comme indiqué dans l'exemple ci-dessus, vérifiez les sorties de la /var/log/messages commande et dmesg en s'il y a des défaillances NVMe/FC suspectes, et signalez-le ou corrigez-le en conséquence.

No discovery log entries to fetch

Généralement observé lorsque l' /etc/nvme/hostnqn La chaîne n'a pas été ajoutée au sous-système correspondant de la baie NetApp ou incorrecte hostnqn la chaîne a été ajoutée au sous-système respectif.

Vérifiez que le code est exact /etc/nvme/hostnqn Une chaîne est ajoutée au sous-système correspondant de la baie NetApp (vérifiez à l'aide de la vserver nvme subsystem host show commande).

Failed to write to /dev/nvme-fabrics: Operation already in progress

Observé lorsque les associations de contrôleur ou l'opération spécifiée sont déjà créées ou en cours de création. Cela peut se produire dans le cadre des scripts de connexion automatique installés ci-dessus.

Aucune. Essayez d'exécuter le nvme discover commande à nouveau après un certain temps. Pour nvme connect et connect-all, exécutez le nvme list commande pour vérifier que les périphériques d'espace de noms sont déjà créés et affichés sur l'hôte.

Quand contacter le support technique

Si le problème persiste, veuillez rassembler les fichiers et les résultats des commandes suivants et nous contacter. "Support NetApp" pour un triage plus approfondi :

cat /sys/class/scsi_host/host*/nvme_info
/var/log/messages
dmesg
nvme discover output as in:
nvme discover --transport=fc --traddr=nn-0x200a00a098c80f09:pn-0x200b00a098c80f09 --host-traddr=nn-0x20000090fae0ec9d:pn-0x10000090fae0ec9d
nvme list
nvme list-subsys /dev/nvmeXnY