Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Konfigurieren Sie RHEL 8.7 für NVMe-oF mit ONTAP Speicher

10/08/2025 Beitragende

PDFs

Red Hat Enterprise Linux (RHEL)-Hosts unterstützen die Protokolle NVMe over Fibre Channel (NVMe/FC) und NVMe over TCP (NVMe/TCP) mit Asymmetric Namespace Access (ANA). ANA bietet Multipathing-Funktionalität, die dem asymmetrischen logischen Einheitenzugriff (ALUA) in iSCSI- und FCP-Umgebungen entspricht.

Erfahren Sie, wie Sie NVMe over Fabrics (NVMe-oF)-Hosts für RHEL 8.7 konfigurieren. Weitere Informationen zu Support und Funktionen finden Sie unter"NVME-oF-Übersicht" .

NVMe-oF mit RHEL 8.7 weist die folgenden bekannten Einschränkungen auf:

SAN-Booten mit dem NVMe-oF-Protokoll wird derzeit nicht unterstützt.
In-Kernel-NVMe-Multipath ist auf NVMe-oF-Hosts in RHEL 8.7 standardmäßig deaktiviert; Sie müssen es manuell aktivieren.
NVMe/TCP ist aufgrund bekannter Probleme als Technologievorschau verfügbar.

Schritt 1: Aktivieren Sie optional den SAN-Bootvorgang

Sie können Ihren Host für die Verwendung von SAN-Boot konfigurieren, um die Bereitstellung zu vereinfachen und die Skalierbarkeit zu verbessern. Verwenden Sie die"Interoperabilitäts-Matrix-Tool" um zu überprüfen, ob Ihr Linux-Betriebssystem, Ihr Hostbusadapter (HBA), Ihre HBA-Firmware, Ihr HBA-Boot-BIOS und ONTAP -Version das SAN-Booten unterstützen.

Schritte

"Erstellen Sie einen NVMe-Namespace und ordnen Sie ihn dem Host zu" .
Aktivieren Sie das SAN-Booten im Server-BIOS für die Ports, denen der SAN-Boot-Namespace zugeordnet ist.

Informationen zum Aktivieren des HBA-BIOS finden Sie in der anbieterspezifischen Dokumentation.
Starten Sie den Host neu und überprüfen Sie, ob das Betriebssystem läuft.

Schritt 2: Überprüfen der Softwareversion und der NVMe-Konfiguration

Überprüfen Sie, ob Ihr System die Softwareanforderungen erfüllt, und überprüfen Sie die NVMe-Paketinstallationen und die Hostkonfiguration.

Schritte

Installieren Sie RHEL 8.7 auf dem Server. Überprüfen Sie nach Abschluss der Installation, ob Sie den erforderlichen RHEL 8.7-Kernel ausführen:
```
uname -r
```
Beispiel für eine RHEL-Kernelversion:
```
4.18.0-425.3.1.el8.x86_64
```
Installieren Sie den nvme-cli Paket:
```
rpm -qa|grep nvme-cli
```
Das folgende Beispiel zeigt eine nvme-cli-Paketversion:
```
nvme-cli-1.16-5.el8.x86_64
```
Installieren Sie den libnvme Paket:
```
rpm -qa|grep libnvme
```
Das folgende Beispiel zeigt eine libnvme-Paketversion:
```
libnvme-1.2-3.el8.x86_64
```

Unterstützung für NVMe Multipath im Kernel:

grubby --args=nvme_core.multipath=Y --update-kernel /boot/vmlinuz-4.18.0-425.3.1.el8.x86_64

Überprüfen Sie auf dem RHEL 8.7-Host die hostnqn Zeichenfolge bei /etc/nvme/hostnqn :
```
cat /etc/nvme/hostnqn
```
Das folgende Beispiel zeigt eine hostnqn Version:
```
nqn.2014-08.org.nvmexpress:uuid:a7f7a1d4-311a-11e8-b634-7ed30aef10b7
```

