Parameters and Commands

--run

Indicates the running type: installs only the files required in a running scenario.

--devel

Indicates the developer installation type: includes only the header files required for application development.

The firmware subpackage does not support this parameter.

--full

Indicates full installation: installs all files.

--docker

Indicates the container-based installation mode for the driver subpackage only. Other subpackages use the full installation mode by default.

--install-username=<username>

Initial installation: You can specify the running user name. Otherwise, HwHiAiUser is used by default.

Overwrite installation: The username used in the last installation applies.

--install-usergroup=<usergroup>

Initial installation: You can specify the running user group name. Otherwise, HwHiAiUser is used by default.

Overwrite installation: The user group used in the last installation applies.

--install-path=<path>

Specifies the installation directory. Otherwise:

• For installation as the root user, the default installation path is /usr/local/Ascend.
• For installation as a non-root user, the default installation path is ${HOME}/Ascend.

The running user must have the read and write permissions on the specified path. The path can contain letters, digits, underscores (_), hyphens (-), periods (.), and a slash (/). Note that periods (.) are not allowed in a relative path and slashes (/) are not allowed in a file or directory name.

--install-for-all

Allows all users to have the same installation group permission.

If this option is included in the installation command, all users have the same permission on the directories and files created by the runfile installer as the installation group.

If the --install for all option is used during the initial installation, retain it during any overwrite installation.

Example: ./xx.run --full --install-for-all

--reset

Restores the initial configuration. (This parameter applies only to the firmware subpackage.)

• --full --reset: restores the initial configuration by means of installation. The command takes effect immediately after the system is restarted. If the installation fails, the initial configuration fails to be restored.
• --upgrade --reset: restores the initial configuration by means of upgrade. The command takes effect immediately after the system is restarted. If the upgrade fails, the initial configuration fails to be restored.

After the initial configuration is restored, the original personal configuration data on the device becomes invalid and needs to be reconfigured. The personal configuration data includes the SSH login password and SSH enabling status.

After the initial configuration is restored, change the SSH login password of the device (including the passwords of the HwHiAiUser and root users) immediately.

--uninstall

Performs uninstallation.

--nox11

Indicates that the graphical terminal window is not displayed during the installation.

Example: ./xx.run --full --nox11

--noexec

Skips the execution of the installation script. This parameter is used together with the --extract=path parameter, in the format of --noexec --extract=path.

--extract=<path>

Extracts the runfile to a specified path. When this parameter is used, a directory is automatically created during the extraction.

For example, after the --noexec --extract=./package command is executed, the decompressed files are automatically stored in the package directory.

--upgrade

Performs the upgrade.

• In the initial installation scenario, the system is installed in the /usr/local/Ascend directory by default.
• In a non-initial installation scenario, the upgrade can be performed only from the path where the software package is stored.
  NOTE:

  This parameter cannot be used together with --install-username, --install-for-all, or --install-usergroup.

  The container computing power allocation scenario is supported by default.

--help or -h

Displays help information.

--check

Checks the software package integrity and the mapping between installed software packages.

--version

Queries the version.

--tar arg1 [arg2 …]

Runs the tar command on the installation package. Arguments following tar are used as the command arguments. For example, the --tar xvf command decompresses a package to the current path.

--list

Lists the files in the installation package.

--info

Displays detailed information of a data packet.

--quiet

Indicates silent installation, which skips interactive messages.

In silent installation mode, if the permission on the installation directory is greater than 755, security risks are reported. In this case, you can choose to terminate the installation or re-execute the runfile in another directory with permission 755.

Example: ./xx.run --full --quiet

--repack [package_name]

Builds a new driver package.

package_name indicates the name of the newly built xx.run driver package.

--repack-path=<path> [package_name]

Builds a new driver package in the specified path.

• path indicates the directory where the original .run package is extracted.
• package_name indicates the name of the newly built xx.run driver package.

--force

This option only installs the package. You need to restart the system for the package to take effect. (This parameter applies only to the driver subpackage.)

This option must work with any one among --run, --full, --upgrade, and --uninstall, for example, ./xx.run --full --force.