Installing the NPU Driver (Online Installation Using Yum)

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

Preparing Users

The following describes how to create installation and running users. If the users already exist, skip this section.

Table 1 User types

Component

Installation User

Running User

NPU driver

root

  • Since the running user and user group are specified as HwHiAiUser by default during driver installation, you must create the HwHiAiUser running user and user group manually before installing the software packages.
  • If the created user and user group are not HwHiAiUser (including root), you must specify the running user when installing the driver.

The users used in the example steps in this document are as follows:

  • Driver installation user: root
  • Running user: Non-root user HwHiAiUser (default running user for the driver)
Run the following commands 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. Check whether the source 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 dependencies.
    1
    yum install -y make dkms gcc kernel-headers-$(uname -r) kernel-devel-$(uname -r)
    

    If an error is reported or any dependency does not exist, rectify the fault by referring to 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 350 Accelerator Card

1
yum install -y Atlas-A5-hdk-npu-driver-25.7.rc1

Atlas A3 series

1
yum install -y Atlas-A3-hdk-npu-driver-26.0.rc1

Atlas A2 series

1
yum install -y Ascend910B-driver-26.0.rc1

Atlas training series

1
yum install -y Ascend-hdk-910-npu-driver-26.0.rc1

Atlas inference series

1
yum install -y Ascend-hdk-310p-npu-driver-26.0.rc1
After the installation is complete, determine whether to reboot the system based on the displayed information. If you need to reboot the system, run the reboot command. After the reboot, 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. Visit the Support website to seek help in the forum or submit a technical service ticket.