参数说明

软件包支持根据命令行完成一键式安装，各个命令之间可以配合使用，用户根据安装需要选择对应参数完成安装，所有参数都是可选参数。

安装命令格式： ./软件包名.run [options]

详细参数请参见表1。

如果通过./软件包名.run --help命令查询出的参数未解释在如下表格，则说明该参数预留或适用于其他处理器版本，用户无需关注。

表1 安装包支持的参数说明
参数	说明
--help \| -h	查询帮助信息。
--version	查询版本信息。
--info	查询软件包构建信息。
--list	查询软件包文件列表。
--check	检查软件包的一致性和完整性。
--quiet	静默安装，跳过交互式信息。使用此参数安装或升级时，将默认签署华为企业业务最终用户许可协议（EULA）。
--nox11	不使用x11模式运行。
--noexec	解压软件包到当前目录，但不执行安装脚本。配套--extract=<path>使用，格式为： --noexec --extract=<path>。
--extract=<path>	解压软件包中文件到指定目录。
--tar arg1 [arg2 ...]	对软件包执行tar命令，使用tar后面的参数作为命令的参数。例如执行--tar xvf命令，解压run安装包的内容到当前目录。
--install	安装软件包。后面可以指定安装路径--install-path=<path>，也可以不指定安装路径，直接安装到默认路径下。
--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。若通过该参数指定了安装目录，运行用户需要对指定的安装路径有可读写权限。
--force	强制安装、升级命令。当安装、升级检测不通过导致安装或升级失败时，则会提示用户使用该参数跳过安装检测，使用后方可安装或升级成功。该参数需要配合“--install”或“--upgrade”一起使用。
--full	仅软件包toolkit支持使用该参数。支持在无驱动场景下实现全量安装。
--uninstall	卸载已安装的软件。
--upgrade	升级已安装的软件。
--feature-list=<feature>	仅软件包toolkit、nnae支持使用该参数。指定升级特性。仅支持升级使用，参数仅支持输入“Acclibs”（独立升级算子包），如“--feature-list=Acclibs”。该参数需要配合“--upgrade”一起使用。说明：推荐用户全量升级。如果版本配套表中有算子包独立升级的兼容性列表，则参考该兼容性列表，否则推荐用户全量升级。
--devel	按照开发模式安装软件包，即只安装开发环境需安装的文件。
--chip=<chip_type>	指定处理器型号，以便在安装过程中选择匹配的软件（如AICPU算子包）。处理器型号参数chip_type可选范围如下（以软件包toolkit为例）： Ascend310，表示Atlas 200/300/500 推理产品的EP模式。 Ascend310P，表示Atlas 推理系列产品（配置Ascend 310P AI处理器）。 Ascend910，表示Atlas 训练系列产品。 Ascend310-minirc，表示Atlas 200/300/500 推理产品的RC模式。 Ascend，表示Atlas 200/500 A2推理产品、Atlas A2 训练系列产品。须知：该参数仅对软件包toolkit、nnrt、nnae有效。未指定此参数时，默认安装软件包内的全部AICPU算子包。
--alternative	仅软件包toolkit支持使用该参数。查询可选安装特性列表。用于可选安装场景，在安装前查询软件包支持的可选安装特性列表，以便拷贝到--whitelist输入参数中。 toolkit可选安装特性如下： atc：用于支持模型编译、模型转换。 devtools：主要为调测、仿真工具。选择安装该特性时请配套安装nnae。 nnrt：用于支持离线推理场景。 nnae：用于支持离线推理、在线推理、训练以及IR构图场景。
--whitelist=<feature_type>	仅软件包toolkit支持使用该参数。可选安装白名单，用于在执行安装（--install）时指定部分可选安装特性。不支持在升级场景下使用。该参数需要配合“--install”一起使用。
--type=<package_type>	仅软件包kernels支持使用该参数。指定已安装的nnae或toolkit软件包类型，用于在执行安装（--install）时指定跟随安装的软件包（“nnae”、“toolkit”），以识别到具体的安装目录。该参数需要配合“--install”或“--upgrade”一起使用。

父主题： 附录