SNAP-3 发行说明

发行说明页面提供有关 NVIDIA® BlueField®-2 SNAP 软件的信息，例如变更和新功能、软件已知问题和错误修复。

变更和新功能

版本 3.8.0-8 中的主要功能

处理主机 FLR 请求的改进和错误修复

已知问题

以下是此 NVMe/virtio-blk SNAP 软件版本的已知限制。

参考 #	问题
–	描述：在 DPU Arm 内核上运行 64K 页面大小内核时（CentOS 8.x、Rocky 8.x 或 openEuler 20.x 的情况），当前不支持 NVMeTCP XLIO。
	解决方法：不适用
	关键词：64K 页面大小；NVMeTCP XLIO
	发现于版本：3.6.0
–	描述：当并行运行 virtio-blk 和 virtio-net 协议时，性能可能会受到负面影响。
	解决方法：不适用
	关键词：性能
	发现于版本：3.7.2
2957317	描述：由于某些 Linux 内核发行版中存在的上游内核错误，命令 `emulation_device_detach` 超时，这会导致任何正在进行的流量挂起。
	解决方法：建议在执行热插拔之前，确保设备上的所有正在进行的流量都已停止。
	关键词：PCIe 热插拔
	发现于版本：3.6.0
3046440	描述：NVMe 完全卸载模式在第一代 BlueField SoC 上无法正常工作
	解决方法：不适用
	关键词：NVMe 完全卸载模式
	发现于版本：3.6.0
2879262	描述：由于某些 Linux 内核发行版中存在的内核错误，配置大量 virtio 队列以及少量 MSIX 可能会导致内核软锁定（除了导致严重的性能下降之外）。
	解决方法：建议将 virtio-blk 控制器的 `--num_queues` 值保持在 `snap_rpc.py controller_virtio_blk_create` 中，该值小于 `VIRTIO_BLK_EMULATION_NUM_MSIX` 的值（通过 `mlxconfig` 配置）。
	关键词：Virtio-blk；内核挂起
	发现于版本：3.6.0
–	描述：SPDK 多路径仅支持 NVMe over RDMA（不支持 NVMe over TCP）。
	解决方法：不适用
	关键词：SPDK；NVMe
	发现于版本：3.6.0
3055119	描述：Windows 驱动程序不适用于 Virtio-blk SNAP-Direct 功能。
	解决方法：要在 Windows 操作系统上工作时禁用该功能，用户必须在 `/etc/default/mlnx_snap` 中设置 `VIRTIO_BLK_SNAP_ZCOPY=0`。
	关键词：Windows
	发现于版本：3.5.0
–	描述：当在完全卸载模式配置中使用 SNAP 时，无法获得 NVMe 多路径功能
	解决方法：不适用
	关键词：NVMe 完全卸载模式；多路径
	发现于版本：3.4.0
–	描述：每次 PCIe 设备热插拔后，必须立即打开匹配的控制器。具体而言，在创建控制器之前热拔设备可能会导致某些 Linux 发行版上的主机内核驱动程序发生故障。
	解决方法：不适用
	关键词：热插拔；控制器
	发现于版本：3.3.0
–	描述：不支持热插拔 PF 上的 SR-IOV
	解决方法：不适用
	关键词：PCIe 热插拔
	发现于版本：3.2.0
–	描述：暴露给主机的任何 PCIe 模拟设备都必须在其上打开一个匹配的控制器，然后在加载其内核驱动程序之前在 mlnx_snap 服务中打开。这包括 virtio-net 设备。
	解决方法：不适用
	关键词：VF；PF；virtio-net；内核驱动程序
	发现于版本：3.1.0
–	描述：无法将使用相同 nsid 的块设备附加到链接到同一 NVMe 子系统的不同 NVMe 控制器。例如，以下命令将导致错误，因为两个控制器都附加了 NSID 1 复制已复制！ `snap_rpc.py controller_nvme_namespace_attach NvmeEmu2pf0 spdk Null0 1 snap_rpc.py controller_nvme_namespace_attach NvmeEmu2pf1 spdk Null1 1`
	解决方法：不适用
	关键词：块设备；控制器
	发现于版本：3.0.0
–	描述：mlnx_snap NVMe 控制器支持面向主机的最大大小为 1024 的管理队列。
	解决方法：不适用
	关键词：管理队列；控制器
	发现于版本：3.0.0
–	描述：DPU 扩展 ROM 包括 NVIDIA 认证的 NVMe 和 virtio-blk UEFI 驱动程序，BIOS 应使用这些驱动程序。不保证任何其他 BIOS 驱动程序都能正常工作。
	解决方法：不适用
	关键词：BIOS；认证驱动程序
	发现于版本：3.0.0
–	描述：不支持传统中断。
	解决方法：不适用
	关键词：块设备；控制器
	发现于版本：3.0.0

Windows 操作系统已知问题

注意

以下不是 BlueField SNAP 限制。

