Parameter Description
The .run installation package supports one-click installation. You can select parameters as required to complete the installation. All parameters are optional.
- For NPU 20.X.X or later, run the ./*.run --[options] command to install the software packages. For details about the parameters, see Table 9-6.
If the parameters queried by running the ./*.run --help command are not described in Table 9-6, they are reserved or applicable to other chip versions and therefore can be ignored.
- For NPU 1.X.X, run the ./*.run --<commands> --<addition options> command to install the software packages. For details about the parameters, see Table 9-7.
addition options is optional and can be used together with installation, uninstallation, and update parameters.
Parameter |
Description |
---|---|
info |
Displays the package information. |
list |
Lists the files in the .run installation package. |
check |
Checks the integrity of the .run installation package. |
full |
Indicates the full installation mode, which installs all files. NOTE:
|
run |
Indicates the running mode, which installs only the files required in a running scenario. NOTE:
|
docker |
Container installation: applies to Driver only. Other components are installed in full mode by default.
NOTE:
|
install-username=<username> |
Initial installation: You can specify the running user name. Otherwise, HwHiAiUser is used by default. Overwrite: The user name used in the last installation is adopted. NOTE:
|
install-usergroup=<usergroup> |
Initial installation: You can specify the running user group name. Otherwise, HwHiAiUser is used by default. Overwrite: The user group name used in the last installation is adopted. NOTE:
|
install-path=<path> |
Installation path. The path can contain only letters (a-z and A-Z), digits (0-9), periods (.), underscores (_), and hyphens (-). If not specified: The default installation path is /usr/local/Ascend. The running user must have the read and write permissions on the specified installation path. NOTE:
The firmware installation path cannot be specified. The driver installation path is shared. |
install-for-all |
Allows all users to have the same installation group permission. If this option is included in installation or upgrade command, all users have the same permission on the directories and files created by the runfile installer as the installation group. This option must be used in pair with any one among --run, --devel, --full, and --upgrade, for example, ./*.run --full --install-for-all. NOTE:
This parameter is supported when the software package of NPU 20.0.0 or later, NPU 20.1.X, or NPU 21.0.X is installed. However, the function is unavailable. This parameter is unavailable when the software package of NPU 20.2.X is used for installation. The firmware does not support this parameter. Make sure the security risks are considered before you include this option. |
reset |
Restores the initial configuration. (This parameter applies only to the firmware subpackage.)
After the initial configuration is restored, the original personal configuration data on the device becomes invalid and needs to be reconfigured. NOTE:
|
devel |
Indicates the development mode, which contains the header files that users need to use for development. The firmware subpackage does not support this parameter. |
upgrade |
Upgrades to the target version. NOTE:
After the installation or upgrade is complete, you need to manually restart the OS for the new version to take effect. |
uninstall |
Uninstalls the current version. |
noexec |
Does not run the installation script. This parameter is used together with the --extract=path parameter. Format: --noexec --extract=path |
extract=path |
Decompresses the installation package to a specified directory. |
--tar arg1 [arg2 ...] |
Runs the tar command on the software package. Use the arguments following tar as the command arguments. For example, the --tar xvf command indicates that the .run package will be decompressed to the current directory. |
quiet |
Indicates the silent installation, which skips interactive messages. Silent installation is not supported if a specified kernel directory is required for installing a source code driver package. In quiet installation mode, if the permission on the installation directory is greater than 755, you will be warned of security risks. In this case, you can choose to terminate the installation or re-execute the runfile in another directory with permission 755. This option must be used in pair with any one among --run, --devel, --full, and --upgrade, for example, ./*.run --full --quiet. |
version |
Displays the version information. |
Parameter |
Name |
Description |
---|---|---|
commands |
info |
Displays the package information. |
list |
Lists the files in the .run installation package. |
|
check |
Checks the integrity of the .run installation package. |
|
basic |
Installs or upgrades the nputool, Driver, and Runtime modules. |
|
classic |
Installs or upgrades the nputool, Driver, Runtime, and Toolkit modules. |
|
full |
Installs or upgrades the nputool, Firmware, Driver, Runtime, Toolkit, and Sample modules. |
|
uninstall |
Uninstalls the current version. |
|
upgrade |
Upgrades to the target version. NOTE:
After the installation or upgrade is complete, you need to manually restart the OS for the new version to take effect. |
|
delayedupgrade |
Upgrades to the target version and makes the upgrade take effect in a delay. |
|
viewlog |
Displays installation logs and exits the installation process. |
|
addition options |
path |
Indicates the path of the installation package. NOTE:
|
reset |
Restores the login password on the device. NOTE:
|