安装CANN

前提条件

• 请参见安装依赖完成安装前准备。
• 通过准备软件包章节获取开发套件包Ascend-cann-toolkit_xxx.run和二进制算子包Ascend-cann-kernels-xxx_linux.run（可选），以安装用户登录安装环境，将软件包上传到安装环境任意路径（如“/home/package”）。
• 安装开发套件包前请确保安装目录可用空间大于9G，如不满足请清理空间或更换安装目录。

安装Toolkit

1. 以软件包的安装用户登录安装环境。将获取到的Toolkit上传到安装环境任意路径（如“/home/package”）。
2. 增加对软件包的可执行权限，校验软件包安装文件的一致性和完整性。

   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.

3. 安装软件包。

   ./Ascend-cann-toolkit_<version>_linux-<arch>.run --install

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

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

   xxx install success

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

4. 配置环境变量，当前以root用户安装后的默认路径为例，请修改为set_env.sh的实际安装路径。

   # 安装toolkit包时配置
   source /usr/local/Ascend/ascend-toolkit/set_env.sh
   # 其中<arch>请替换为实际架构
   export LD_LIBRARY_PATH=/usr/local/Ascend/ascend-toolkit/latest/<arch>-linux/devlib/:$LD_LIBRARY_PATH

5. 安装后检查。执行如下命令查询CANN版本信息，查询结果与安装软件包的版本一致时，则验证安装成功。
   1. 进入软件包安装信息文件目录。

      cd /usr/local/Ascend/ascend-toolkit/latest/<arch>-linux

      其中/usr/local/Ascend为root用户默认安装路径，请用户根据实际安装路径替换。<arch>表示CPU架构（aarch64或x86_64）。

   2. 执行以下命令获取版本信息。

      cat ascend_toolkit_install.info

安装Kernels（可选）

二进制算子包Kernels能够节省算子编译时间，在如下场景中需要安装：

• 大模型推理、训练场景。
• 运行包含动态shape网络或单算子API（例如aclnn类API）相关业务场景。

1. 增加对软件包的可执行权限，校验软件包安装文件的一致性和完整性。

   chmod +x Ascend-cann-kernels-<chip_type>_<version>_linux.run
   ./Ascend-cann-kernels-<chip_type>_<version>_linux.run --check

   出现如下回显信息，表示软件包校验成功。

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

2. 安装软件包。

   ./Ascend-cann-kernels-<chip_type>_<version>_linux.run --install

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

   

   二进制算子包支持使用--feature参数，按照训练、推理等可选特性安装，具体参数说明请参见参数说明，示例命令如下：

   ./Ascend-cann-kernels-xxx_linux.run --install --feature=aclnn_ops_infer

3. 安装后检查。执行如下命令查询软件版本信息，查询结果与安装软件包的版本一致时，则验证安装成功。
   1. 进入软件包安装信息文件目录，请用户根据实际安装路径替换。

      cd /usr/local/Ascend/ascend-toolkit/latest/opp_kernel

   2. 执行以下命令，查看version_dir字段提供的版本信息。

      cat version.info