Installing the Ascend Docker Runtime
Setting Up the Environment
- The Docker version must be 18.03 or later.
- The driver and firmware have been installed on the host. For details, see "Environment Setup > Software Installation > Preparing the Hardware Environment" in the CANN Software Installation Guide.
Installation
To install the Ascend Docker Runtime, perform the following steps:
- After the installation package is downloaded, go to the path where the installation package (.run package) is stored.
cd <path to run package>
- Run the following command to install the Ascend Docker Runtime:
chmod +x Ascend-docker-runtime_{version}_linux-{arch}.run ./Ascend-docker-runtime_{version}_linux-{arch}.run --install - After the installation is successful, run the following command for the Ascend Docker Runtime to take effect:
systemctl daemon-reload && systemctl restart docker
Only the root user can install Ascend Docker Runtime.
Parameters supported by the installation package lists the parameters supported by the Ascend Docker Runtime installation package.
Parameter |
Description |
|---|---|
--help | -h |
Queries help information. |
--info |
Queries software package build information. |
--list |
Queries the software package list. |
--check |
Checks the consistency and integrity of software packages. |
--quiet | -q |
Indicates silent installation, which skips interactive messages. It must be used together with install, uninstall, or upgrade. |
--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 software package. Use the parameters following tar as the command parameters. 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-path=<path> |
Specifies the installation path. If the global configuration file ascend_dcoker_runtime_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 Ascend Docker Runtime software package in the original path and ensure that the global configuration file ascend_dcoker_runtime_install.info has been deleted. If the Ascend Docker Runtime of a version earlier than 3.0.0 is installed using the ToolBox installation package, the file does not exist and does not need to be deleted. If this parameter is not specified, the tool is installed in the default path /usr/local/Ascend. If this option 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. |
--install-type=<type> |
It can be used only when the Ascend Docker Runtime package is installed on the Atlas 200 (RC), Atlas 200I SoC A1, and Atlas 500. It specifies the type of the product to be installed (for example, Atlas 200, Atlas 200I SoC, or Atlas 500). This parameter must be used together with --install. |
- The Atlas 200 AI accelerator module (RC), Atlas 200I SoC A1 core board, and Atlas 500 AI edge station (model 3000) support the Ascend Docker Runtime tool. During installation or upgrade, specify --install-type=<type> to set the default mounting of the Ascend Docker Runtime tool.
- For the Atlas 200 AI accelerator module (RC), run the following command:
./Ascend- docker-runtime_{version}_linux-{arch}.run --install --install-type=A200
- For the Atlas 200I SoC A1 core board, run the following command:
./Ascend- docker-runtime_{version}_linux-{arch}.run --install --install-type=A200ISoC
- For the Atlas 500 AI edge station (model 3000), run the following command:
./Ascend- docker-runtime_{version}_linux-{arch}.run --install --install-type=A500
Upgrade
To upgrade the Ascend Docker Runtime, perform the following steps:
- After the installation package is downloaded, go to the path where the installation package (.run package) is stored.
cd <path to run package>
- Run the following command to upgrade the Ascend Docker Runtime:
chmod +x Ascend-docker-runtime_{version}_linux-{arch}.run ./Ascend-docker-runtime_{version}_linux-{arch}.run --upgrade - After the upgrade is successful, run the following command for the Ascend Docker Runtime to take effect:
systemctl daemon-reload && systemctl restart docker
If the current Ascend Docker Runtime is installed using the ToolBox installation package, you need to find the script path of the Ascend Docker Runtime in the ToolBox installation path, run the uninstall.sh script to uninstall the Ascend Docker Runtime earlier than 3.0.0, and download the new Ascend Docker Runtime installation package to install the Ascend Docker Runtime, after the installation is complete, restart the server and then Docker. You can obtain the Ascend Docker Runtime installation package by referring to Software Package Description.