Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Configurar RHEL 8.4 para NVMe-oF con almacenamiento ONTAP

10/08/2025 Colaboradores

PDF

Los hosts Red Hat Enterprise Linux (RHEL) admiten los protocolos NVMe sobre canal de fibra (NVMe/FC) y NVMe sobre TCP (NVMe/TCP) con acceso asimétrico al espacio de nombres (ANA). ANA proporciona una funcionalidad de múltiples rutas equivalente al acceso a unidad lógica asimétrica (ALUA) en entornos iSCSI y FCP.

Aprenda a configurar hosts NVMe over Fabrics (NVMe-oF) para RHEL 8.4. Para obtener más información sobre soporte y funciones, consulte"Descripción general de NVME-oF" .

NVMe-oF con RHEL 8.4 tiene las siguientes limitaciones conocidas:

Actualmente no se admite el arranque SAN mediante el protocolo NVMe-oF.
La multiruta NVMe dentro del kernel está deshabilitada de manera predeterminada en los hosts NVMe-oF en RHEL 8.4; debe habilitarla manualmente.
NVMe/TCP está disponible como una versión preliminar de tecnología debido a problemas conocidos.

Paso 1: Opcionalmente, habilite el arranque SAN

Puede configurar su host para utilizar el arranque SAN para simplificar la implementación y mejorar la escalabilidad. Utilice el"Herramienta de matriz de interoperabilidad" para verificar que su sistema operativo Linux, el adaptador de bus de host (HBA), el firmware del HBA, el BIOS de arranque del HBA y la versión de ONTAP admitan el arranque SAN.

Pasos

"Cree un espacio de nombres NVMe y asígnelo al host" .
Habilite el arranque SAN en el BIOS del servidor para los puertos a los que está asignado el espacio de nombres de arranque SAN.

Para obtener información acerca de cómo activar el BIOS HBA, consulte la documentación específica de su proveedor.
Reinicie el host y verifique que el sistema operativo esté funcionando.

Paso 2: Verifique la versión del software y la configuración de NVMe

Verifique que su sistema cumpla con los requisitos de software y verifique las instalaciones de paquetes NVMe y la configuración del host.

Pasos

Instalar RHEL 8.4 en el servidor. Una vez completada la instalación, verifique que esté ejecutando el kernel RHEL 8.4 requerido:
```
uname -r
```
Ejemplo de versión del kernel RHEL:
```
4.18.0-305.el8.x86_64
```
Instale el nvme-cli paquete:
```
rpm -qa|grep nvme-cli
```
El siguiente ejemplo muestra una versión del paquete nvme-cli:
```
nvme-cli-1.12-3.el8.x86_64
```
Instale el libnvme paquete:
```
rpm -qa|grep libnvme
```
El siguiente ejemplo muestra una versión del paquete libnvme:
```
libnvme-1.0-1.el8.x86_64
```

Habilitar multivía en el kernel NVMe:

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

En el host RHEL 8.4, verifique la cadena hostnqn en /etc/nvme/hostnqn :
```
cat /etc/nvme/hostnqn
```
El siguiente ejemplo muestra una versión de hostnqn:
```
nqn.2014-08.org.nvmexpress:uuid:9ed5b327-b9fc-4cf5-97b3-1b5d986345d1
```

Compruebe que el hostnqn la cadena coincide con hostnqn Cadena para el subsistema correspondiente en la cabina de ONTAP:

::> vserver nvme subsystem host show -vserver vs_fcnvme_141

Muestra el ejemplo

Vserver     Subsystem          Host NQN
----------- --------------- ----------------------------------------------------------
vs_fcnvme_141   nvme_141_1    nqn.2014-08.org.nvmexpress:uuid:9ed5b327-b9fc-4cf5-97b3-1b5d986345d1

Si la hostnqn las cadenas no coinciden, utilice vserver modify comando para actualizar el hostnqn En el subsistema de cabina ONTAP correspondiente de que coincida con hostnqn cadena desde /etc/nvme/hostnqn en el host.

Reinicie el host.

Para ejecutar tráfico NVMe y SCSI en el mismo host, NetApp recomienda utilizar la ruta múltiple NVMe en el kernel para espacios de nombres ONTAP y dm-multipath para LUN ONTAP . Para evitar que dm-multipath reclame dispositivos de espacio de nombres ONTAP , exclúyalos agregando el enable_foreign Ajuste a la /etc/multipath.conf archivo:

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

Reinicie el daemon multipathd ejecutando un systemctl restart multipathd.

Paso 3: Configurar NVMe/FC o NVMe/TCP

Configure NVMe/FC con adaptadores Broadcom/Emulex o Marvell/QLogic, o configure NVMe/TCP mediante operaciones de descubrimiento y conexión manuales.

