Skip to main content
ONTAP SAN Host Utilities
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

使用ONTAP儲存為 NVMe-oF 設定 RHEL 8.7

貢獻者 netapp-sarajane
PDF

Red Hat Enterpirse Linux (RHEL) 主機支援具有非對稱命名空間存取 (ANA) 的 NVMe over Fibre Channel (NVMe/FC) 和 NVMe over TCP (NVMe/TCP) 協定。 ANA 提供與 iSCSI 和 FCP 環境中的非對稱邏輯單元存取 (ALUA) 等效的多路徑功能。

了解如何為 RHEL 8.7 設定 NVMe over Fabrics (NVMe-oF) 主機。有關更多支援和功能信息，請參閱"NVME-oF 概述"。

RHEL 8.7 的 NVMe-oF 有以下已知限制：

  • 目前不支援使用 NVMe-oF 協定的 SAN 啟動。

  • 預設情況下，RHEL 8.7 中的 NVMe-oF 主機上會停用核心 NVMe 多路徑；您必須手動啟用它。

  • 由於已知問題，NVMe/TCP 可作為技術預覽。

步驟 1 ：選擇性啟用 SAN 開機

您可以設定主機以使用 SAN 啟動來簡化部署並提高可擴充性。使用"互通性對照表工具"驗證您的 Linux 作業系統、主機匯流排適配器 (HBA)、HBA 韌體、HBA 啟動 BIOS 和ONTAP版本是否支援 SAN 啟動。

步驟

  1. "建立 NVMe 命名空間並將其對應到主機" 。

  2. 在伺服器 BIOS 中為 SAN 啟動命名空間對應到的連接埠啟用 SAN 啟動。

    如需如何啟用HBA BIOS的相關資訊、請參閱廠商專屬的文件。

  3. 重新啟動主機並驗證作業系統是否已啟動並正在運行。

步驟 2：驗證軟體版本和 NVMe 配置

檢查您的系統是否符合軟體要求並驗證 NVMe 套件安裝和主機配置。

步驟

  1. 在伺服器上安裝 RHEL 8.7。安裝完成後，請驗證您是否正在執行所需的 RHEL 8.7 核心：

    uname -r

    RHEL 核心版本範例：

    4.18.0-425.3.1.el8.x86_64

  2. 安裝「NVMe-CLI（NVMe - CLI）套件：

    rpm -qa|grep nvme-cli

    以下範例顯示了 nvme-cli 軟體包版本：

    nvme-cli-1.16-5.el8.x86_64

  3. 安裝 libnvme 套件：

    rpm -qa|grep libnvme

    以下範例顯示了 libnvme 軟體包版本：

    libnvme-1.2-3.el8.x86_64

  4. 啟用核心內建NVMe多重路徑：

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

  5. 在 RHEL 8.7 主機上，檢查 hostnqn`字串位於 `/etc/nvme/hostnqn：

    cat /etc/nvme/hostnqn

    下面的例子展示了 `hostnqn`版本：

    nqn.2014-08.org.nvmexpress:uuid:a7f7a1d4-311a-11e8-b634-7ed30aef10b7

  6. 驗證 `hostnqn`字串匹配 `hostnqn`ONTAP儲存系統上對應子系統的字串：

    ::> vserver nvme subsystem host show -vserver vs_nvme167
    顯示範例 
    Vserver     Subsystem          Host NQN
----------- --------------- ----------------------------------------------------------
vs_nvme167   rhel_167_LPe35002    nqn.2014-08.org.nvmexpress:uuid:a7f7a1d4-311a-11e8-b634-7ed30aef10b7
    註 如果 `hostnqn`字串不匹配，請使用 `vserver modify`命令來更新 `hostnqn`對應ONTAP儲存系統子系統上的字串以匹配 `hostnqn`字串來自 `/etc/nvme/hostnqn`在主機上。

  7. 重新啟動主機。

    註

    為了在同一台主機上執行 NVMe 和 SCSI 流量， NetApp建議對ONTAP命名空間使用核心 NVMe 多路徑，對ONTAP LUN 使用 dm-multipath。為了防止 dm-multipath 聲明ONTAP命名空間設備，請透過添加 `enable_foreign`設定為 `/etc/multipath.conf`文件：

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

  8. 執行「stystemctl重新啟動多路徑d」來重新啟動多路徑精靈。

步驟 3：設定 NVMe/FC 和 NVMe/TCP

使用 Broadcom/Emulex 或 Marvell/QLogic 適配器配置 NVMe/FC，或使用手動發現和連接操作來設定 NVMe/TCP。

FC——Broadcom/Emulex

為 Broadcom / Emulex 介面卡設定 NVMe / FC 。

步驟

  1. 確認您使用的是支援的介面卡機型：

    1. 顯示模型名稱：

      cat /sys/class/scsi_host/host*/modelname

      您應該會看到類似以下範例的輸出：

      LPe35002-M2
LPe35002-M2

    2. 顯示模型描述：

      cat /sys/class/scsi_host/host*/modeldesc

      您應該會看到類似以下範例的輸出：

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

  2. 驗證您使用的是建議的Broadcom lpfc 韌體與收件匣驅動程式：

    1. 顯示韌體版本：

      cat /sys/class/scsi_host/host*/fwrev

      該命令返回韌體版本：

      14.0.505.12, sli-4:6:d
