安装开发套件包

前提条件

• 请参见安装前准备完成安装前准备。
• 通过准备软件包章节获取开发套件包Ascend-cann-toolkit_{version}_linux-{arch}_{gcc_version}.run。

安装步骤

1. 以软件包的安装用户登录安装环境。

   请确保软件包的安装用户与安装前准备中安装依赖的用户保持一致。

2. 将获取到的开发套件包上传到安装环境任意路径（如“/home/package”）。
3. 进入软件包所在路径。
4. 增加对软件包的可执行权限。

   chmod +x *.run

   其中*.run表示开发套件包Ascend-cann-toolkit_{version}_linux-{arch}_gccx.x.x.run，请根据实际包名进行替换。

5. 执行如下命令校验软件包安装文件的一致性和完整性。

   ./*.run --check

6. （可选）创建软件安装路径。
   • 如果用户想指定安装路径，则需要先创建安装路径。以安装路径“/home/work”为例， 用户先执行mkdir -p /home/work命令创建安装路径，再选择该路径进行软件安装。
   • 如果用户未指定安装路径，则软件会安装到默认路径下，默认安装路径如下。
     • root用户：“/usr/local/Ascend”
     • 非root用户：“${HOME}/Ascend”

       其中${HOME}为当前用户目录。

7. 执行以下命令安装软件。（以下命令支持--install-for-all和--install-path=<path>等，具体参数说明请参见参数说明）
   • 若使用非root用户安装，请执行以下命令。

     ./*.run --install

   • 若使用root用户安装，请执行以下命令。
     • 若使用默认运行用户HwHiAiUser：

       ./*.run --install

     • 若用户需自行指定运行用户：

       ./*.run --install-username=username --install-usergroup=usergroup --install

       其中--install-username和--install-usergroup用于指定运行用户。

   • 开发套件包支持不同用户在同一开发环境安装多个版本，不同用户所属的属组必须和Driver运行用户所属属组相同；如果不同，请用户自行添加到Driver运行用户属组。
   • 如果以root用户安装，建议不要安装在非root用户目录下，否则存在被非root用户替换root用户文件以达到提权目的的安全风险。
   • 开发套件包Ascend-cann-toolkit_{version}_linux-{arch}_{gcc_version}.run在X86系统中安装的时候不支持--quiet选项。
   • 开发套件包Ascend-cann-toolkit_{version}_linux-{arch}_{gcc_version}.run在X86系统中安装的时候，如果出现如下情况，即询问是否进行热复位，则用户需输入n，安装完毕后请重启OS，才能生效。当前版本只支持n选项。

     The installation of aicpu_kernels needs to restart the device to take effect, do you want to hot_reset the device? [y/n] n  

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

   [INFO] xxx install success
   [INFO] process end

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

日志文件和软件包信息

表3-16中各变量的含义如表3-17所示：