跳到主要内容

安装 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,请先按原安装方式卸载干净,再执行在线安装流程。

请按以下步骤,使用 DEB 配置包自动配置 APT 软件源并安装 MTDCGM:

  1. 下载配置包:

    wget https://dl.mthreads.com/repo/repository/ubuntu2204/pool/jammy/amd64/musa-repo-jammy_1.0.0.11-1_all.deb
  2. 安装配置包:

    sudo dpkg -i musa-repo-jammy_1.0.0.11-1_all.deb
  3. 更新本地缓存:

    sudo apt update
  4. 安装 MTDCGM:

    sudo apt install mt-datacenter-gpu-manager

安装完成后,请参见 验证安装 确认安装结果。

验证安装

执行以下命令前,请先切换到 root 用户,或使用具有等效权限的 sudo 环境。

  1. 配置环境变量:

    export PATH=/usr/local/mtdcgm/bin:${PATH}
    export LD_LIBRARY_PATH=/usr/local/mtdcgm/lib/x86_64-linux-gnu:${LD_LIBRARY_PATH}
  2. 运行 1 级诊断,检查环境是否已准备好:

    dcgmi diag -r 1

如果返回 PASS,则表示环境已准备好;否则请检查 MUSA SDK 软件栈是否已正确安装并完成配置。