FC - Broadcom/Emulex

Configuración de NVMe/FC para un adaptador Broadcom/Emulex.

Pasos

Compruebe que está utilizando el modelo de adaptador admitido:

Mostrar los nombres de los modelos:
```
cat /sys/class/scsi_host/host*/modelname
```
Debería ver un resultado similar a este:
```
LPe32002-M2
LPe32002-M2
```
Mostrar las descripciones del modelo:
```
cat /sys/class/scsi_host/host*/modeldesc
```
Debería ver un resultado similar a este:

Emulex LightPulse LPe32002-M2 2-Port 32Gb Fibre Channel Adapter
Emulex LightPulse LPe32002-M2 2-Port 32Gb Fibre Channel Adapter

Compruebe que está utilizando la Broadcom recomendada lpfc firmware y controlador de bandeja de entrada:
1. Mostrar la versión del firmware:
  cat /sys/class/scsi_host/host*/fwrev
  El comando devuelve las versiones del firmware:
  12.8.340.8, sli-4:2:c 12.8.340.8, sli-4:2:c
2. Mostrar la versión del controlador de la bandeja de entrada:
  cat /sys/module/lpfc/version
  El siguiente ejemplo muestra una versión del controlador:
```
0:12.8.0.5
```
+
Para obtener la lista actual de versiones de firmware y controladores de adaptador compatibles, consulte la "Herramienta de matriz de interoperabilidad".
Compruebe que la salida esperada de lpfc_enable_fc4_type está definida en 3:
```
cat /sys/module/lpfc/parameters/lpfc_enable_fc4_type
```
Compruebe que puede ver los puertos de iniciador:
```
cat /sys/class/fc_host/host*/port_name
```
Debería ver un resultado similar a este:
```
0x100000109b1c1204
0x100000109b1c1205
```
Compruebe que los puertos de iniciador estén en línea:
```
cat /sys/class/fc_host/host*/port_state
```
Debe ver la siguiente salida:
```
Online
Online
```

Compruebe que los puertos de iniciador NVMe/FC estén habilitados y que los puertos de destino estén visibles:

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

Muestra el ejemplo

NVME Initiator Enabled
XRI Dist lpfc0 Total 6144 IO 5894 ELS 250
NVME LPORT lpfc0 WWPN x100000109b1c1204 WWNN x200000109b1c1204 DID x011d00 ONLINE
NVME RPORT WWPN x203800a098dfdd91 WWNN x203700a098dfdd91 DID x010c07 TARGET DISCSRVC ONLINE
NVME RPORT WWPN x203900a098dfdd91 WWNN x203700a098dfdd91 DID x011507 TARGET DISCSRVC ONLINE

NVME Statistics
LS: Xmt 0000000f78 Cmpl 0000000f78 Abort 00000000
LS XMIT: Err 00000000 CMPL: xb 00000000 Err 00000000
Total FCP Cmpl 000000002fe29bba Issue 000000002fe29bc4 OutIO 000000000000000a
abort 00001bc7 noxri 00000000 nondlp 00000000 qdepth 00000000 wqerr 00000000 err 00000000
FCP CMPL: xb 00001e15 Err 0000d906

NVME Initiator Enabled
XRI Dist lpfc1 Total 6144 IO 5894 ELS 250
NVME LPORT lpfc1 WWPN x100000109b1c1205 WWNN x200000109b1c1205 DID x011900 ONLINE
NVME RPORT WWPN x203d00a098dfdd91 WWNN x203700a098dfdd91 DID x010007 TARGET DISCSRVC ONLINE
NVME RPORT WWPN x203a00a098dfdd91 WWNN x203700a098dfdd91 DID x012a07 TARGET DISCSRVC ONLINE

NVME Statistics
LS: Xmt 0000000fa8 Cmpl 0000000fa8 Abort 00000000
LS XMIT: Err 00000000 CMPL: xb 00000000 Err 00000000
Total FCP Cmpl 000000002e14f170 Issue 000000002e14f17a OutIO 000000000000000a
abort 000016bb noxri 00000000 nondlp 00000000 qdepth 00000000 wqerr 00000000 err 00000000
FCP CMPL: xb 00001f50 Err 0000d9f8

FC - Marvell/QLogic

Configure NVMe/FC para un adaptador Marvell/QLogic.

Pasos

Verifique que esté utilizando el modelo de adaptador, el controlador y las versiones de firmware compatibles:
```
cat /sys/class/fc_host/host*/symbolic_name
```
Debería ver un resultado similar a este:
```
QLE2742 FW:v9.06.02 DVR:v10.02.00.104-k
QLE2742 FW:v9.06.02 DVR:v10.02.00.104-k
```
Compruebe que ql2xnvmeenable está configurado. Esto permite que el adaptador Marvell funcione como iniciador NVMe/FC:
```
cat /sys/module/qla2xxx/parameters/ql2xnvmeenable
```
El resultado esperado es 1.

