Parameter Description

One-click software installation is supported in the command line. You can select commands as required to complete the installation. All parameters below are optional.

Installation command format: ./{run_file_name}.run [options]

For details, see Table 1.

If the parameters queried by running the ./{run_file_name}.run --help command are not described in the following table, the parameters are reserved or applicable to other processor versions. You can ignore them.

Table 1 Parameters supported by the installation package

Parameter

Description

--help | -h

Queries help information.

--version

Queries version information.

--info

Queries software package construction information.

--list

Queries the software package list.

--check

Checks the consistency and integrity of software packages.

--quiet

Indicates silent installation, which skips interactive messages.

--nox11

Does not use the x11 operating mode.

--noexec

Decompresses a software package to the current directory without running the installation script. This parameter is used together with --extract=<path>. The format is as follows:

--noexec --extract=<path>

--extract=<path>

Decompresses a software package to a specified directory.

--tar arg1 [arg2 ...]

Runs the tar command on the runfile. Use the options following tar as the command-line options. For example, the --tar xvf command indicates that the RUN package will be decompressed to the current directory.

--install

Installs a software package. You can specify the installation path --install-path=<path> or use the default installation path.

--install-for-all

Allows all users to have the same installation group permission.

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

This parameter must be used in pair with any one among --install and --upgrade, for example, ./*.run --install --install-for-all.

NOTE:
  • Only the root user can use this parameter.
  • Make sure the security risks are considered before you include this parameter.

--install-path=<path>

Specifies the installation path. If the global configuration file ascend_toolbox_install.info exists in the environment, the specified installation path must be the same as that saved in the global configuration file. If you want to change the installation path, uninstall the toolbox software package in the original path and ensure that the global configuration file ascend_toolbox_install.info has been deleted.

You can run the following command to check whether the file exists in the following directory:

  • root user: /etc/Ascend
  • Non-root user: ${HOME}/Ascend

If you do not specify the path, the default path is used.

  • 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.

If this parameter is used to specify the installation directory, the running user must have the read and write permissions on the specified installation directory.

--uninstall

Uninstalls the software that has been installed.

--upgrade

Upgrades the software that has been installed.

--alternative

This parameter exists due to historical reasons. You can neglect it.

--blacklist=<feautre1, feature2, feature3,...>

This parameter exists due to historical reasons. You can neglect it.

--whitelist=<feature1, feature2, feautre3,...>

This parameter exists due to historical reasons. You can neglect it.

--install-type=<type>

This parameter exists due to historical reasons. You can neglect it.

The following parameters are internal invocation parameters and are not displayed in --help. Do not use them directly.

  • --xwin: uses the xwin operating mode.
  • --phase2: performs the second step.
  • --repack: repacks a package.
  • --repack-path=: specifies the output path of the repacked file.
  • --run: installs only the files required in the operating scenario.
  • --full: performs full installation.
  • --lsm: specifies the Linux Software Map (LSM) file.