昇腾社区首页
中文
注册
开发者
下载
支持
积分兑换 NEW

安装CANN

物理机和容器部署场景，只需要在物理机安装NPU驱动。

虚拟机部署场景，请参考本章节在物理机和虚拟机安装NPU驱动。

准备用户

本节指导用户创建安装和运行用户，若用户已存在，请跳过本节内容。

表1 用户类型

安装用户

运行用户

root
  • 由于安装驱动时，运行用户和用户组默认指定为HwHiAiUser，需在安装软件包前自行创建HwHiAiUser的运行用户和用户组。
  • 若创建的用户和用户组是非HwHiAiUser（含root），安装驱动和固件时必须指定运行用户。

本文档中的示例步骤使用的用户如下：

  • 以root用户安装（非root用户安装合一包时，仅安装Toolkit包）。
  • 以非root用户HwHiAiUser（驱动固件的默认运行用户）为运行用户。
执行如下示例命令，创建HwHiAiUser用户和用户组：
1
2
groupadd HwHiAiUser
useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash

默认用户HwHiAiUser的用途和配置要求，请以《Atlas 系列硬件产品 账户清单》为准，若想创建其他非root用户，请用户自行创建。

安装依赖

  1. 执行如下命令检查源是否可用。
    Debian、Ubuntu、veLinux：
    1
    apt-get update

    如果命令执行报错或者等待时间过长，则检查网络是否连接或修改“/etc/apt/sources.list”文件为可用源（以配置华为镜像源为例，可参考华为开源镜像站中镜像源对应的配置方法操作）。

    openEuler、CentOS、Kylin、BCLinux、UOS V20、AntOS、AliOS、CTyunOS、CULinux、Tlinux、MTOS、vesselOS：
    1
    yum makecache

    如果命令执行报错或者等待时间过长，则检查网络是否连接或修改“/etc/yum.repos.d/xxxx.repo”文件为可用源（以配置华为镜像源为例，可参考华为开源镜像站中镜像源对应的配置方法操作）。

  2. 执行命令安装所需依赖
    Debian、Ubuntu、veLinux：
    1
    apt-get install -y make dkms gcc linux-headers-$(uname -r) python3 python3-pip
    openEuler、CentOS、Kylin、BCLinux、UOS V20、AntOS、AliOS、CTyunOS、CULinux、Tlinux、MTOS、vesselOS：
    1
    yum install -y make dkms gcc kernel-headers-$(uname -r) kernel-devel-$(uname -r) python3 python3-pip

    如果出现报错或者依赖不存在，请参见安装驱动源码编译所需依赖解决。若Python安装失败、版本不满足或未包含动态库libpython3.x.so，请参考编译安装Python操作。

安装驱动&Toolkit合一包

驱动&Toolkit合一包支持一键式全量安装，或通过参数--whitelist指定安装。

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

架构

安装命令

aarch

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.T63/Ascend-cann_8.5.0_linux-aarch64.run
bash ./Ascend-cann_8.5.0_linux-aarch64.run --install

x86_64

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.T63/Ascend-cann_8.5.0_linux-x86_64.run
bash ./Ascend-cann_8.5.0_linux-x86_64.run --install

安装命令支持--install-path=<path>等参数，具体使用方式请参见参数说明。如果用户未指定安装路径，则软件会安装到默认路径下，默认安装路径如下。root用户：“/usr/local/Ascend”，非root用户：“${HOME}/Ascend”，${HOME}为当前用户目录。

安装完成后请配置环境变量，当前以root用户安装后的默认路径为例，请用户根据set_env.sh的实际路径执行如下命令。
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，以满足多芯片环境下的开发和部署需求。

安装命令支持--install-path=<path>等参数，具体使用方式请参见参数说明。

表2 安装ops算子包

产品类型

架构

安装命令

Atlas A3 系列产品

aarch

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-A3-ops_8.5.0_linux-aarch64.run
bash ./Ascend-cann-A3-ops_8.5.0_linux-aarch64.run --install

x86_64

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-A3-ops_8.5.0_linux-x86_64.run
bash ./Ascend-cann-A3-ops_8.5.0_linux-x86_64.run --install

Atlas A2 系列产品

aarch

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-910b-ops_8.5.0_linux-aarch64.run
bash ./Ascend-cann-910b-ops_8.5.0_linux-aarch64.run --install

x86_64

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-910b-ops_8.5.0_linux-x86_64.run
bash ./Ascend-cann-910b-ops_8.5.0_linux-x86_64.run --install

Atlas 训练系列产品

aarch

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-910-ops_8.5.0_linux-aarch64.run
bash ./Ascend-cann-910-ops_8.5.0_linux-aarch64.run --install

x86_64

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-910-ops_8.5.0_linux-x86_64.run
bash ./Ascend-cann-910-ops_8.5.0_linux-x86_64.run --install

Atlas 推理系列产品

aarch

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-310p-ops_8.5.0_linux-aarch64.run
bash ./Ascend-cann-310p-ops_8.5.0_linux-aarch64.run --install

x86_64

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-310p-ops_8.5.0_linux-x86_64.run
bash ./Ascend-cann-310p-ops_8.5.0_linux-x86_64.run --install

Atlas 200I/500 A2 推理产品

aarch

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-310b-ops_8.5.0_linux-aarch64.run
bash ./Ascend-cann-310b-ops_8.5.0_linux-aarch64.run --install

x86_64

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-310b-ops_8.5.0_linux-x86_64.run
bash ./Ascend-cann-310b-ops_8.5.0_linux-x86_64.run --install

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

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

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

架构

安装命令

aarch

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-nnal_8.5.0_linux-aarch64.run
bash ./Ascend-cann-nnal_8.5.0_linux-aarch64.run --install

x86_64

 
1
2
wget https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/CANN/CANN%208.5.0/Ascend-cann-nnal_8.5.0_linux-x86_64.run
bash ./Ascend-cann-nnal_8.5.0_linux-x86_64.run --install

安装命令支持--install-path=<path>等参数，具体使用方式请参见参数说明。如果用户未指定安装路径，则软件会安装到默认路径下，默认安装路径如下。root用户：“/usr/local/Ascend”，非root用户：“${HOME}/Ascend”，${HOME}为当前用户目录。

配置环境变量，当前以root用户安装后的默认路径为例，请用户根据加速库对应的set_env.sh的实际路径进行替换。
  • ATB加速库：
    1
    source /usr/local/Ascend/nnal/atb/set_env.sh
  • SiP加速库：
    1
    source /usr/local/Ascend/nnal/asdsip/set_env.sh

上述环境变量配置只在当前窗口生效，用户可以按需将以上命令写入环境变量配置文件（如.bashrc文件）。