本文基于昇腾官方安装文档,整理 CANN 8.2.RC1 商用版在 Debian 系统下的本地安装流程,适用于 Atlas 系列硬件(加速模块、加速卡、智能小站、服务器、集群),配套支持 MindSpore、TensorFlow(社区版 / 商用版)、PyTorch 等 AI 框架,以及昇腾推理引擎 MindIE、全流程开发工具 MindStudio 等组件。

一、安装前准备

(一)环境检查

  1. 操作系统校验:确认当前系统为 Debian,版本需满足 CANN 8.2.RC1 兼容要求(建议提前查阅官方兼容列表,确保无版本冲突)。
  2. 硬件兼容性确认:核实所使用的 Atlas 系列硬件(加速模块、加速卡等)已在 CANN 8.2.RC1 商用版支持范围内,硬件状态正常且已正确部署。
  3. 依赖环境检查:确保系统已安装必要的依赖组件(如编译器、依赖库等,具体依赖清单可参考昇腾官方术语表及常见问题文档补充)。
  4. 权限准备:获取系统 root 权限或具备 sudo 操作权限,确保安装过程中可执行文件创建、目录访问等操作。

(二)安装包获取

从昇腾官方指定渠道下载 CANN 8.2.RC1 商用版安装包(对应 Software=cannToolKit,InstallType=local,OS=Debian),下载完成后校验安装包完整性(避免因包损坏导致安装失败)。

二、安装操作步骤

(一)解压安装包

  1. 打开终端,切换至安装包所在目录(示例命令:cd /path/to/installation/package,其中/path/to/installation/package需替换为实际安装包路径)。
  2. 执行解压命令,将安装包解压至指定目录(建议选择空间充足、访问便捷的路径,示例命令:tar -zxvf cann_toolkit_8.2.RC1_debian.tar.gz -C /target/directory/target/directory为目标解压目录)。

(二)执行安装脚本

  1. 进入解压后的安装目录(示例命令:cd /target/directory/cann_toolkit_8.2.RC1)。
  2. 找到本地安装脚本(通常为.sh格式,具体脚本名称以安装包内实际文件为准),执行安装命令:
    • 若使用 root 权限:./install.sh --install-type local
    • 若使用 sudo 权限:sudo ./install.sh --install-type local
  3. 安装过程中按提示操作,可根据需求选择是否安装配套组件(如 MindStudio、MindSDK 等),默认情况下将安装核心 CANN 工具套件及依赖。

(三)配置环境变量

  1. 安装完成后,需配置环境变量以确保系统能识别 CANN 相关工具:
    • 打开环境变量配置文件(如~/.bashrc/etc/profile),示例命令:vim ~/.bashrc
    • 在文件末尾添加以下环境变量(需替换/target/directory/cann_toolkit_8.2.RC1为实际安装目录):

      plaintext

      export CANN_PATH=/target/directory/cann_toolkit_8.2.RC1
      export PATH=$CANN_PATH/bin:$PATH
      export LD_LIBRARY_PATH=$CANN_PATH/lib:$LD_LIBRARY_PATH
      
    • 保存并退出文件,执行命令使环境变量生效:source ~/.bashrc(若修改/etc/profile则执行source /etc/profile)。

三、安装后验证

(一)基础功能验证

  1. 终端输入 CANN 版本查询命令,确认安装成功:npu-smi info(若能正常显示昇腾设备信息及 CANN 版本号 8.2.RC1,说明基础安装生效)。
  2. 检查核心组件可用性:验证 MindIE 推理引擎、异构计算架构等核心模块是否能正常调用(可参考官方故障案例文档中的验证用例)。

(二)框架适配验证

根据实际使用的 AI 框架,执行对应适配验证:

  1. 若使用 MindSpore:运行简单的 MindSpore 训练 / 推理脚本,确认能正常调用昇腾硬件加速。
  2. 若使用 TensorFlow/PyTorch:通过框架自带的设备识别命令,确认框架已识别到昇腾设备(参考对应框架的昇腾适配文档)。

四、注意事项

  1. 安装过程中若出现依赖缺失、权限不足等报错,可参考昇腾官方 “常见问题” 或 “故障案例” 文档排查解决。
  2. 安装目录需预留充足磁盘空间,建议不低于 20GB(含依赖组件及后续运行缓存)。
  3. 环境变量配置后需重新打开终端或执行source命令,否则可能导致工具无法正常调用。
  4. 若需安装分布式训练加速套件 MindSpeed、MindCluster 等扩展组件,可在基础安装完成后,通过官方提供的扩展安装指南补充部署。
  5. 安装完成后建议重启系统,确保所有配置生效(可选,根据实际环境情况决定)。

训练营简介

2025年昇腾CANN训练营第二季,基于CANN开源开放全场景,推出0基础入门系列、码力全开特辑、开发者案例等专题课程,助力不同阶段开发者快速提升算子开发技能。获得Ascend C算子中级认证,即可领取精美证书,完成社区任务更有机会赢取华为手机,平板、开发板等大奖。

报名链接https://www.hiascend.com/developer/activities/cann20252#cann-camp-2502-intro


       

Logo

CANN开发者社区旨在汇聚广大开发者,围绕CANN架构重构、算子开发、部署应用优化等核心方向,展开深度交流与思想碰撞,携手共同促进CANN开放生态突破!

更多推荐