Supported Command-Line Options

One-click installation is supported on the command line. You can select and combine options as required to complete the installation. All options below are optional.

Installation command syntax: ./*.run [options]

Table 1 describes the supported options.

Table 1 Supported command-line options

Option

Description

--help or -h

Displays help information.

--info

Displays detailed package information.

--list

Lists the files in the installation package.

--check

Checks the runfile integrity and the mapping between runfiles.

--quiet

Implements the 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.

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

--nox11

Prevents an xterm terminal window from being displayed during installation.

--noexec

Skips the execution of the installation script. This option must work with --extract=path. Syntax: --noexec --extract=path

--extract=path

Extracts the runfile to a specified path.

--tar arg1 [arg2 …]

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

--run

Implements the run mode, that is, installs only the files required at the AMCT run time.

--full

Implements the full installation mode, which installs all files.

--uninstall

Uninstalls AMCT.

--upgrade

Upgrades AMCT.

--install-path=<path>

Specifies the AMCT installation path, either absolute or relative. The running user must have the read and write permissions on the specified path.

  • If the specified path does not exist, the last-level directory will be automatically created during the installation.
  • If the specified path exists, ensure that the installation user has the read, write, and execute permissions on the 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 user 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 user group.

This option must work with any one among --run, --full, and --upgrade, for example, ./*.run --full --install-for-all.

NOTE:

Ensure that the security risks are considered before you include this option.

--version

Queries the package version.

--pre-check

Before installation, prechecks whether dependencies for AMCT exist.

--setenv

During installation, sets the environment variables for AMCT running by modifying ~/.bashrc. This option works with --full or --run.

  • If the installation user is the same as the running user, for example, the same non-root user, you simply need to run the source ~/.bashrc command for the environment variables to take effect after installation. The environment variables set in this mode take effect permanently.
  • If the installation user differs from the running user, for example, the installation user is root while the running user is a non-root user, you need to run the following command as a non-root user to make the environment variables take effect. The environment variables set in this mode take effect only in the current window.
    source ${install_path}/amct_acl/bin/setenv.bash

--docker-root

Specifies the installation path of an image and modifies the .bashrc file (for example, that of the bash shell). Required if AMCT is installed in a container through an image.

Command example: ./*.run --docker-root=/home/docker --install-path=/usr/ascend_demo, which indicates that the actual installation path is /home/docker/usr/ascend_demo. That is, the installation path is $(docker-root)/$(install-path).

It is advised to use this option in pair with --setenv to spare manual configuration. The --docker-root option specifies the image installation path, and then the --setenv option writes the environment variable configuration to the .bashrc file in the path specified by --docker-root.