Skip to main content

安装 S4000/S5000 5.1.0

本文档介绍如何在服务器系统上安装 Linux Server Driver，支持在线安装（APT）和离线安装两种方式。按照本文档完成操作后，您可以完成驱动安装并验证驱动是否正常生效。

概览​

平台支持​

MTT S5000​

CPU操作系统版本包类型
Intel(R) Xeon(R) Gold 6430AlinuxAlibaba Cloud Linux 3RPM
Intel(R) Xeon(R) Gold 6430TencentOS ServerTencentOS Server 4.4RPM
Hygon C86-4GKylin Linux Advanced ServerV10/V11RPM
Intel(R) Xeon(R) Gold 6430VesselOSVesselOS 1.0 SP1RPM
INTEL(R) XEON(R) GOLD 6530openEuler22.03RPM
INTEL(R) XEON(R) GOLD 6430
Hygon C86-4G
AMD EPYC 9T34 64-Core		Ubuntu Server22.04DEB
INTEL(R) XEON(R) GOLD 6430DebianDebian GNU/Linux 12DEB

MTT S4000​

CPU操作系统版本包类型
Intel(R) Xeon(R) Gold 6430Ubuntu Server22.04DEB
Hygon C86-4GUbuntu Server22.04DEB
Hygon C86-4GopenEuler24.03RPM

安装包说明​

根据系统架构和包管理系统选择合适的安装包：

架构系统类型安装包
x86_64Debian/Ubuntumusa_5.1.0-server_amd64.deb
x86_64RPM 系musa_5.1.0-server_amd64.rpm

安装流程​

建议按以下顺序完成安装。下表列出了主要步骤及其说明：

步骤操作说明是否必需
1安装前准备安装依赖并确认系统已识别显卡是
2安装驱动根据平台和安装方式完成驱动安装是
3安装后配置配置用户组权限并验证驱动是否正常生效建议
4不重启更换驱动适用于特殊场景下的驱动更换流程按需
5安装 MUSA Toolkit如需继续使用开发工具链，可继续安装 Toolkit按需

安装前准备​

1. 依赖安装​

对于 Ubuntu/Debian 系统，本节依赖安装主要适用于离线安装方式。如果您选择在 Ubuntu 系统中使用在线安装（APT）方式，可跳过本节，直接前往 Ubuntu Server 中的“在线安装（APT）”章节。

Ubuntu/Debian 系统（离线安装适用）​

# 安装依赖
sudo apt install -y clang libclang-dev libelf-dev gcc-multilib freeglut3-dev build-essential libx11-dev libxmu-dev libxi-dev libgl1-mesa-glx libglu1-mesa libglu1-mesa-dev libglew-dev libglfw3 libglfw3-dev libfreeimage3 libfreeimage-dev libtiff-dev libboost-all-dev ninja-build cmake ocl-icd-opencl-dev libglew-dev libnuma-dev
sudo apt install -y python3-pip libstdc++-12-dev
sudo apt -y install python-is-python3
sudo apt install -y python3-pip
sudo pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple allure-pytest pandas paramiko ahocorapy

# 安装 dkms
sudo apt install -y dkms

RPM 系统 (Alinux/OpenEuler/TencentOS/Kylin)​

# 查看 PCI 是否识别到显卡
sudo lspci -nn | grep -E " 1ed5 | Moore "

# 安装 dkms（若已安装请忽略）
sudo dnf -y install dkms
# 或
sudo yum -y install dkms

2. 验证显卡识别​

安装驱动前，确认系统已识别到显卡：

sudo lspci -nn | grep -E " 1ed5 | Moore "

安装驱动​

Ubuntu Server​

适用于 Ubuntu Server 22.04 和 Debian 12 的离线 DEB 安装方式。

步骤 1：卸载旧版本（如已安装）​

# 卸载旧 musa deb 包
sudo dpkg -P musa

# 卸载 mtgpu 模块
sudo modprobe -rv  mtgpu
# 如果报错 mtgpu is in use，请重启系统

# 查询是否仍有 mtgpu 模块残留
lsmod | grep mtgpu

步骤 2：安装驱动​

# 安装 MT DDK 驱动
sudo dpkg -i musa_5.1.0-server_amd64.deb

步骤 3：重启系统​

sudo reboot

TencentOS Server / Kylin Linux (RPM 包)​

步骤 1：卸载旧版本（如已安装）​

# 卸载旧 musa rpm 包
sudo rpm -e musa

# 卸载 mtgpu 模块
sudo rmmod mtgpu
# 如果报错 mtgpu is in use，请重启系统

# 查询是否仍有 mtgpu 模块残留
lsmod | grep mtgpu

