← 返回目录课程:《ConnectX-6 Lx固件升级与参数配置》
02

02 MFT工具链安装与mlxconfig命令行基础

掌握MFT工具安装、mlxconfig命令语法及设备识别方法
章节导航 难度:入门类型:工程实战
本页抓手

掌握Lx固件升级在MFT工具链安装与mlxconfig命令行基础中的定位、故障信号与验证顺序。

机制词
模块接口配置流程状态
可复用材料
代码片段排障表检查清单架构图

排障先看这三点

  1. 先核对MFT工具链安装的前置条件、异常信号和验收结果
  2. 再用伪代码把实现动作固定下来
  3. 最后用稳定性与可观测性验证结果是否可复现

源码证据

MFT工具链安装与mlxconfig命令行基础只有在出现源码、函数、脚本或 API 证据时,才需要进入代码层核对。

本节把Lx固件升级对应的调用关系、异常状态和复测证据放在一起检查。

环境准备:从零搭建 ConnectX-6 Lx 固件操作基础

MFT工具链安装中心对象与关键关系01环境搭建确认内核版本兼容性02版本选择匹配MFT与操作系统03依赖检查验证缺失库与工具04设备识别使用mlxconf…05命令语法掌握参数与设备定位06验收结果确认工具链可复现运行

MFT工具链安装的验收口径

在进行 ConnectX-6 Lx 固件升级与参数配置前,首要任务是构建一个可靠的本地操作环境。这并非简单的软件安装,而是建立一套可复现、可验证的工具链。本节的核心目标是掌握 Mellanox Firmware Tools(MFT)的安装流程,并熟练使用 mlxconfig 命令来识别设备和修改固件参数。我们将以真实工程现场为背景,逐步拆解从环境准备到设备识别的完整路径

真实项目场景

某数据中心计划对一批 ConnectX-6 Lx 网卡进行固件升级,以修复已知的 RoCE 性能问题。运维工程师需要在 Linux 服务器上部署 MFT 工具链,并通过 mlxconfig 命令批量修改网卡的 PCIe 配置参数。由于服务器操作系统版本各异(CentOS 7 / Ubuntu 20.04),且部分网卡处于生产状态,环境搭建的稳定性和命令执行的准确性直接决定了升级窗口的时长与风险

MFT 工具链安装:版本选择与依赖检查

MFT 是 NVIDIA 官方提供的固件管理工具集,包含 mlxconfig、flint、mlxfwmanager 等核心组件。安装前必须确认操作系统内核版本与 MFT 版本的兼容性,这是环境搭建的第一个关键检查点

首先,从 NVIDIA 官方仓库下载对应操作系统的 MFT 包。以 Linux x86_64 为例,推荐使用 RPM 或 DEB 包进行安装,避免源码编译带来的依赖问题。安装命令如下:

# 对于 CentOS/RHEL 7/8
sudo yum install -y mft-4.24.0-100.x86_64.rpm
# 对于 Ubuntu/Debian
sudo dpkg -i mft-4.24.0-100_amd64.deb
sudo apt-get install -f

阅读这段代码时,重点看MFT工具链安装的伪代码,以及它如何用稳定性与可观测性证明结果可复测。

安装完成后,必须执行 mst start 命令启动 MFT 服务。这是一个极易被忽略的步骤,若服务未启动,后续所有 mlxconfig 命令都将返回“设备未找到”的错误。启动后,通过 mst status 验证服务状态,确认输出中包含“MST modules loaded”字样

实操步骤

安装后立即执行 mst start 并检查 mst status 输出。若服务启动失败,检查内核模块 mst_pci 和 mst_pciconf 是否被安全策略阻止加载

设备识别与 mlxconfig 命令语法

环境就绪后,下一步是准确识别目标设备。ConnectX-6 Lx 网卡在系统中可能以多个 PCI 设备形式存在,错误的设备选择会导致配置写入失败或影响其他网卡

使用 mst status -v 命令列出所有被 MFT 识别的设备。输出中会显示每个设备的 Bus:Device.Function(BDF)地址和固件类型。例如:

DEVICE_TYPE MST PCI RDMA NET NUMA ConnectX6LX /dev/mst/mt4125_pciconf0 04:00.0 mlx5_0 ens1f0 0

这里的 /dev/mst/mt4125_pciconf0 就是后续 mlxconfig 命令需要操作的设备路径。确认设备后,即可使用 mlxconfig 命令进行参数查询与修改。其基础语法为:

参数修改后,必须执行 mlxconfig reset 或重启服务器才能使新配置生效。这是一个重要的判断标准:若未执行重置操作,修改后的参数将停留在暂存区,不会写入固件

关键判断

使用 mlxconfig query 输出的参数列表,必须与目标固件版本支持的参数表进行比对。例如,ConnectX-6 Lx 的固件版本低于 20.32.1000 时,可能不支持 NUM_OF_VFS 参数的动态调整