前提条件
- 请参见安装依赖完成安装前准备。
- 单击获取链接,在左侧配套资源的“编辑资源选择”中进行配置,筛选配套的软件包,单击获取链接,获取开发套件包Ascend-cann-toolkit_<version>_linux-<arch>.run和二进制算子包Ascend-cann-kernels-<chip_type>_<version>_linux-<arch>.run,以安装用户登录安装环境,将软件包上传到安装环境任意路径(如“/home/package”)。
- 安装开发套件包前请确保安装目录可用空间大于7G,如不满足请清理空间或更换安装目录。
安装Toolkit
- 以软件包的安装用户登录安装环境。将获取到的Toolkit上传到安装环境任意路径(如“/home/package”)。
- 增加对软件包的可执行权限,校验软件包安装文件的一致性和完整性。
| chmod +x Ascend-cann-toolkit_<version>_linux-<arch>.run
./Ascend-cann-toolkit_<version>_linux-<arch>.run --check
|
出现如下回显信息,表示软件包校验成功。
| Verifying archive integrity... 100% SHA256 checksums are OK. All good.
|
- 安装软件包(安装命令支持--install-path=<path>等参数,具体使用方式请参见参数说明)。
| ./Ascend-cann-toolkit_<version>_linux-<arch>.run --install
|
执行以上命令会打屏华为企业业务最终用户许可协议(EULA)的条款和条件,请输入Y或y同意协议,继续安装流程。
xxx表示安装的实际软件包名。
如果用户未指定安装路径,则软件会安装到默认路径下,默认安装路径如下。root用户:“/usr/local/Ascend”,非root用户:“${HOME}/Ascend”,${HOME}为当前用户目录。
- 配置环境变量,当前以非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
|
- 安装后检查。执行如下命令查询CANN版本信息,查询结果与安装软件包的版本一致时,则验证安装成功。
- 进入软件包安装信息文件目录。
| cd ${HOME}/Ascend/ascend-toolkit/latest/<arch>-linux
|
<arch>表示CPU架构(aarch64或x86_64)。
- 执行命令,查看version字段提供的版本信息。
| cat ascend_toolkit_install.info
|
安装Kernels
CANN二进制算子包,包括单算子API执行(例如aclnn类API)动态库/静态库文件,以及kernel二进制文件。
使用场景:
- 单算子API执行(例如aclnn类API)场景下必须安装该软件包。
- 图模式动态shape场景下,建议安装该软件包,安装后可提升编译性能。
- 图模式静态shape场景下,若安装该软件包,安装后可以提升编译性能。若不安装该软件包,按照确定shape编译新的kernel,可以提升算子执行性能。
- 增加对软件包的可执行权限,校验软件包安装文件的一致性和完整性。
| chmod +x Ascend-cann-kernels-<chip_type>_<version>_linux-<arch>.run
./Ascend-cann-kernels-<chip_type>_<version>_linux-<arch>.run --check
|
出现如下回显信息,表示软件包校验成功。
| Verifying archive integrity... 100% SHA256 checksums are OK. All good.
|
- 请根据所需的文件,执行对应的命令安装软件包。
- 安装所有文件,包括单算子API执行(例如aclnn类API)动态库/静态库文件,以及kernel二进制文件,请执行如下命令:
| ./Ascend-cann-kernels-<chip_type>_<version>_linux-<arch>.run --devel
|
- 安装除静态库之外的文件,请执行如下命令:
| ./Ascend-cann-kernels-<chip_type>_<version>_linux-<arch>.run --install
|
执行以上命令会打屏华为企业业务最终用户许可协议(EULA)的条款和条件,请输入Y或y同意协议,继续安装流程。
xxx表示安装的实际软件包名。
- 安装后检查。执行如下命令查询软件版本信息,查询结果与安装软件包的版本一致时,则验证安装成功。
- 进入软件包安装信息文件目录,请用户根据实际安装路径替换。
| cd ${HOME}/Ascend/ascend-toolkit/latest/opp_kernel
|
- 执行以下命令,查看version_dir字段提供的版本信息。