参考 #	问题
3543249	描述：当使用热插拔 PCIe 设备时，在插入所有设备后，必须重新启动主机，Windows 才能检测到所有设备。
	解决方法：不适用
	关键词：热插拔
	发现于版本：3.7.4
3521378	描述：为了成功执行 `emulation_device_detach` RPC 命令，建议将 `directio=1` (`O_DIRECT`) 与在热插拔模拟上创建的 virtio-blk 控制器一起使用。注意如果使用 `directio=0`，则必须手动停止 IO。否则，`emulation_device_detach` 可能会失败。
	解决方法：不适用
	关键词：Virtio-blk；RPC
	发现于版本：3.7.4
2957317	描述：在裸机上设置 virtio-blk 模拟将导致服务器崩溃。
	解决方法：使用以下 RPC 将 virtio-blk 控制器的 `seg_max` 标志设置为至少 16（默认值为 1）复制已复制！ `controller_virtio_blk_create … --seg_max 16`
	关键词：Virtio-blk；裸机；seg_max
	发现于版本：3.7.2
3056533	描述：当在 Windows 中使用 NVMe 驱动程序时，如果 I/O 未在超过 120 秒内完成，Windows 将开始忽略 NVMe 设备，并且其磁盘将消失。
	解决方法：不适用
	关键词：NVMe 设备消失
	发现于版本：3.6.1
不适用	描述：存在一个 Windows 驱动程序的已知问题，即同时附加多个命名空间时可能会崩溃。用户必须逐个附加命名空间，并验证每个命名空间是否被操作系统发现，然后再附加新的命名空间。
	解决方法：不适用
	关键词：同时附加多个命名空间
	发现于版本：3.4.0
不适用	描述：存在一个已知的 Windows NVMe 驱动程序错误，如果 NVMe 驱动程序启动但没有目标启动并准备就绪，则会导致 Windows 启动器崩溃。因此，如果用户在模拟 NVMe 设备之上使用 Windows 操作系统，他们必须确保 mlnx_snap NVMe 控制器在主机端运行驱动程序之前已连接到远程目标。
	解决方法：不适用
	关键词：Windows 启动器崩溃
	发现于版本：3.1.0
不适用	描述：存在一个已知的 Windows 驱动程序错误，其中不支持命名空间热插拔。在较新的 Windows 版本上，NVMe 控制器 quirks 必须设置为 0x5。有关更多信息，请参阅“控制器参数”部分。
	解决方法：不适用
	关键词：命名空间热插拔
	发现于版本：3.1.0

NVMe Linux 驱动程序限制

参考 #	问题
-	描述：当将 SRIOV 与与其 PF 共享同一驱动程序的 VF 一起使用时 (sriov_driver_autoprobe=1)，取消探测驱动程序可能需要很长时间，并且某些管理命令可能会超时
	解决方法：不适用
	关键词：SRIOV；驱动程序。
	发现于版本：3.8.0-8

Virtio-blk Linux 驱动程序限制

参考 #	问题
3066750	描述：驱动程序不支持 PCIe 功能级别重置 (FLR)。在 IO 期间运行 FLR 会导致 IO（和内核）挂起。
	解决方法：不适用
	关键词：PCIe 功能；挂起
	发现于版本：3.6.1
2879262	描述：当在单个 MSIX 上使用大量 virtqueue (≥ 64) 时，主机内核可能会遇到软锁定。具体而言，将 `--num_queues` 设置为较高的数字，该数字也高于配置的 `--num_msix` 值，可能会导致此问题。
	解决方法
	关键词：内核；挂起；virtqueue
	发现于版本：3.6.1
2957317	描述：在 Linux 内核版本 5.4.0-91-generic 及更高版本中，如果 I/O 流量正在运行，则命令 `emulation_device_detach` 超时。
	解决方法：不适用
	关键词：命令超时
	发现于版本：3.6.1

Virtio-blk 过渡设备限制

参考 #	问题
3231721	描述：当使用 `emulation_device_attach` RPC 热插拔 virtio-blk 过渡设备时，必须为此热插拔 virtio-blk 过渡设备提供容量和块大小属性。
	解决方法：使用 `--bdev_type spdk` 和 `--bdev spdk_bdev` 选项，在使用 `emulation_device_attach` RPC 时，为热插拔 virtio-blk 过渡设备提供 bdev。
	关键词：热插拔 virtio-blk 过渡设备
	发现于版本：3.7.0
–	描述：传统/过渡驱动程序在驱动程序初始化时不需要与设备同步。因此，强烈建议在驱动程序开始运行之前，在 PCIe 功能上打开 SNAP 控制器。如果驱动程序在控制器之前开始运行，则控制器配置选项将非常有限。
	解决方法：不适用
	关键词：传统；SNAP 控制器；SNAP 驱动程序
	发现于版本：3.7.0
–	描述：传统/过渡设备支持自然包括具有 512B 块大小的后端。仅当在驱动程序激活之前打开 SNAP 控制器时，才能实现使用任何其他块大小（例如 4K）的后端。
	解决方法：不适用
	关键词：传统；后端块大小
	发现于版本：3.7.0