【RDMA命令系列之】如何安装Mellanox固件管理工具MFT以及RPM包中的66条命令？（Mellanox Firmware Tools：mlxconfig、mlxreg、mst、mstdump）

1. 要点

• MFT：NVIDIA(Mellanox) Firmware Tools (MFT)
• MFT官网下载路径：https://network.nvidia.com/products/adapter-software/firmware-tools/
• 常用诸如flint、mlxburn、mlxconfig、mlxdump、mlxlink、mlxpci、mlxreg、mlxtrace、mst、mstdump命令都是MFT提供的，如果没有需要安装MFT相关的rpm包

2. MFT tools包含的四类tool

3. MFT版本信息

Type	e.g	Recnet Release Time	Link
4.27.0	4.27.0-83	February 8, 2023	https://docs.nvidia.com/networking/display/mftv4270/release+notes
4.26.1-LTS	4.26.1	December 11, 2023	https://docs.nvidia.com/networking/display/mftv4261lts/release+notes
4.22.1-406-LTS	4.22.1-406	December 31, 2023	https://docs.nvidia.com/networking/display/mftv4221406lts/release+notes
其他
4.26.0	4.26.0	November 5, 2023	https://docs.nvidia.com/networking/display/mftv4260/release+notes
4.25.0	4.25.0	August 7, 2023	https://docs.nvidia.com/networking/display/mftv4250/release+notes
4.24
4.23
4.22	4.22.0	October 31, 2022	https://docs.nvidia.com/networking/display/mftv422/release+notes
4.21
4.20
4.18	4.18.0	December 05, 2021	https://docs.nvidia.com/networking/display/mftv4180/release+notes
4.17
4.16
4.15
4.14
4.13

4. MFT工具依赖的软件

来源：https://network.nvidia.com/related-docs/MFT/Mellanox_MFT_EULA.pdf

5. MFT下载安装实操

5.1 下载：假设使用最新版本

wget https://www.mellanox.com/downloads/MFT/mft-4.27.0-83-x86_64-rpm.tgz

实操效果：

5.2 安装RPM包

可以直接rpm方式安装，也可以使用提供的install.sh脚本安装。、
install.sh脚本方式：

sh mft-4.32.0-120-x86_64-rpm/install.sh

实操：

rpm方式

tar -xvf mft-4.27.0-83-x86_64-rpm.tgz
cd mft-4.27.0-83-x86_64-rpm/
tree
cd RPMS
rpm -ivh mft*.rpm
yum install -y libpcap-devel

查看包内容：

5.2.1 错误处理

安装过程中需要依赖相关包根据情况安装：

• error: Failed dependencies: libpcap-devel is needed by mft-pcap-4.27.0-83.x86_64
  解决办法：

yum install -y libpcap-devel

• /bin/ld: cannot find -lpython3.6m
  解决办法：

rpm -e mft-pcap-4.27.0-83.x86_64 #先卸载mft-pcap 其他的包已经安装好了只用处理这一个
update #更新locate数据库
locate 
locate libpython3.6m #根据输出，将ld连接时候找的libxxx的1.0版本链接到对应lib库
cd /usr/lib64
ln -s /usr/lib64/libpython3.6m.so.1.0 /usr/lib64/libpython3.6m.so #注意这个是要点，以及这里需要添加lib前缀和so后缀

解决前后效果：

解决后：

5.3 安装完成后可以检索一些命令是否属于某个rpm包：

[root@localhost RPMS]# rpm -qf `which mlxburn`
mft-4.27.0-83.x86_64

6 查看MFT四个rpm包主要命令

6.1 (1) mft-4.27.0-83.x86_64.rpm 主要命令

rpm -ql mft-4.27.0-83.x86_64.rpm |grep -Ev 'lib|share|include'

可以看到很多常见的命令

6.2 (2) mft-autocomplete-4.27.0-83.x86_64.rpm 补全

rpm -ql mft-autocomplete-4.27.0-83.x86_64.rpm 