Überprüfen Sie, ob die hostnqn Zeichenfolge entspricht dem hostnqn Zeichenfolge für das entsprechende Subsystem auf dem ONTAP -Speichersystem:

::> vserver nvme subsystem host show -vserver vs_nvme167

Beispiel anzeigen

Vserver     Subsystem          Host NQN
----------- --------------- ----------------------------------------------------------
vs_nvme167   rhel_167_LPe35002    nqn.2014-08.org.nvmexpress:uuid:a7f7a1d4-311a-11e8-b634-7ed30aef10b7

Wenn die hostnqn Zeichenfolgen nicht übereinstimmen, verwenden Sie die vserver modify Befehl zum Aktualisieren der hostnqn Zeichenfolge auf Ihrem entsprechenden ONTAP -Speichersystem-Subsystem, um die Übereinstimmung mit hostnqn Zeichenfolge von /etc/nvme/hostnqn auf dem Host.

Starten Sie den Host neu.

Um sowohl NVMe- als auch SCSI-Verkehr auf demselben Host auszuführen, empfiehlt NetApp die Verwendung des Kernel-NVMe-Multipath für ONTAP Namespaces und des DM-Multipath für ONTAP -LUNs. Um zu verhindern, dass dm-multipath ONTAP Namespace-Geräte beansprucht, schließen Sie diese aus, indem Sie den enable_foreign Einstellung auf die /etc/multipath.conf Datei:

cat /etc/multipath.conf
defaults {
        enable_foreign     NONE
}

Starten Sie den Multipathd-Daemon neu, indem Sie ein ausführen systemctl restart multipathd.

Schritt 3: Konfigurieren Sie NVMe/FC und NVMe/TCP

Konfigurieren Sie NVMe/FC mit Broadcom/Emulex- oder Marvell/QLogic-Adaptern oder konfigurieren Sie NVMe/TCP mithilfe manueller Erkennungs- und Verbindungsvorgänge.

FC – Broadcom/Emulex

Konfigurieren Sie NVMe/FC für einen Broadcom/Emulex-Adapter.

Schritte

Stellen Sie sicher, dass Sie das unterstützte Adaptermodell verwenden:
1. Zeigen Sie die Modellnamen an:
  cat /sys/class/scsi_host/host*/modelname
  Sie sollten eine Ausgabe ähnlich dem folgenden Beispiel sehen:
  LPe35002-M2 LPe35002-M2
2. Zeigen Sie die Modellbeschreibungen an:
  cat /sys/class/scsi_host/host*/modeldesc
  Sie sollten eine Ausgabe ähnlich dem folgenden Beispiel sehen:
```
Emulex LightPulse LPe35002-M2 2-Port 32Gb Fibre Channel Adapter
Emulex LightPulse LPe35002-M2 2-Port 32Gb Fibre Channel Adapter
```
Vergewissern Sie sich, dass Sie das empfohlene Broadcom verwenden lpfc Firmware und Inbox-Treiber:
1. Anzeige der Firmware-Version:
  cat /sys/class/scsi_host/host*/fwrev
  Der Befehl gibt die Firmware-Versionen zurück:
  14.0.505.12, sli-4:6:d 14.0.505.12, sli-4:6:d
2. Zeigen Sie die Posteingangstreiberversion an:
  cat /sys/module/lpfc/version
  Das folgende Beispiel zeigt eine Treiberversion:
  0:14.0.0.15
Die aktuelle Liste der unterstützten Adaptertreiber- und Firmware-Versionen finden Sie im "Interoperabilitäts-Matrix-Tool".
Verifizieren Sie das lpfc_enable_fc4_type Ist auf festgelegt 3:
```
cat /sys/module/lpfc/parameters/lpfc_enable_fc4_type
```
Vergewissern Sie sich, dass Sie Ihre Initiator-Ports anzeigen können:
```
cat /sys/class/fc_host/host*/port_name
```
Sie sollten eine Ausgabe ähnlich dem folgenden Beispiel sehen:
```
0x100000109b95467c
0x100000109b95467b
```
Überprüfen Sie, ob Ihre Initiator-Ports online sind:
```
cat /sys/class/fc_host/host*/port_state
```
Die folgende Ausgabe sollte angezeigt werden:
```
Online
Online
```

