安装CANN

本节将介绍通过Yum快速安装CANN软件的操作步骤。

从历史版本更新至CANN 8.5.0版本时，必须使用参数进行升级，或者先卸载所有历史版本，再重新安装CANN 8.5.0版本，否则可能会导致安装失败。

安装依赖

安装前需确保已具备Python环境及pip3，当前CANN支持的Python版本为Python3.7.x至3.13.x，若不满足可执行以下命令安装。

若安装失败、版本不满足或者未包含动态库libpython3.x.so请参考编译安装Python操作。

配置昇腾源

执行如下命令配置昇腾源，否则将无法安装。

sudo curl https://repo.oepkgs.net/ascend/cann/ascend.repo -o /etc/yum.repos.d/ascend.repo && yum makecache

安装Toolkit开发套件包

CANN Toolkit开发套件包，在训练&推理&开发调试场景下安装，主要用于训练和推理业务、模型转换、算子/应用/模型的开发和编译。

安装Toolkit软件前请确保安装目录可用空间大于10G，如不满足请清理空间或更换安装目录。
CANN 8.5.0版本必须同时安装Toolkit和ops。

执行安装命令。
1
sudo yum install -y Ascend-cann-toolkit-8.5.0
Yum在线安装时仅支持安装在默认路径“/usr/local/Ascend”下。
配置环境变量。
1
source /usr/local/Ascend/cann/set_env.sh
上述环境变量配置只在当前窗口生效，用户可以按需将以上命令写入环境变量配置文件（如.bashrc文件）。

安装ops算子包

CANN算子包集成一系列库文件，包括算子基础框架，算子库（包含math、nn、cv和transformer）、TBE算子、HCCL集合通信库、HIXL单边通信库和 DVPP库，具体文件包括单算子API执行（如aclnn类API）动态库/静态库文件、算子源码以及kernel二进制文件，优化高性能计算场景下的整体运行能力。

ops算子包安装之前，需已安装同一版本的Toolkit，并安装在同一路径下。多个芯片的ops算子包暂不支持安装在同一路径下，用户可以在不同路径下分别安装Toolkit和不同芯片的ops，以满足多芯片环境下的开发和部署需求。

表1 安装ops算子包

产品类型

安装命令

Atlas A3 系列产品

sudo yum install -y Ascend-cann-A3-ops-8.5.0

Atlas A2 系列产品

sudo yum install -y Ascend-cann-910b-ops-8.5.0

Atlas 训练系列产品

sudo yum install -y Ascend-cann-910-ops-8.5.0

Atlas 推理系列产品

sudo yum install -y Ascend-cann-310P-ops-8.5.0

Atlas 200I/500 A2 推理产品

sudo yum install -y Ascend-cann-310b-ops-8.5.0

安装NNAL神经网络加速库（可选）

NNAL神经网络加速库中提供了ATB（Ascend Transformer Boost）加速库和SiP（AscendSiPBoost）信号处理加速库。

加速库安装之前，需已安装同一版本的Toolkit并配置环境变量。

执行安装命令。
1
sudo yum install -y Ascend-cann-nnal-8.5.0
Yum在线安装时仅支持安装在默认路径“/usr/local/Ascend”下。
配置环境变量。
- ATB加速库：
  1
  source /usr/local/Ascend/nnal/atb/set_env.sh
- SiP加速库：
  1
  source /usr/local/Ascend/nnal/asdsip/set_env.sh
上述环境变量配置只在当前窗口生效，用户可以按需将以上命令写入环境变量配置文件（如.bashrc文件）。