Supported OSs

You can use the ascend-deployer tool to download and install dependencies of OSs listed in Table 2. The precautions are as follows:

To check the compatibility information, use the Compatibility Checker. The ascend-deployer tool can be used to install MindStudio, MindX DL, MEF Center, and MindIO on the following OSs:
- MindStudio: Ubuntu_18.04, Ubuntu_22.04, openEuler_22.03LTS, EulerOS_2.8
- MindX DL: Ubuntu_18.04, Ubuntu_20.04, Ubuntu_22.04, openEuler_20.03LTS, openEuler_22.03LTS, CentOS_7.6
- MEF Center: Ubuntu_20.04, openEuler_22.03LTS
- MindIO: Ubuntu_18.04, Ubuntu_20.04, Kylin V10 SP2, openEuler_20.03LTS, openEuler_22.03LTS, CentOS_7.6, UOS_20-1020e
Basic commands such as tar, cd, ls, find, grep, chown, chmod, unzip, bzip2, and ssh must be preset in the OS. During the installation of Ubuntu, select OpenSSH server or SSH server on the Software selection screen to avoid the absence of the ssh command.
ascend-deployer supports only the default environment after the OS image is successfully installed. Do not install or uninstall software after the OS is installed. If some system software has been uninstalled, causing inconsistency with the default system package, you need to manually configure the network and use tools such as apt, yum, and dnf to install and configure the missing software.
ascend-deployer can install only basic libraries to ensure that TensorFlow and PyTorch can run properly. If you need to run complex inference services or model training, the model code may contain libraries related to specific services. You need to install the libraries by yourself.
If the driver version installed using ascend-deployer does not match the system kernel version, you can refer to Installing Dependencies Required for Compiling Driver Source Code to manually install the desired driver.
The automatic kernel upgrade function must be disabled for the OSs. Take Ubuntu as an example. After it is installed and restarted, you can run the sudo apt-mark hold linux-image-generic linux-headers-generic linux-image-extra command to disable automatic kernel upgrade (delete sudo when running this command as the root user). For users of other OSs or systems with custom upgrades, disable the function according to the corresponding OS guides.

Installing drivers on OSs such as EulerOS may trigger driver source code compilation. You need to install a kernel header package that matches the kernel version of the system (which can be viewed through uname -r command). For details, see Table 1.

**Table 1** Kernel header packages
OS	Kernel Header Package	How to Obtain
EulerOS	kernel-headers-{version}, kernel-devel-{version}	Contact the OS vendor or search for the tool in the devel_tools.tar.gz file delivered with the OS.

By default, the root user is not allowed to remotely log in to OSs such as EulerOS. Therefore, you need to set PermitRootLogin in the /etc/ssh/sshd_config file to yes before the installation. The configuration method varies according to OSs. For details, see the official guide of the OS. After the installation is complete, disable the remote connection of the root user in a timely manner.
When CentOS is used as the executor OS and ascend-deployer is used for batch deployment, devices running Ubuntu cannot be deployed.

**Table 2** Supported OSs
OS	Version	CPU Architecture	Description
CentOS	7.6	AArch64/x86_64	Add a kernel patch to an Atlas 300T training card running CentOS 7.6 x86_64 with a kernel version earlier than 4.5. Otherwise, the firmware installation may fail. For details about how to add a kernel patch, see Building a Kernel Patch. Multiple versions of Docker/containerd can coexist on CentOS. Therefore, you are advised to check whether Docker has been installed before installing system dependencies on CentOS 7.6. If Docker has been installed, run the yum -y remove docker-ce, yum -y remove docker-ce-cli, and yum -y remove containerd.io commands to uninstall it and then install system dependencies.
CTyunOS	22.06	AArch64/x86_64	Only Kubernetes 1.25.3 and partial components of MindX DL 5.0.RC2 can be installed on CTyunOS.
EulerOS	2.8	AArch64	-
EulerOS	2.9	AArch64/x86_64	-
EulerOS	2.10	AArch64/x86_64	-
Kylin	V10 SP1	AArch64/x86_64	After system dependencies are installed in the Kylin V10 system, wait until system configurations are complete and then run commands such as docker. Specify Kylin_V10Tercel_aarch64 or Kylin_V10Tercel_x86_64 as the dependency for the Kylin V10 SP1 system. Specify Kylin_V10Sword_aarch64 as the dependency for the Kylin V10 SP2 system.
Kylin	V10 SP2	AArch64
Kylin	V10 GFB	AArch64	Specify Kylin_V10_aarch64 as the dependency for the Kylin V10 GFB system.
openEuler	20.03 LTS 22.03 LTS	AArch64/x86_64	-
UOS	20-1020e	AArch64	-
Ubuntu	18.04.1, 18.04.5, 20.04 LTS, 22.04 LTS	AArch64/x86_64	The cross-compilation-related components and the AArch64 Toolkit software can be installed on Ubuntu x86_64.