Vergewissern Sie sich, dass die NVMe/FC-Initiator-Ports aktiviert sind und die Ziel-Ports sichtbar sind:

cat /sys/class/scsi_host/host*/nvme_info

Beispiel anzeigen

NVME Initiator Enabled
XRI Dist lpfc1 Total 6144 IO 5894 ELS 250
NVME LPORT lpfc1 WWPN x100000109b95467c WWNN x200000109b95467c DID x0a1500 ONLINE
NVME RPORT       WWPN x2071d039ea36a105 WWNN x206ed039ea36a105 DID x0a0907 TARGET DISCSRVC ONLINE
NVME RPORT       WWPN x2072d039ea36a105 WWNN x206ed039ea36a105 DID x0a0805 TARGET DISCSRVC ONLINE

NVME Statistics
LS: Xmt 00000001c7 Cmpl 00000001c7 Abort 00000000
LS XMIT: Err 00000000  CMPL: xb 00000000 Err 00000000
Total FCP Cmpl 0000000004909837 Issue 0000000004908cfc OutIO fffffffffffff4c5
abort 0000004a noxri 00000000 nondlp 00000458 qdepth 00000000 wqerr 00000000 err 00000000
FCP CMPL: xb 00000061 Err 00017f43

NVME Initiator Enabled
XRI Dist lpfc0 Total 6144 IO 5894 ELS 250
NVME LPORT lpfc0 WWPN x100000109b95467b WWNN x200000109b95467b DID x0a1100 ONLINE
NVME RPORT       WWPN x2070d039ea36a105 WWNN x206ed039ea36a105 DID x0a1007 TARGET DISCSRVC ONLINE
NVME RPORT       WWPN x206fd039ea36a105 WWNN x206ed039ea36a105 DID x0a0c05 TARGET DISCSRVC ONLINE

NVME Statistics
LS: Xmt 00000001c7 Cmpl 00000001c7 Abort 00000000
LS XMIT: Err 00000000  CMPL: xb 00000000 Err 00000000
Total FCP Cmpl 0000000004909464 Issue 0000000004908531 OutIO fffffffffffff0cd
abort 0000004f noxri 00000000 nondlp 00000361 qdepth 00000000 wqerr 00000000 err 00000000
FCP CMPL: xb 0000006b Err 00017f99

FC – Marvell/QLogic

Konfigurieren Sie NVMe/FC für einen Marvell/QLogic-Adapter.

Schritte

Stellen Sie sicher, dass Sie die unterstützten Adaptertreiber- und Firmware-Versionen verwenden:
```
cat /sys/class/fc_host/host*/symbolic_name
```
Das folgende Beispiel zeigt Treiber- und Firmwareversionen:
```
QLE2772 FW:v9.08.02 DVR:v10.02.07.400-k-debug
QLE2772 FW:v9.08.02 DVR:v10.02.07.400-k-debug
```
Verifizieren Sie das ql2xnvmeenable Ist festgelegt. Dadurch kann der Marvell Adapter als NVMe/FC-Initiator verwendet werden:
```
cat /sys/module/qla2xxx/parameters/ql2xnvmeenable
```
Die erwartete Ausgabe ist 1.

TCP

Das NVMe/TCP-Protokoll unterstützt den automatischen Verbindungsvorgang nicht. Stattdessen können Sie die NVMe/TCP-Subsysteme und Namespaces ermitteln, indem Sie den NVMe/TCP connect oder connect-all Vorgänge manuell ausführen.

Schritte

