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

安装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，如不满足请清理空间或更换安装目录。

安装依赖

  • 请根据不同类型的操作系统，选择对应的命令安装所需依赖。

    Debian系列操作系统包括：Debian、Ubuntu、veLinux。

    openEuler系列操作系统包括：openEuler、CentOS、Kylin、BCLinux、UOS V20、AntOS、CTyunOS、CULinux、Tlinux、MTOS。

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

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

  1. 执行命令安装所需依赖
    Debian系列：
    1
    sudo apt-get install -y gcc g++ python3 python3-pip
    openEuler系列：
    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. 增加对软件包的可执行权限。
    chmod +x Ascend-cann-toolkit_<version>_linux-<arch>.run
  3. 安装软件包（安装命令支持--install-path=<path>等参数，具体使用方式请参见参数说明）。
    1
    ./Ascend-cann-toolkit_<version>_linux-<arch>.run --install

    执行安装命令时，会自动执行--check参数，校验软件包的一致性和完整性，出现如下回显信息，表示软件包校验成功。

    1
    Verifying archive integrity...  100%   SHA256 checksums are OK. All good.

    执行以上命令会显示华为企业业务最终用户许可协议（EULA）的条款和条件，请输入Y或y同意协议，继续安装流程。

    安装完成后，若显示如下信息，则说明软件安装成功：
    1
    xxx install success

    xxx表示安装的实际软件包名。

    如果用户未指定安装路径，则软件会安装到默认路径下，默认安装路径如下。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. 增加对软件包的可执行权限。
    1
    chmod +x Ascend-cann-kernels-<chip_type>_<version>_linux-<arch>.run
  2. 安装软件包。
    1
    ./Ascend-cann-kernels-<chip_type>_<version>_linux-<arch>.run --install

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

    执行安装命令时，会自动执行--check参数，校验软件包的一致性和完整性，出现如下回显信息，表示软件包校验成功。

    1
    Verifying archive integrity...  100%   SHA256 checksums are OK. All good.

    执行以上命令会显示华为企业业务最终用户许可协议（EULA）的条款和条件，请输入Y或y同意协议，继续安装流程。

    安装完成后，若显示如下信息，则说明软件安装成功：
    1
    xxx install success

    xxx表示安装的实际软件包名。

  3. 安装后检查。执行如下命令查询软件版本信息，查询结果与安装软件包的版本一致时，则验证安装成功。
    1. 进入软件包安装信息文件目录，请用户根据实际安装路径替换。
      1
      cd ${HOME}/Ascend/ascend-toolkit/latest/opp_kernel
    2. 执行以下命令，查看version_dir字段提供的版本信息。
      1
      cat version.info