参数说明
软件包支持根据命令行完成一键式安装,各个命令之间可以配合使用,用户根据安装需要选择对应参数完成安装,所有参数都是可选参数。
安装命令格式: ./软件包名.run [options]
详细参数请参见表1。
如果通过./软件包名.run --help命令查询出的参数未解释在如下表格,则说明该参数预留或适用于其他产品类型,用户无需关注。
参数 |
说明 |
---|---|
--help | -h |
查询帮助信息。 |
--version |
查询版本信息。 |
--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>,也可以不指定安装路径,直接安装到默认路径下。 |
--install-for-all |
安装或升级时,允许其他用户具有安装群组的权限。 当安装或者升级携带该参数时,软件包中创建的目录及文件,其他用户权限=安装群组权限。 该参数需要与--install、--devel、--upgrade等其中一个参数配合使用,例如./软件包名.run --install --install-for-all
说明:
使用该参数将会存在安全风险:其他所有用户都有权限访问安装目录,请谨慎使用。 |
--install-path=<path> |
指定安装路径,当环境上已存在全局配置文件“ascend_cann_install.info”时,该参数指定的路径必须与全局配置文件中保存的安装路径保持一致。如用户想更换安装路径,请删除全局配置文件“ascend_cann_install.info”或者修改全局配置文件内的安装路径为指定路径,同时建议卸载原路径下的CANN软件包。 可在如下目录查看是否存在该文件:
若不指定,将安装到默认路径下:
若通过该参数指定了安装目录,root用户需要对指定的安装路径有755权限,非root用户需要750权限。 |
--force |
强制安装、升级命令。当安装、升级检测不通过导致安装或升级失败时,则会提示用户使用该参数跳过安装检测,使用后方可安装或升级成功。 该参数需要配合“--install”或“--upgrade”一起使用。 |
--full |
仅软件包toolkit支持使用该参数。 支持在无驱动场景下实现全量安装。 |
--uninstall |
卸载已安装的软件。 |
--upgrade |
升级已安装的软件,支持在低版本升级至高版本场景下使用。 如果需要从高版本回退至低版本,需卸载高版本后重新安装所需版本。 |
--feature-list=<feature> |
仅软件包toolkit、nnae支持使用该参数。 指定升级特性。仅支持升级使用,参数仅支持输入“Acclibs”(独立升级算子包),如“--feature-list=Acclibs”。 该参数需要配合“--upgrade”一起使用。
说明:
推荐用户全量升级。如果版本配套表中有算子包独立升级的兼容性列表,则参考该兼容性列表,否则推荐用户全量升级。 |
--devel |
按照开发模式安装软件包,即只安装开发环境需安装的文件。 |
--chip=<chip_type> |
指定昇腾产品类型,以便在安装过程中选择匹配的软件(如AICPU算子包)。
须知:
该参数仅对软件包toolkit、nnrt、nnae有效。未指定此参数时,默认安装软件包内的全部AICPU算子包。 |
--alternative |
仅软件包toolkit支持使用该参数。 查询可选安装特性列表。用于可选安装场景,在安装前查询软件包支持的可选安装特性列表,以便拷贝到--whitelist输入参数中。
toolkit可选安装特性如下:
|
--whitelist=<feature_type> |
仅软件包toolkit支持使用该参数。 可选安装白名单,用于在执行安装(--install)时指定部分可选安装特性。不支持在升级场景下使用。 该参数需要配合“--install”一起使用。 |
--type=<package_type> |
仅软件包kernels支持使用该参数。 指定已安装的nnae或toolkit软件包类型,用于在执行安装(--install)时指定跟随安装的软件包(“nnae”、“toolkit”),以识别到具体的安装目录。该参数需要配合“--install”或“--upgrade”一起使用。 |
以下参数未展示在--help参数中,用户请勿直接使用。
- --xwin:使用xwin模式运行。
- --phase2:要求执行第二步动作。