安装 MTDCGM
本文档介绍如何在 Linux 平台安装 MTDCGM。MTDCGM 提供在线安装(APT)和离线安装两种方式。其中,在线安装需要先配置 Mthreads APT 软件源,再安装对应软件包。
执行以下所有操作需要具备系统管理员 root 权限或使用 sudo 命令。
安装方式概览
MTDCGM 提供在线安装和离线安装两种方式。您可以按照自己的习惯和环境条件进行选择,推荐优先使用在线安装(APT)。下表概述了两种安装方式的适用场景和说明:
| 安装方式 | 适用场景 | 说明 |
|---|---|---|
| 在线安装(APT) | 全新 Ubuntu 22.04 x86_64 Server 环境 | 通过 DEB 配置包自动配置 APT 软件源后直接安装 |
| 离线安装 | 受控环境、需要明确安装包版本 | 手动下载安装包并执行安装 |
使用在线安装(APT)前,建议先确认以下事项:
- APT 方式仅适用于上述全新 Ubuntu 22.04 x86_64 Server 环境。
- 如果系统已经通过旧版 DEB 包、RPM 包或其他方式安装过 MTDCGM,请先按原安装方式卸载干净,再执行在线安装流程。
- 在线安装(APT)
- 离线安装
请按以下步骤,使用 DEB 配置包自动配置 APT 软件源并安装 MTDCGM:
-
下载配置包:
wget https://dl.mthreads.com/repo/repository/ubuntu2204/pool/jammy/amd64/musa-repo-jammy_1.0.0.11-1_all.deb -
安装配置包:
sudo dpkg -i musa-repo-jammy_1.0.0.11-1_all.deb -
更新本地缓存:
sudo apt update -
安装 MTDCGM:
sudo apt install mt-datacenter-gpu-manager
安装完成后,请参见 验证安装 确认安装结果。
请从 摩尔线程官网开发者中心 下载对应版本的 Release 安装包。
离线安装包包括以下文件:
- DEB 包:
mt-datacenter-gpu-manager_amd64_xx.deb - RPM 包:
mt-datacenter-gpu-manager_amd64_xx.rpm
Debian 系列
-
如果后台服务正在运行,请先停止服务;如果服务未运行,可跳过此步骤。
sudo /usr/local/mtdcgm/bin/mt-hostengine -t -
卸载旧版本 MTDCGM。即使系统中未安装旧版本,也建议执行以下命令再次确认:
sudo dpkg -P mt-datacenter-gpu-manager -
安装 MTDCGM:
sudo dpkg -i mt-datacenter-gpu-manager_amd64_*.deb
RedHat 系列
-
如果后台服务正在运行,请先停止服务;如果服务未运行,可跳过此步骤。
sudo /usr/local/mtdcgm/bin/mt-hostengine -t -
卸载旧版本 MTDCGM。即使系统中未安装旧版本,也建议执行以下命令再次确认:
sudo rpm -e mt-datacenter-gpu-manager -
安装 MTDCGM:
sudo rpm -i mt-datacenter-gpu-manager_amd64_*.rpm
安装完成后,请参见 验证安装 确认安装结果。
验证安装
执行以下命令前,请先切换到 root 用户,或使用具有等效权限的 sudo 环境。
-
配置环境变量:
export PATH=/usr/local/mtdcgm/bin:${PATH}export LD_LIBRARY_PATH=/usr/local/mtdcgm/lib/x86_64-linux-gnu:${LD_LIBRARY_PATH} -
运行 1 级诊断,检查环境是否已准备好:
dcgmi diag -r 1
如果返回 PASS,则表示环境已准备好;否则请检查 MUSA SDK 软件栈是否已正确安装并完成配置。

