昇腾社区首页
中文
注册

安装CANN

前提条件

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

安装依赖

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

  1. 执行命令安装所需依赖
    1
    sudo apt-get install -y gcc g++ python3 python3-pip
    
    1
    sudo yum install -y gcc gcc-c++ python3 python3-pip
    

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

  2. 执行如下命令安装业务运行时依赖的Python第三方库:
    1
    pip3 install attrs cython 'numpy>=1.19.2,<=1.24.0' decorator sympy cffi pyyaml pathlib2 psutil protobuf==3.20.0 scipy requests absl-py --user
    

    若pip源不可以用,请参见配置pip源,完成后再执行安装命令。

安装Toolkit

  1. 以软件包的安装用户登录安装环境。将获取到的Toolkit上传到安装环境任意路径(如“/home/package”)。
  2. 增加对软件包的可执行权限,以aarch64架构为例。
    1
    chmod +x Ascend-cann-toolkit_8.2.RC1_linux-aarch64.run
    
  3. 安装软件包(安装命令支持--install-path=<path>等参数,具体使用方式请参见参数说明)。
    1
    ./Ascend-cann-toolkit_8.2.RC1_linux-aarch64.run --install
    

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

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

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

  5. 安装后检查。执行如下命令查询CANN版本信息,查询结果与安装软件包的版本一致时,则验证安装成功。
    1. 进入软件包安装信息文件目录。
      cd ${HOME}/Ascend/ascend-toolkit/latest/<arch>-linux

      其中${HOME}/Ascend为非root用户默认安装路径,请用户根据实际安装路径替换。<arch>表示CPU架构(aarch64或x86_64)。

    2. 执行命令,查看version字段提供的版本信息。
      cat ascend_toolkit_install.info

安装Kernels(可选)

CANN二进制算子包,包括单算子API执行(例如aclnn类API)动态库/静态库文件,以及kernel二进制文件。

表1 安装Kernels算子包

产品类型

架构

安装命令

Atlas A3 系列产品

aarch

1
2
chmod +x Atlas-A3-cann-kernels_8.2.RC1_linux-aarch64.run
./Atlas-A3-cann-kernels_8.2.RC1_linux-aarch64.run --install

x86_64

1
2
chmod +x Atlas-A3-cann-kernels_8.2.RC1_linux-x86_64.run
./Atlas-A3-cann-kernels_8.2.RC1_linux-x86_64.run --install

Atlas A2 系列产品

aarch

1
2
chmod +x Ascend-cann-kernels-910b_8.2.RC1_linux-aarch64.run
./Ascend-cann-kernels-910b_8.2.RC1_linux-aarch64.run --install

x86_64

1
2
chmod +x Ascend-cann-kernels-910b_8.2.RC1_linux-x86_64.run
./Ascend-cann-kernels-910b_8.2.RC1_linux-x86_64.run --install

Atlas 训练系列产品

aarch

1
2
chmod +x Ascend-cann-kernels-910_8.2.RC1_linux-aarch64.run
./Ascend-cann-kernels-910_8.2.RC1_linux-aarch64.run --install

x86_64

1
2
chmod +x Ascend-cann-kernels-910_8.2.RC1_linux-x86_64.run
./Ascend-cann-kernels-910_8.2.RC1_linux-x86_64.run --install

Atlas 推理系列产品

aarch

1
2
chmod +x Ascend-cann-kernels-310p_8.2.RC1_linux-aarch64.run
./Ascend-cann-kernels-310p_8.2.RC1_linux-aarch64.run --install

x86_64

1
2
chmod +x Ascend-cann-kernels-310p_8.2.RC1_linux-x86_64.run
./Ascend-cann-kernels-310p_8.2.RC1_linux-x86_64.run --install

Atlas 200I/500 A2 推理产品

aarch

1
2
chmod +x Ascend-cann-kernels-310b_8.2.RC1_linux-aarch64.run
./Ascend-cann-kernels-310b_8.2.RC1_linux-aarch64.run --install

x86_64

1
2
chmod +x Ascend-cann-kernels-310b_8.2.RC1_linux-x86_64.run
./Ascend-cann-kernels-310b_8.2.RC1_linux-x86_64.run --install

如需同时安装静态库,请将--install变更为--devel参数,执行以上命令。