Überprüfen Sie, ob der Initiator-Port die Daten der Erkennungsprotokollseite über die unterstützten NVMe/TCP-LIFs abrufen kann:

nvme discover -t tcp -w host-traddr -a traddr

Beispiel anzeigen

nvme discover -t tcp -w 192.168.211.5 -a 192.168.211.14

Discovery Log Number of Records 8, Generation counter 10

=====Discovery Log Entry 0======
trtype:  tcp
adrfam:  ipv4
subtype: unrecognized
treq:    not specified
portid:  0
trsvcid: 8009
subnqn:  nqn.199208.com.netapp:sn.154a5833c78c11ecb069d039ea359e4b:discovery
traddr:  192.168.211.15
sectype: none
=====Discovery Log Entry 1======
trtype:  tcp
adrfam:  ipv4
subtype: unrecognized
treq:    not specified
portid:  1
trsvcid: 8009
subnqn:  nqn.1992-08.com.netapp:sn.154a5833c78c11ecb069d039ea359e4b:discovery
traddr:  192.168.111.15
sectype: none
=====Discovery Log Entry 2======
trtype:  tcp
adrfam:  ipv4
subtype: unrecognized
treq:    not specified
portid:  2
trsvcid: 8009
subnqn:  nqn.1992-08.com.netapp:sn.154a5833c78c11ecb069d039ea359e4b:discovery
traddr:  192.168.211.14
sectype: none
=====Discovery Log Entry 3======
trtype:  tcp
adrfam:  ipv4
subtype: unrecognized
treq:    not specified
portid:  3
trsvcid: 8009
subnqn:  nqn.1992-08.com.netapp:sn.154a5833c78c11ecb069d039ea359e4b:discovery
traddr:  192.168.111.14
sectype: none
=====Discovery Log Entry 4======
trtype:  tcp
adrfam:  ipv4
subtype: nvme subsystem
treq:    not specified
portid:  0
trsvcid: 4420
subnqn:  nqn.1992-08.com.netapp:sn.154a5833c78c11ecb069d039ea359e4b:subsystem.rhel_tcp_165
traddr:  192.168.211.15
sectype: none
=====Discovery Log Entry 5======
trtype:  tcp
adrfam:  ipv4
subtype: nvme subsystem
treq:    not specified
portid:  1
trsvcid: 4420
subnqn:  nqn.1992-08.com.netapp:sn.154a5833c78c11ecb069d039ea359e4b:subsystem.rhel_tcp_165
traddr:  192.168.111.15
sectype: none
=====Discovery Log Entry 6======

trtype:  tcp
adrfam:  ipv4
subtype: nvme subsystem
treq:    not specified
portid:  2
trsvcid: 4420
subnqn:  nqn.1992-08.com.netapp:sn.154a5833c78c11ecb069d039ea359e4b:subsystem.rhel_tcp_165
traddr:  192.168.211.14
sectype: none

=====Discovery Log Entry 7======
trtype:  tcp
adrfam:  ipv4
subtype: nvme subsystem
treq:    not specified

   portid:  3

trsvcid: 4420
subnqn:  nqn.1992-08.com.netapp:sn.154a5833c78c11ecb069d039ea359e4b:subsystem.rhel_tcp_165
traddr:  192.168.111.14
sectype: none
[root@R650-13-79 ~]#

Vergewissern Sie sich, dass die anderen LIF-Kombinationen des NVMe/TCP-Initiators die Daten der Erkennungsprotokollseite erfolgreich abrufen können:

nvme discover -t tcp -w host-traddr -a traddr

Beispiel anzeigen

nvme discover -t tcp -w 192.168.211.5 -a 192.168.211.14
nvme discover -t tcp -w 192.168.211.5 -a 192.168.211.15
nvme discover -t tcp -w 192.168.111.5 -a 192.168.111.14
nvme discover -t tcp -w 192.168.111.5 -a 192.168.111.15