做自动补全命令用的

6.3 (3) mft-oem-4.27.0-83.x86_64.rpm OEM厂商使用的命令（不重要）

rpm -ql mft-oem-4.27.0-83.x86_64.rpm

提供给OEM进行操作的命令，包括cpld更新、格式转换等

6.4 (4) mft-pcap-4.27.0-83.x86_64.rpm 抓包相关

rpm -ql mft-pcap-4.27.0-83.x86_64.rpm

前面安装时候解压后自动编译了：

7. MFT4个安装包包括的所有命令

7.1 包括的所有命令

[root@localhost RPMS]# rpm -ql ./* | grep bin|sort
/usr/bin/cpldupdate
/usr/bin/dimax_init
/usr/bin/flint
/usr/bin/flint_ext
/usr/bin/flint_oem
/usr/bin/fwtrace
/usr/bin/i2c
/usr/bin/mcra
/usr/bin/mdevices_info
/usr/bin/mft-shell
/usr/bin/mft_uninstall.sh
/usr/bin/mget_temp
/usr/bin/mget_temp_ext
/usr/bin/mic
/usr/bin/minit
/usr/bin/mlxarchive
/usr/bin/mlxburn
/usr/bin/mlxburn_old
/usr/bin/mlxcableimgen
/usr/bin/mlxcables
/usr/bin/mlxcables_ext
/usr/bin/mlxconfig
/usr/bin/mlxdpa
/usr/bin/mlxdump
/usr/bin/mlxdump_ext
/usr/bin/mlxfwmanager
/usr/bin/mlxfwreset
/usr/bin/mlx_fwsfx_gen
/usr/bin/mlxfwstress
/usr/bin/mlxfwstress_ext
/usr/bin/mlxgearbox
/usr/bin/mlxi2c
/usr/bin/mlxlink
/usr/bin/mlxlink_ext
/usr/bin/mlxlink_plane_wrapper
/usr/bin/mlxmcg
/usr/bin/mlxmdio
/usr/bin/mlx_mfa_gen
/usr/bin/mlxpci
/usr/bin/mlxphyburn
/usr/bin/mlxprivhost
/usr/bin/mlxreg
/usr/bin/mlxreg_ext
/usr/bin/mlx_sfx_stub
/usr/bin/mlxtokengenerator
/usr/bin/mlxtrace
/usr/bin/mlxtrace_ext
/usr/bin/mlxuptime
/usr/bin/mlxvpd
/usr/bin/mremote
/usr/bin/mst
/usr/bin/mst_cable
/usr/bin/mstdump
/usr/bin/mst_ib_add
/usr/bin/mstop
/usr/bin/mst_retimer
/usr/bin/mtserver
/usr/bin/nvjtag_discovery
/usr/bin/pckt_drop
/usr/bin/resourcedump
/usr/bin/resourceparse
/usr/bin/stedump
/usr/bin/sysfs_module_com
/usr/bin/t2a
/usr/bin/wqdump
/usr/bin/wqdump_ext

7.2 其中最常用的几个命令：

/usr/bin/flint
/usr/bin/mlxburn
/usr/bin/mlxconfig
/usr/bin/mlxdump
/usr/bin/mlxlink
/usr/bin/mlxpci
/usr/bin/mlxreg
/usr/bin/mlxtrace
/usr/bin/mst
/usr/bin/mstdump
相关命令作用、场景与用法后期再通过其他文档更新。

其他

• 注意所以MFT提供的Mellanox的命令前缀都是mlx开头的，比如mlxconfig。
• 另外Mellanox还有一些命令是mlnx开头的，这些命令肯定不是MFT的，一般都是在mellanox driver中提供的，比如mlnx_qos、mlnx_perf、mlnx_affinity等

参考链接

https://docs.nvidia.com/networking/display/mftv4250
https://network.nvidia.com/related-docs/MFT/Mellanox_MFT_EULA.pdf