文档目录

问题描述

在麒麟 V10 SP2 ARM 计算节点升级至 MLNX_OFED 5.8 LTS 后,网卡接口命名规则可能发生变化。接口名称由操作系统的 udev、内核和固件命名机制共同决定,因此节点重启后的网卡名称可能与升级前不同。

如果网桥、管理网络或存储网络配置继续引用原接口名称,相关网络配置可能需要重新确认和调整。

现象

  • 升级 MLNX_OFED 驱动并重启计算节点后,原网卡名称不存在或发生变化。
  • ip link 显示的 Mellanox 物理网卡名称与升级前不同。
  • 使用原接口名称的网桥、管理网络或存储网络可能无法正常启用。

影响

网卡名称变化可能影响依赖固定接口名称的管理网络、业务网络或存储网络配置,需要在驱动升级并重启后重新确认接口映射和网络状态。

规避方案

  1. 升级前记录每块 Mellanox 网卡的 MAC 地址、PCI 地址、当前接口名称及其网络用途。
  2. 备份计算节点网络配置,并为节点安排维护窗口。
  3. 根据 NVIDIA 对应 MLNX_OFED 版本文档和麒麟操作系统规范配置持久化接口命名规则。
  4. 升级后先核对网卡名称与 MAC/PCI 地址的对应关系,再恢复网桥和业务网络。
  5. 确认管理网络、存储网络和业务网络均正常后,再退出维护模式。

如果接口名称已变化,可依据升级前保存的 MAC/PCI 信息创建 udev 持久化命名规则。具体规则应由技术支持结合服务器 BIOS、麒麟版本和驱动版本确认,不建议直接复制其他环境的规则。

受影响产品

  • ZStack Cloud 4.8.x、5.4.x、5.5.x 中,使用麒麟 V10 SP2 ARM 计算节点并将 Mellanox 网卡驱动升级至 MLNX_OFED 5.8 LTS 的环境。
  • 其他操作系统、CPU 架构和 MLNX_OFED 版本组合不在本文确认范围内,应在升级前单独验证接口命名行为。

修复状态

  • 当前状态:已确认,已有规避方案。
  • 修复版本:无独立修复版本。
  • 关联补丁/修复包:无;通过升级前检查和持久化网卡命名规则规避。

关联信息

  • 关联 Solution/APAR:无。
  • 关联操作系统:麒麟 V10 SP2 ARM。
  • 关联 PDT/PTF:NVIDIA MLNX_OFED。
  • 关联 BBS/TIC/Jira:ZSTAC-74518。该编号用于问题追溯。受账号权限限制,部分用户可能无法访问跳转后的 Jira 页面。
  • 其他参考信息:NVIDIA MLNX_OFED Changes and New Features History。
麒麟 ARM 环境升级 Mellanox 驱动后网卡名称可能变化 | 产品已知问题 · KB | ZStack 资源中心