Führen Sie die aus nvme connect-all Befehl über alle unterstützten NVMe/TCP Initiator-Ziel-LIFs der Nodes hinweg:

nvme connect-all -t tcp -w host-traddr -a traddr -1 1800

Beispiel anzeigen

nvme connect-all -t tcp -w 192.168.211.5-a 192.168.211.14 -l 1800
nvme connect-all -t tcp -w 192.168.211.5 -a 192.168.211.15 -l 1800
nvme connect-all -t tcp -w 192.168.111.5 -a 192.168.111.14 -l 1800
nvme connect-all -t tcp -w 192.168.111.5 -a 192.168.111.15 -l 1800

Schritt 4: Optional 1 MB I/O für NVMe/FC aktivieren

ONTAP meldet in den Identify Controller-Daten eine maximale Datenübertragungsgröße (MDTS) von 8. Dies bedeutet, dass die maximale E/A-Anforderungsgröße bis zu 1 MB betragen kann. Um E/A-Anfragen der Größe 1 MB für einen Broadcom NVMe/FC-Host auszugeben, sollten Sie die lpfc Wert des lpfc_sg_seg_cnt Parameter vom Standardwert 64 auf 256.

Diese Schritte gelten nicht für Qlogic NVMe/FC-Hosts.

Schritte

Setzen Sie den lpfc_sg_seg_cnt Parameter auf 256:
```
cat /etc/modprobe.d/lpfc.conf
```
Sie sollten eine Ausgabe ähnlich dem folgenden Beispiel sehen:
```
options lpfc lpfc_sg_seg_cnt=256
```
Führen Sie den Befehl aus dracut -f, und starten Sie den Host neu.
Stellen Sie sicher, dass der Wert für lpfc_sg_seg_cnt 256 lautet:
```
cat /sys/module/lpfc/parameters/lpfc_sg_seg_cnt
```

Schritt 5: NVMe-oF validieren

Vergewissern Sie sich, dass der in-Kernel-Multipath-Status, der ANA-Status und die ONTAP-Namespaces für die NVMe-of-Konfiguration richtig sind.

Schritte

Vergewissern Sie sich, dass das in-Kernel NVMe Multipath aktiviert ist:
```
cat /sys/module/nvme_core/parameters/multipath
```
Die folgende Ausgabe sollte angezeigt werden:
```
Y
```
Vergewissern Sie sich, dass die entsprechenden NVMe-of-Einstellungen (z. B. auf NetApp ONTAP-Controller gesetzt auf Modell und Load-Balancing-IOpolicy auf Round-Robin eingestellt) für die jeweiligen ONTAP-Namespaces den Host korrekt widerspiegeln:
1. Zeigen Sie die Subsysteme an:
  cat /sys/class/nvme-subsystem/nvme-subsys*/model
  Die folgende Ausgabe sollte angezeigt werden:
  NetApp ONTAP Controller NetApp ONTAP Controller
2. Zeigen Sie die Richtlinie an:
  cat /sys/class/nvme-subsystem/nvme-subsys*/iopolicy
  Die folgende Ausgabe sollte angezeigt werden:
```
round-robin
round-robin
```

Überprüfen Sie, ob die Namespaces auf dem Host erstellt und richtig erkannt wurden:

nvme list

Beispiel anzeigen

Node         SN                   Model
---------------------------------------------------------
/dev/nvme4n1 81Ix2BVuekWcAAAAAAAB	NetApp ONTAP Controller


Namespace Usage    Format             FW             Rev
-----------------------------------------------------------
1                 21.47 GB / 21.47 GB	4 KiB + 0 B   FFFFFFFF

Überprüfen Sie, ob der Controller-Status jedes Pfads aktiv ist und den korrekten ANA-Status aufweist:

nvme list-subsys /dev/nvme1n1

Beispiel anzeigen