14.0.505.12, sli-4:6:d

    2. 顯示收件匣驅動程式版本：

      cat /sys/module/lpfc/version

      以下範例顯示了驅動程式版本：

      0:14.0.0.15

    如需支援的介面卡驅動程式和韌體版本的最新清單，請參閱"互通性對照表工具"。

  3. 請確認 lpfc_enable_fc4_type 設為 3：

    cat /sys/module/lpfc/parameters/lpfc_enable_fc4_type

  4. 確認您可以檢視啟動器連接埠：

    cat /sys/class/fc_host/host*/port_name

    您應該會看到類似以下範例的輸出：

    0x100000109b95467c
0x100000109b95467b

  5. 驗證啟動器連接埠是否在線上：

    cat /sys/class/fc_host/host*/port_state

    您應該會看到下列輸出：

    Online
Online

  6. 確認已啟用 NVMe / FC 啟動器連接埠、且目標連接埠可見：

    cat /sys/class/scsi_host/host*/nvme_info
    顯示範例 
    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

為 Marvell/QLogic 介面卡設定 NVMe / FC 。

步驟

  1. 驗證您使用的適配器驅動程式和韌體版本是否受支援：

    cat /sys/class/fc_host/host*/symbolic_name

    以下範例顯示了驅動程式和韌體版本：

    QLE2772 FW:v9.08.02 DVR:v10.02.07.400-k-debug
QLE2772 FW:v9.08.02 DVR:v10.02.07.400-k-debug

  2. 請確認 ql2xnvmeenable 已設定。這可讓 Marvell 介面卡作為 NVMe / FC 啟動器運作：

    cat /sys/module/qla2xxx/parameters/ql2xnvmeenable

    預期輸出為 1 。

TCP

NVMe/TCP 協定不支援自動連線操作。相反，您可以透過執行 NVMe/TCP 來發現 NVMe/TCP 子系統和命名空間 `connect`或者 `connect-all`手動操作。

步驟

  1. 檢查啟動器連接埠是否可以跨支援的 NVMe/TCP LIF 取得發現日誌頁面資料：

    nvme discover -t tcp -w host-traddr -a traddr
    顯示範例 
    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 ~]#

  2. 確認其他的 NVMe / TCP 啟動器目標 LIF 組合可以成功擷取探索記錄頁面資料：

    nvme discover -t tcp -w host-traddr -a traddr
    顯示範例 
    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

  3. 執行 nvme connect-all 跨所有節點支援的 NVMe / TCP 啟動器目標生命體執行命令：

    nvme connect-all -t tcp -w host-traddr -a traddr -1 1800
    顯示範例 
    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

步驟 4：（可選）為 NVMe/FC 啟用 1MB I/O

ONTAP在識別控制器資料中報告最大資料傳輸大小 (MDTS) 為 8。這意味著最大 I/O 請求大小可達 1MB。若要向 Broadcom NVMe/FC 主機發出 1MB 大小的 I/O 要求，您應該會增加 `lpfc`的價值 `lpfc_sg_seg_cnt`參數從預設值 64 更改為 256。

註 這些步驟不適用於 Qlogic NVMe / FC 主機。
步驟

  1. 將 `lpfc_sg_seg_cnt`參數設定為 256 ：

    cat /etc/modprobe.d/lpfc.conf

    您應該會看到類似以下範例的輸出：

    options lpfc lpfc_sg_seg_cnt=256

  2. 執行 `dracut -f`命令，然後重新啟動主機。

  3. 確認的值 `lpfc_sg_seg_cnt`為 256 ：

    cat /sys/module/lpfc/parameters/lpfc_sg_seg_cnt

步驟 5：驗證 NVMe-oF

驗證核心內建 NVMe 多重路徑狀態， ANA 狀態和 ONTAP 命名空間是否適用於 NVMe 組態。

步驟

  1. 確認已啟用核心內建 NVMe 多重路徑：

    cat /sys/module/nvme_core/parameters/multipath

    您應該會看到下列輸出：

    Y

  2. 驗證個別 ONTAP 命名空間的適當 NVMe 設定（例如、模型設定為 NetApp ONTAP 控制器、負載平衡 iopolicing 設定為循環）是否正確反映在主機上：

    1. 顯示子系統：

      cat /sys/class/nvme-subsystem/nvme-subsys*/model

      您應該會看到下列輸出：

      NetApp ONTAP Controller
NetApp ONTAP Controller

    2. 顯示策略：

      cat /sys/class/nvme-subsystem/nvme-subsys*/iopolicy

      您應該會看到下列輸出：

    round-robin
round-robin

  3. 確認已在主機上建立並正確探索命名空間：

    nvme list
    顯示範例 
    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

  4. 確認每個路徑的控制器狀態均為有效、且具有正確的ANA狀態：

    nvme list-subsys /dev/nvme1n1
    顯示範例 
    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

  5. 驗證NetApp外掛程式是否顯示每ONTAP 個版本名稱空間裝置的正確值：

    欄位
    nvme netapp ontapdevices -o column
    顯示範例 
    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
    顯示範例 
    {

  "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
    },

]

}

步驟 6 ：檢閱已知問題

這些是已知問題：

NetApp錯誤ID 標題 說明

"1479047"

RHEL 8.7 NVMe-oF 主機建立重複的持久發現控制器 (PDC)

在 NVMe-oF 主機上，您可以使用「nvme discover -p」指令建立 PDC。使用此命令時，每個啟動器-目標組合只能建立一個 PDC。但是，如果您在 NVMe-oF 主機上執行 RHEL 8.8，則每次執行「nvme discover -p」時都會建立重複的 PDC。這會導致主機和目標上資源的不必要使用。