文档
注册

参数说明/常用命令

参数说明

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

安装命令格式: ./xx.run [options]

详细参数请参见表1

  • 软件包中的xx请根据实际情况进行替换。
  • 如果通过./xx.run --help命令查询出的参数未解释在如下表格,则说明该参数预留或适用于其他芯片版本,用户无需关注。
表1 安装包支持的参数说明

参数

说明

--help或者-h

查看帮助。

--info

显示数据包详细信息。

--list

导出安装包文件列表。

--check

校验软件包的完整性、检查与已经安装的其他软件包之间的配套关系是否正确。

--quiet

静默安装,跳过交互式信息。

使用该参数进行安装时,若安装目录权限大于755,则会提示安全风险,用户自行选择终止安装或选择其他权限为755的安装目录重新安装。

使用示例:./xx.run --full --quiet

说明:

Driver和Firmware软件包在使用该参数时,不能与--uninstall配合使用。

--nox11

安装过程中不弹出图形终端窗口。

使用示例:./xx.run --full --nox11

说明:

该参数预留,暂不使用。

--noexec

不执行安装脚本。配套--extract=path使用。格式为:--noexec --extract=path

--extract=<path>

解压缩安装包中文件到指定目录。使用该参数时,用户无需手动建立指定的目录,解压过程中会自动创建,例如:

--noexec --extract=./package,则命令执行后会自动将解压后的内容放在package目录。

--tar arg1 [arg2 …]

对安装包执行tar命令,使用tar后面的参数作为命令的参数。例如执行--tar xvf命令,解压软件包的内容到当前目录。

--full

完整安装类型:安装所有文件。

--run

运行态类型:只安装运行场景需安装的文件。

--devel

开发态类型:包含用户开发时需要用到的头文件。

Firmware子包不支持该参数。

--docker

容器场景下安装,仅用于driver子包,其他子包默认按full模式。

--upgrade

升级。

  • 首次安装场景,系统默认安装到“/usr/local/Ascend”目录。
  • 非首次安装场景,仅支持从软件包所在路径升级。
    说明:

    该参数不能与--install-username、--install-usergroup、--install-for-all其中任意一个参数配合使用。

--install-username=<username>

首次安装:可以指定运行用户名,若不指定,则默认是HwHiAiUser。

覆盖安装:沿用上次运行用户名。

说明:
  • 该参数需要配合“--install-usergroup=<usergroup>”一起使用,并且username需要与创建的用户(创建运行用户)保持一致。
  • 如果指定root用户为运行用户,则需要与--install-for-all参数配合使用,如下所示,该场景下权限控制可能存在安全风险。
    --install-username=root  --install-usergroup=root  --install-for-all
  • Firmware安装不支持指定运行用户名和用户组,共用Driver的运行用户名和用户组。

--install-usergroup=<usergroup>

首次安装:可以指定运行用户组,若不指定,则默认是HwHiAiUser。

覆盖安装:沿用上次运行用户组。

说明:

该参数需要配合“--install-username=<username>”一起使用,并且usergroup需要与创建的用户组(创建运行用户)保持一致。

--install-path=<path>

指定安装目录,如不指定:

  • 若使用root用户安装,默认安装路径为:/usr/local/Ascend。
  • 若使用非root用户安装,则默认安装路径为:$HOME/Ascend。

若通过该参数指定了安装路径,运行用户需要对指定的安装路径有可读写权限。安装路径支持大小写字母(a-z,A-Z)、数字(0-9)、下划线(_)、中划线(-)、句点(.(非相对路径))、单个/(文件名或目录不支持/)。

说明:

Firmware安装不支持指定路径,共用Driver的安装路径。

--install-for-all

安装时,允许其他用户具有安装群组的权限。

当安装携带该参数时,软件包中创建的目录及文件,其他用户权限=安装群组权限。

首次安装过程中如果使用了--install-for-all参数,覆盖安装中也需要保留--install-for-all参数。

使用示例:./xx.run --full --install-for-all

说明:
  • 使用该参数将会存在安全风险:其他所有用户都有权限访问安装目录,请谨慎使用。
  • Firmware不支持该参数。
  • 安装时如果使用该参数:
    • 如果安装路径不存在,则安装过程中会自动创建默认路径,例如:$HOME/Ascend,该路径权限为755,其他用户可以正常使用。
    • 如果安装路径已存在,则请确保该目录权限至少为755,否则将会终止安装。

--reset

恢复初始化配置(该参数只适用于Firmware子包):

  • --full --reset参数通过安装方式恢复初始化配置,需立即重启生效;若安装失败,则恢复初始化配置失败。
  • --upgrade --reset参数通过升级方式恢复初始化配置,需立即重启生效;若升级失败,则恢复初始化配置失败。
说明:
  • 该参数预留,暂不支持使用。
  • --reset参数只支持--full --reset与--upgrade --reset两种模式的使用方法,不支持与其它参数配合使用,也不支持单独使用。

--uninstall

卸载。

--version

查询版本号。

举例说明:

  • full模式下安装
    • 不指定安装目录:./xx.run --full
    • 指定安装目录:./xx.run --full --install-path=安装路径
  • docker模式下安装(仅支持driver子包)
    • 不指定安装目录:./xx.run --docker
    • 指定安装目录./xx.run --docker --install-path=安装路径
  • run模式下安装
    • 不指定安装目录:./xx.run --run
    • 指定安装目录:./xx.run --run --install-path=安装路径
  • 开发态模式下安装
    • 不指定安装目录:./xx.run --devel
    • 指定安装目录:./xx.run --devel --install-path=安装路径
搜索结果
找到“0”个结果

当前产品无相关内容

未找到相关内容,请尝试其他搜索词