nvme-subsys0 - NQN=nqn.1992-08.com.netapp:sn.154a5833c78c11ecb069d039ea359e4b:subsystem.rhel_tcp_165
\
 +- nvme0 tcp traddr=192.168.211.15 trsvcid=4420 host_traddr=192.168.211.5 live non-optimized
 +- nvme1 tcp traddr=192.168.211.14 trsvcid=4420 host_traddr=192.168.211.5 live optimized
 +- nvme2 tcp traddr=192.168.111.15 trsvcid=4420 host_traddr=192.168.111.5 live non-optimized
 +- nvme3 tcp traddr=192.168.111.14 trsvcid=4420 host_traddr=192.168.111.5 live optimized

Vergewissern Sie sich, dass das NetApp Plug-in für jedes ONTAP Namespace-Gerät die richtigen Werte anzeigt:

Spalte

nvme netapp ontapdevices -o column

Beispiel anzeigen

Device       Vserver          Namespace Path
---------    -------          --------------------------------------------------
/dev/nvme0n1 vs_tcp79     /vol/vol1/ns1 

NSID  UUID                                   Size
----  ------------------------------         ------
1     79c2c569-b7fa-42d5-b870-d9d6d7e5fa84  21.47GB

JSON

nvme netapp ontapdevices -o json

Beispiel anzeigen

{

  "ONTAPdevices" : [
  {

      "Device" : "/dev/nvme0n1",
      "Vserver" : "vs_tcp79",
      "Namespace_Path" : "/vol/vol1/ns1",
      "NSID" : 1,
      "UUID" : "79c2c569-b7fa-42d5-b870-d9d6d7e5fa84",
      "Size" : "21.47GB",
      "LBA_Data_Size" : 4096,
      "Namespace_Size" : 5242880
    },

]

}

Schritt 6: Überprüfen Sie die bekannten Probleme

Dies sind die bekannten Probleme:

NetApp Bug ID	Titel	Beschreibung
"1479047"	RHEL 8.7 NVMe-oF-Hosts erstellen doppelte Persistent Discovery Controller (PDCs)	Auf NVMe-oF-Hosts können Sie den Befehl „nvme discover -p“ verwenden, um PDCs zu erstellen. Wenn dieser Befehl verwendet wird, sollte nur ein PDC pro Initiator-Ziel-Kombination erstellt werden. Wenn Sie jedoch RHEL 8.8 auf einem NVMe-oF-Host ausführen, wird bei jeder Ausführung von „nvme discover -p“ ein doppelter PDC erstellt. Dies führt zu einer unnötigen Nutzung von Ressourcen sowohl auf dem Host als auch auf dem Ziel.

NetApp Bug ID

Titel

Beschreibung

"1479047"

RHEL 8.7 NVMe-oF-Hosts erstellen doppelte Persistent Discovery Controller (PDCs)

Auf NVMe-oF-Hosts können Sie den Befehl „nvme discover -p“ verwenden, um PDCs zu erstellen. Wenn dieser Befehl verwendet wird, sollte nur ein PDC pro Initiator-Ziel-Kombination erstellt werden. Wenn Sie jedoch RHEL 8.8 auf einem NVMe-oF-Host ausführen, wird bei jeder Ausführung von „nvme discover -p“ ein doppelter PDC erstellt. Dies führt zu einer unnötigen Nutzung von Ressourcen sowohl auf dem Host als auch auf dem Ziel.

Konfigurieren Sie RHEL 8.7 für NVMe-oF mit ONTAP Speicher

Creating your file...

Schritt 1: Aktivieren Sie optional den SAN-Bootvorgang

Schritt 2: Überprüfen der Softwareversion und der NVMe-Konfiguration

Schritt 3: Konfigurieren Sie NVMe/FC und NVMe/TCP

Schritt 4: Optional 1 MB I/O für NVMe/FC aktivieren

Schritt 5: NVMe-oF validieren

Schritt 6: Überprüfen Sie die bekannten Probleme