昇腾社区首页
中文
注册
开发者
下载

安装CANN

前提条件

  • 单击获取链接,在左侧配套资源的“编辑资源选择”中进行配置,筛选配套的软件包,获取开发套件包Ascend-cann-toolkit_<version>_linux-<arch>.run和算子包Ascend-cann-<chip_type>-ops_<version>_linux-<arch>.run,以安装用户登录安装环境,将软件包上传到安装环境任意路径(如“/home/package”)。
  • 安装开发套件包前请确保安装目录可用空间大于10G如不满足请清理空间或更换安装目录。

安装依赖

可使用root或非root用户(非root用户需与CANN软件包安装用户保持一致)安装。如果使用非root用户安装,需要用到提权命令,请用户自行获取所需的sudo权限,使用完成后请取消涉及高危命令的权限,否则有sudo提权风险。

请参考以下操作进行安装,以下命令会安装最新版本或指定版本的依赖,关于Python第三方库、glibc版本要求请参见运行依赖列表

  1. 执行命令安装所需依赖
    Debian、Ubuntu、veLinux
    1
    sudo apt-get install -y gcc g++ python3 python3-pip
    
    openEuler、CentOS、Kylin、BCLinux、UOS V20、AntOS、AliOS、CTyunOS、CULinux、Tlinux、MTOS、vesselOS
    1
    sudo yum install -y gcc gcc-c++ python3 python3-pip
    

    CANN支持Python3.7.x至3.13.x版本,若安装失败、版本不满足或者未包含动态库libpython3.x.so请参见编译安装Python操作。

  2. 安装Python第三方库(如果使用root用户安装,请将命令中的--user删除)。
    1
    pip3 install attrs cython 'numpy>=1.19.2,<2.0' decorator sympy cffi pyyaml pathlib2 psutil protobuf==3.20.0 scipy requests absl-py --user
    

    以上示例命令会安装最新版本或指定版本的依赖,关于numpy等Python第三方库,需与Python版本配套使用,如遇报错,请参见运行依赖列表查看具体版本要求。

    若安装过程中提示pip源不可用,请参见配置pip源,完成后再执行安装命令。

安装Toolkit

  • 安装Toolkit软件前请确保安装目录可用空间大于10G,如不满足请清理空间或更换安装目录。
  • CANN 8.5.0版本必须同时安装Toolkitops
  1. 以软件包的安装用户登录安装环境。将获取到的Toolkit上传到安装环境任意路径(如“/home/package”)。
  2. 对软件包添加可执行权限。
    1
    chmod +x Ascend-cann-toolkit_8.5.0_linux-aarch64.run
    
  3. 安装软件包(安装命令支持--install-path=<path>等参数,具体使用方式请参见参数说明)。
    1
    ./Ascend-cann-toolkit_8.5.0_linux-aarch64.run --install
    

    如果用户未指定安装路径,则软件会安装到默认路径下,默认安装路径如下。root用户:“/usr/local/Ascend”,非root用户:“${HOME}/Ascend”,${HOME}为当前用户目录。

  4. 配置环境变量,当前以非root用户安装后的默认路径为例,请用户根据set_env.sh的实际路径执行如下命令。
    # 安装Toolkit包时配置
    source ${HOME}/Ascend/cann/set_env.sh
    # 其中<arch>请替换为实际架构
    export LD_LIBRARY_PATH=${HOME}/Ascend/cann/<arch>-linux/devlib/:$LD_LIBRARY_PATH

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

安装ops

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

表1 安装ops算子包

产品类型

架构

安装命令

Atlas A3 系列产品

aarch

1
2
chmod +x Ascend-cann-A3-ops_8.5.0_linux-aarch64.run
./Ascend-cann-A3-ops_8.5.0_linux-aarch64.run --install

x86_64

1
2
chmod +x Ascend-cann-A3-ops_8.5.0_linux-x86_64.run
./Ascend-cann-A3-ops_8.5.0_linux-x86_64.run --install

Atlas A2 系列产品

aarch

1
2
chmod +x Ascend-cann-910b-ops_8.5.0_linux-aarch64.run
./Ascend-cann-910b-ops_8.5.0_linux-aarch64.run --install

x86_64

1
2
chmod +x Ascend-cann-910b-ops_8.5.0_linux-x86_64.run
./Ascend-cann-910b-ops_8.5.0_linux-x86_64.run --install

Atlas 训练系列产品

aarch

1
2
chmod +x Ascend-cann-910-ops_8.5.0_linux-aarch64.run
./Ascend-cann-910-ops_8.5.0_linux-aarch64.run --install

x86_64

1
2
chmod +x Ascend-cann-910-ops_8.5.0_linux-x86_64.run
./Ascend-cann-910-ops_8.5.0_linux-x86_64.run --install

Atlas 推理系列产品

aarch

1
2
chmod +x Ascend-cann-310p-ops_8.5.0_linux-aarch64.run
./Ascend-cann-310p-ops_8.5.0_linux-aarch64.run --install

x86_64

1
2
chmod +x Ascend-cann-310p-ops_8.5.0_linux-x86_64.run
./Ascend-cann-310p-ops_8.5.0_linux-x86_64.run --install

Atlas 200I/500 A2 推理产品

aarch

1
2
chmod +x Ascend-cann-310b-ops_8.5.0_linux-aarch64.run
./Ascend-cann-310b-ops_8.5.0_linux-aarch64.run --install

x86_64

1
2
chmod +x Ascend-cann-310b-ops_8.5.0_linux-x86_64.run
./Ascend-cann-310b-ops_8.5.0_linux-x86_64.run --install