步骤 2：安装驱动​

# x86_64 架构
sudo rpm -ivh musa_5.1.0-server_amd64.rpm

步骤 3：重启系统​

sudo reboot

安装后配置​

1. 设置用户组权限​

非 Root 用户如需获取设备使用权限，需要将用户添加到 render 和 video 组：

# 把普通用户账号加入 render 和 video 组
sudo usermod -aG render ${USER}
sudo usermod -aG video ${USER}

修改权限后需要重新登录账户使更改生效。

2. 验证安装​

方式一：使用 mthreads-gmi 工具​

mthreads-gmi

该命令将显示 GPU 状态信息，包括设备型号、驱动版本、显存使用等。

方式二：检查驱动模块​

# 检查驱动模块是否加载
lsmod | grep mtgpu

预期输出应包含 mtgpu 模块。

方式三：查看驱动版本​

# 离线 DEB 安装方式
sudo dpkg -s musa

# 在线 APT 安装方式
sudo dpkg -s mthreads-driver

# RPM 系统
sudo rpm -qi musa

方式四：检查显卡识别​

sudo lspci -nn | grep -E " 1ed5 | Moore "

应能看到摩尔线程显卡设备。

不重启更换驱动​

特殊情况下如需在不重启系统的情况下更换驱动：

步骤 1：卸载旧驱动​

# Ubuntu 在线安装（APT）方式
sudo apt remove mthreads-driver

# DEB 系统
sudo dpkg -P musa

# RPM 系统
sudo rpm -e musa

步骤 2：卸载驱动模块​

# 卸载 mtgpu 模块
sudo modprobe -rv mtgpu

# 验证是否成功卸载
lsmod | grep mtgpu

步骤 3：安装新驱动​

# Ubuntu 在线安装（APT）方式
sudo apt install mthreads-driver

# DEB 系统
sudo dpkg -i musa_5.1.0-server_amd64.deb

# RPM 系统
sudo rpm -ivh musa_5.1.0-server_amd64.rpm

步骤 4：重新加载驱动模块​

# 重新加载 kmd
sudo modprobe -v mtgpu

# 验证是否成功加载
lsmod | grep mtgpu

常见问题​

Q1: 安装失败 - 依赖问题
# DEB 系统
sudo apt --fix-broken install
sudo dpkg -i musa_5.1.0-server_amd64.deb

# RPM 系统
sudo dnf install -y <缺失的依赖包>
sudo rpm -ivh musa_5.1.0-server_amd64.rpm
Q2: 模块加载失败
  • 检查内核版本兼容性
  • 查看内核日志：dmesg | grep mtgpu
  • 尝试手动加载：sudo modprobe -v mtgpu
  • 检查 dkms 是否成功编译：dkms status
  • S4000 机器能识别驱动、gmi 工具正常，但不能使用 muInfo 等工具时，检查是否开启了 IOMMU。 通过 cat /proc/cmdline 查询 intel_iommu=on iommu=pt
Q3: 显卡未识别
  • 检查显卡是否正确插入 PCIe 插槽
  • 检查电源连接是否牢固
  • 尝试重新插拔显卡
  • 检查 BIOS 中 PCIe 设置
Q4: 用户权限不足
# 确保用户已加入正确的组
sudo usermod -aG render ${USER}
sudo usermod -aG video ${USER}

# 重新登录使更改生效

MUSA Toolkit 安装​

驱动安装完成后，如需使用 MUSA Toolkit、muDNN、mccl 等组件，请参考相关安装指南。

1. 前提条件​

  • 已安装兼容版本 MT GPU 驱动

  • 已验证驱动正常工作

2. 安装 MUSA Toolkit​

# 解压安装包
tar -zxvf musa_toolkits_5.1.0.tar.gz
cd musa_toolkits_install

# 卸载已安装的 musa（如有）
bash ./install.sh -u

# 安装 MUSA Toolkit
bash ./install.sh

安装完成后，根据提示设置环境变量：

# 编辑 ~/.bashrc
vim ~/.bashrc

# 在文件末尾添加
export PATH=/usr/local/musa/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/musa/lib:$LD_LIBRARY_PATH

# 使配置生效
source ~/.bashrc

3. 验证 Toolkit 安装​

# 查询版本
musa_version_query

# 查看 GPU 信息
musaInfo

版权所有 2024 摩尔线程，本文档受国际版权法保护。

摩尔线程和摩尔线程徽标是摩尔线程智能科技 (北京)有限责任公司的注册商标。

免责声明

本文档提供有关摩尔线程产品的信息。本文档并未授权任何知识产权的许可，并未以明示或暗示，或以禁止反言或其他方式授予任何知识产权许可。