Installing the NPU driver (Online Installation Using Yum)

This section describes how to quickly install the NPU driver using Yum.

Preparing Users

This section describes how to create an installation and running user. If the user already exists, skip this section.

Table 1 User types

Component

Installation User

Running User

NPU driver

root

  • When the driver is installed, the running user and user group are specified as HwHiAiUser by default. Therefore, you need to create the running user and user group of HwHiAiUser before installing the software package.
  • If the created user and user group are not HwHiAiUser (including root), you must specify the running user when installing the driver.

The following users are used in the example steps:

  • The root user is used to install the driver.
  • The running user is the non-root user HwHiAiUser (default running user of the driver).
Run the following command to create the HwHiAiUser user and user group:
1
2
groupadd HwHiAiUser
useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash

For the usage and configuration requirements of the default user HwHiAiUser, see Atlas Hardware Product Account List. You can create other non-root users on your own.

Installing Dependencies and Configuring the Ascend Repository

  1. Run the following command to check whether the repository is available.
    1
    yum makecache
    

    If the system reports an error or the waiting time becomes excessive, check whether the network is connected or modify the /etc/yum.repos.d/xxxx.repo file to configure an available repository. (For example, to configure the Huawei mirrored repository, you can see the configuration method of the mirrored repository in the Huawei Open-Source Mirror Site).

  2. Install the required dependencies.
    1
    yum install -y make dkms gcc kernel-headers-$(uname -r) kernel-devel-$(uname -r)
    

    If an error is reported or the dependency does not exist, see Installing Dependencies Required for Compiling Driver Source Code.

  3. Configure the Ascend repository. Otherwise, the installation will fail.
    curl https://repo.oepkgs.net/ascend/cann/ascend.repo -o /etc/yum.repos.d/ascend.repo && yum makecache

Installing the NPU Driver

Table 2 Installing the driver

Product Type

Installation Command

Atlas A3 series

1
yum install -y Atlas-A3-hdk-npu-driver-25.5.0

Atlas A2 series

1
yum install -y Ascend910B-driver-25.5.0

Atlas training series

1
yum install -y Ascend-hdk-910-npu-driver-25.5.0

Atlas inference series

1
yum install -y Ascend-hdk-310p-npu-driver-25.5.0
After the installation is complete, determine whether to restart the system based on the displayed information. If you need to restart the system, run the reboot command. After the restart, run the following command to check whether the driver is successfully loaded:
1
npu-smi info

If the driver information is displayed, the driver is successfully loaded. Otherwise, the loading fails. In this case, visit Support to seek help or submit a technical service ticket.