TCP

El protocolo NVMe/TCP no admite la operación de conexión automática. En su lugar, puede descubrir los subsistemas y espacios de nombres NVMe/TCP realizando la prueba NVMe/TCP. connect o connect-all operaciones manualmente.

Pasos

Verifique que el puerto iniciador pueda obtener los datos de la página de registro de descubrimiento a través de los LIF NVMe/TCP compatibles:

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

Muestra el ejemplo

nvme discover -t tcp -w 192.168.1.8 -a 192.168.1.51

Discovery Log Number of Records 10, Generation counter 119
=====Discovery Log Entry 0======
trtype: tcp
adrfam: ipv4
subtype: nvme subsystem
treq: not specified
portid: 0
trsvcid: 4420
subnqn: nqn.1992-08.com.netapp:sn.56e362e9bb4f11ebbaded039ea165abc:subsystem.nvme_118_tcp_1
traddr: 192.168.2.56
sectype: none
=====Discovery Log Entry 1======
trtype: tcp
adrfam: ipv4
subtype: nvme subsystem
treq: not specified
portid: 1
trsvcid: 4420
subnqn: nqn.1992-08.com.netapp:sn.56e362e9bb4f11ebbaded039ea165abc:subsystem.nvme_118_tcp_1
traddr: 192.168.1.51
sectype: none
=====Discovery Log Entry 2======
trtype: tcp
adrfam: ipv4
subtype: nvme subsystem
treq: not specified
portid: 0
trsvcid: 4420
subnqn: nqn.1992-08.com.netapp:sn.56e362e9bb4f11ebbaded039ea165abc:subsystem.nvme_118_tcp_2
traddr: 192.168.2.56
sectype: none

Compruebe que las otras combinaciones de LIF iniciador-objetivo NVMe/TCP puedan recuperar correctamente los datos de la página del registro de detección:

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

Muestra el ejemplo

nvme discover -t tcp -w 192.168.1.8 -a 192.168.1.52
nvme discover -t tcp -w 192.168.2.9 -a 192.168.2.56
nvme discover -t tcp -w 192.168.2.9 -a 192.168.2.57

Ejecute el nvme connect-all Comando en todos los LIF objetivo iniciador NVMe/TCP admitidos entre los nodos:

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

Muestra el ejemplo

nvme connect-all -t tcp -w 192.168.1.8 -a 192.168.1.51 -l 1800
nvme connect-all -t tcp -w 192.168.1.8 -a 192.168.1.52 -l 1800
nvme connect-all -t tcp -w 192.168.2.9 -a 192.168.2.56 -l 1800
nvme connect-all -t tcp -w 192.168.2.9 -a 192.168.2.57 -l 1800

Paso 4: Opcionalmente, habilite 1 MB de E/S para NVMe/FC

ONTAP informa un tamaño máximo de transferencia de datos (MDTS) de 8 en los datos del controlador de identificación. Esto significa que el tamaño máximo de solicitud de E/S puede ser de hasta 1 MB. Para emitir solicitudes de E/S de tamaño 1 MB para un host Broadcom NVMe/FC, debe aumentar el lpfc valor de la lpfc_sg_seg_cnt parámetro a 256 desde el valor predeterminado de 64.

Estos pasos no se aplican a los hosts Qlogic NVMe/FC.

Pasos

Defina el lpfc_sg_seg_cnt parámetro en 256:
```
cat /etc/modprobe.d/lpfc.conf
```
Debería ver un resultado similar al siguiente ejemplo:
```
options lpfc lpfc_sg_seg_cnt=256
```
Ejecute dracut -f el comando y reinicie el host.

Compruebe que el valor de lpfc_sg_seg_cnt es 256:

cat /sys/module/lpfc/parameters/lpfc_sg_seg_cnt

Paso 5: Validar NVMe-oF

Verifique que el estado de multivía de NVMe en kernel, el estado de ANA y los espacios de nombres de ONTAP sean correctos para la configuración de NVMe-oF.

Pasos

Compruebe que la multivía NVMe en kernel esté habilitada:
```
cat /sys/module/nvme_core/parameters/multipath
```
Debe ver la siguiente salida:
```
Y
```
Compruebe que la configuración NVMe-oF adecuada (como, por ejemplo, el modelo configurado en la controladora NetApp ONTAP y la política de balanceo de carga establecida en round-robin) en los respectivos espacios de nombres de ONTAP se reflejen correctamente en el host:
1. Mostrar los subsistemas:
  cat /sys/class/nvme-subsystem/nvme-subsys*/model
  Debe ver la siguiente salida:
  NetApp ONTAP Controller NetApp ONTAP Controller
