安装、升级和卸载二进制算子包

PyTorch训练场景下须安装二进制算子包，二进制算子包支持安装、升级和卸载功能。

约束

二进制算子包依赖软件包toolkit或nnae，执行安装和升级操作时，当前环境需已安装配套版本的toolkit或nnae，并使用同一用户安装。

下载软件包

软件安装前，请参考表1获取所需软件包和对应的数字签名文件，各软件包版本号需要保持一致。

表1 CANN软件包
名称	软件包	说明	获取链接
二进制算子包	Ascend-cann-kernels-{chip_type}_{version}_linux.run	PyTorch训练场景下涉及动态shape时使用。	获取链接

{chip_type}表示处理器类型，{version}表示软件版本号。

软件数字签名验证

为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的数字签名文件用于完整性验证。

在软件包下载之后，请参考《OpenPGP签名验证指南》，对从Support网站下载的软件包进行PGP数字签名校验。如果校验失败，请不要使用该软件包，先联系华为技术支持工程师解决。

使用软件包安装/升级之前，也需要按上述过程先验证软件包的数字签名，确保软件包未被篡改。

运营商客户请访问：http://support.huawei.com/carrier/digitalSignatureAction

企业客户请访问：https://support.huawei.com/enterprise/zh/tool/pgp-verify-TL1000000054

相关操作（适用于.run格式）

二进制算子包支持安装、升级和卸载等操作，用户根据实际需要选择相应参数，可参见表2。

在软件包所在路径执行如下命令安装二进制算子包（请注意将命令中的软件包名.run替换为实际包名）：
```
chmod +x 软件包名.run
./软件包名.run --check
./软件包名.run --install
```
若环境中同时安装了配套版本的toolkit或nnae软件包，安装或升级时需通过以下两种方式识别具体的安装目录。
- 方式一：执行命令时需要添加参数 --type=<package_type>，识别到具体的安装目录。
- 方式二：先配置需依赖的toolkit或nnae的环境变量，再执行安装或升级。示例如下（以root用户默认安装路径为例）：
```
# 安装toolkit时配置
. /usr/local/Ascend/ascend-toolkit/set_env.sh
# 安装nnae时配置
. /usr/local/Ascend/nnae/set_env.sh
```
在软件包所在路径执行如下命令单独卸载二进制算子包（请注意将命令中的软件包名.run替换为实际包名）：
```
./软件包名.run --uninstall
```

除此之外，因二进制算子包安装在toolkit或nnae目录下，卸载配套的toolkit或nnae时会被一并删除，具体操作请参考卸载。

表2 算子包支持的参数说明
参数	说明
--help \| -h	查询帮助信息。
--info	查询软件包构建信息。
--list	查询软件包文件列表。
--check	检查软件包的一致性和完整性。
--quiet	静默安装，跳过交互式信息。
--nox11	不使用x11模式运行。
--noexec	解压软件包到当前目录，但不执行安装脚本。配套--extract=<path>使用，格式为： --noexec --extract=<path>。
--extract=<path>	解压软件包中文件到指定目录。
--tar arg1 [arg2 ...]	对软件包执行tar命令，使用tar后面的参数作为命令的参数。例如执行--tar xvf命令，解压run安装包的内容到当前目录。
--install	安装软件包。后面可以指定安装路径--install-path=<path>，也可以不指定安装路径，直接安装到默认路径下。
--uninstall	卸载已安装的软件。
--upgrade	升级已安装的软件。
--devel	按照开发模式安装软件包，即只安装开发环境需安装的文件。
--version	查询版本信息。
--install-for-all	安装或升级时，允许其他用户具有安装群组的权限。当安装或者升级携带该参数时，软件包中创建的目录及文件，其他用户权限=安装群组权限。该参数需要与--install、--devel、--upgrade等其中一个参数配合使用，例如./软件包名.run --install --install-for-all 说明：使用该参数将会存在安全风险：其他所有用户都有权限访问安装目录，请谨慎使用。
--install-path=<path>	指定安装路径，当环境上存在全局配置文件“ascend_cann_install.info”时，支持使用该参数，但指定路径必须与全局配置文件中保存的安装路径保持一致。如用户想更换安装路径，需先卸载原路径下的CANN软件包并确保全局配置文件“ascend_cann_install.info”已被删除。可在如下目录查看是否存在该文件： root用户：“/etc/Ascend” 非root用户：“${HOME}/Ascend” 若不指定，将安装到默认路径下：若使用root用户安装，默认安装路径为：/usr/local/Ascend。若使用非root用户安装，则默认安装路径为：${HOME}/Ascend。若通过该参数指定了安装目录，运行用户需要对指定的安装路径有可读写权限。
--type=<package_type>	指定已安装的nnae或toolkit软件包类型，用于在执行安装（--install）时指定跟随安装的软件包（“nnae”、“toolkit”），以识别到具体的安装目录。该参数需要配合“--install”一起使用。

算子包相关操作（适用于.deb和.rpm格式）

CANN算子包.deb格式安装请参考安装CANN软件包（适用于.deb格式），.rpm格式安装请参考安装CANN软件包（适用于.rpm格式），卸载请参考卸载。

父主题： 常用操作