2. Mostrar la política:
  cat /sys/class/nvme-subsystem/nvme-subsys*/iopolicy
  Debe ver la siguiente salida:
```
round-robin
round-robin
```

Verifique que los espacios de nombres se hayan creado y detectado correctamente en el host:

nvme list

Muestra el ejemplo

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

Compruebe que el estado de la controladora de cada ruta sea activo y que tenga el estado de ANA correcto:

NVMe/FC

nvme list-subsys /dev/nvme1n1

Muestra el ejemplo

nvme-subsys1 - NQN=nqn.1992-08.com.netapp:sn.04ba0732530911ea8e8300a098dfdd91:subsystem.nvme_145_1
\
+- nvme2 fc traddr=nn-0x208100a098dfdd91:pn-0x208200a098dfdd91 host_traddr=nn-0x200000109b579d5f:pn-0x100000109b579d5f live non-optimized
+- nvme3 fc traddr=nn-0x208100a098dfdd91:pn-0x208500a098dfdd91 host_traddr=nn-0x200000109b579d5e:pn-0x100000109b579d5e live non-optimized
+- nvme4 fc traddr=nn-0x208100a098dfdd91:pn-0x208400a098dfdd91 host_traddr=nn-0x200000109b579d5e:pn-0x100000109b579d5e live optimized
+- nvme6 fc traddr=nn-0x208100a098dfdd91:pn-0x208300a098dfdd91 host_traddr=nn-0x200000109b579d5f:pn-0x100000109b579d5f live optimized

NVMe/TCP

nvme list-subsys /dev/nvme0n1

Muestra el ejemplo

nvme-subsys0 - NQN=nqn.1992-08.com.netapp:sn.37ba7d9cbfba11eba35dd039ea165514:subsystem.nvme_114_tcp_1
\
+- nvme0 tcp traddr=192.168.2.36 trsvcid=4420 host_traddr=192.168.1.4 live optimized
+- nvme1 tcp traddr=192.168.1.31 trsvcid=4420 host_traddr=192.168.1.4 live optimized
+- nvme10 tcp traddr=192.168.2.37 trsvcid=4420 host_traddr=192.168.1.4 live non-optimized
+- nvme11 tcp traddr=192.168.1.32 trsvcid=4420 host_traddr=192.168.1.4 live non-optimized
+- nvme20 tcp traddr=192.168.2.36 trsvcid=4420 host_traddr=192.168.2.5 live optimized
+- nvme21 tcp traddr=192.168.1.31 trsvcid=4420 host_traddr=192.168.2.5 live optimized
+- nvme30 tcp traddr=192.168.2.37 trsvcid=4420 host_traddr=192.168.2.5 live non-optimized
+- nvme31 tcp traddr=192.168.1.32 trsvcid=4420 host_traddr=192.168.2.5 live non-optimized

Confirmar que el complemento de NetApp muestra los valores correctos para cada dispositivo de espacio de nombres ONTAP:

Columna

nvme netapp ontapdevices -o column

Muestra el ejemplo

Device       Vserver          Namespace Path
---------    -------          --------------------------------------------------
/dev/nvme1n1 vserver_fcnvme_145 /vol/fcnvme_145_vol_1_0_0/fcnvme_145_ns

NSID  UUID                                   Size
-------  ------------------------------     --------------------
1      23766b68-e261-444e-b378-2e84dbe0e5e1  85.90GB

JSON

nvme netapp ontapdevices -o json

Muestra el ejemplo

{
"ONTAPdevices" : [
     {
       "Device" : "/dev/nvme1n1",
       "Vserver" : "vserver_fcnvme_145",
       "Namespace_Path" : "/vol/fcnvme_145_vol_1_0_0/fcnvme_145_ns",
       "NSID" : 1,
       "UUID" : "23766b68-e261-444e-b378-2e84dbe0e5e1",
       "Size" : "85.90GB",
       "LBA_Data_Size" : 4096,
       "Namespace_Size" : 20971520
     }
  ]
}

Paso 6: Revise los problemas conocidos

No hay problemas conocidos.

Configurar RHEL 8.4 para NVMe-oF con almacenamiento ONTAP

Creating your file...

Paso 1: Opcionalmente, habilite el arranque SAN

Paso 2: Verifique la versión del software y la configuración de NVMe

Paso 3: Configurar NVMe/FC o NVMe/TCP

Paso 4: Opcionalmente, habilite 1 MB de E/S para NVMe/FC

Paso 5: Validar NVMe-oF

Paso 6: Revise los problemas conocidos