安装NPU驱动固件

安装说明

检查安装环境

在安装驱动固件前，建议按照以下检查项检查环境，确保驱动固件能正常安装。

表1 环境检查

检查项

检查方法

检测NPU芯片是否正常在位

可通过命令行或BMC管理页面检查NPU芯片是否正常在位，如果执行命令时，提示没有安装lspci，可通过BMC管理页面检查。

  • 执行lspci | grep d802命令，如果服务器上有N（N＞0）路NPU芯片，回显中含“d802”字段的行数为N，则表示NPU芯片正常在位。
    01:00.0 Processing accelerators: Huawei Technologies Co., Ltd. Device d802 (rev 20)
02:00.0 Processing accelerators: Huawei Technologies Co., Ltd. Device d802 (rev 20)
41:00.0 Processing accelerators: Huawei Technologies Co., Ltd. Device d802 (rev 20)
42:00.0 Processing accelerators: Huawei Technologies Co., Ltd. Device d802 (rev 20)
  • 通过iBMC查询NPU芯片名称方法：登录iBMC Web管理网站，选择“系统管理 > 系统信息”，单击“处理器”，查看NPU型号信息。

确认操作系统和内核版本

在安装驱动前，需要用户确认现场操作系统和内核版本，从而确定是否需要安装驱动编译所需依赖。

执行如下命令查看现场服务器操作系统和内核版本，并和华为的版本要求进行对比。 
uname -m && cat /etc/*release
uname -r

华为发布的驱动配套的操作系统和内核版本如表2所示。

表2 Atlas 900 A2 PoD 集群基础单元昇腾NPU驱动对应的OS版本要求

host操作系统版本

host操作系统架构

软件包默认的host操作系统内核版本

gcc编译器版本

安装方式

Ubuntu 22.04

aarch64

5.15.0-25-generic

11.3.0

二进制安装。

直接按照安装驱动固件内容安装驱动固件。

openEuler 22.03 LTS

aarch64

5.10.0-60.18.0.50.oe2203.aarch64

10.3.1

源码编译安装。

  1. 需要先参见安装驱动源码编译所需依赖安装dkms等依赖。
  2. 再按照安装驱动固件内容安装驱动固件。

Kylin V10 SP2

aarch64

kernel-4.19.90-24.4.v2101.ky10.aarch64

7.3.0

BC-Linux V21.10

aarch64

4.19.90

7.3.0

安装驱动固件

  1. 以root用户登录服务器。
  2. 创建驱动运行用户HwHiAiUser（运行驱动进程的用户），安装驱动时无需指定运行用户，默认即为HwHiAiUser。

    groupadd HwHiAiUser
useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash

    若用户后续需使用从AscendHub拉取的容器镜像，则请用户执行如下命令创建uid和gid为1000的驱动运行用户HwHiAiUser。

    groupadd -g 1000 HwHiAiUser
useradd -g HwHiAiUser -u 1000 -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash

    若回显如下信息，请参见创建uid和gid为1000的驱动运行用户HwHiAiUser失败解决。

    groupadd：GID '1000' already exists

  3. 将驱动包和固件包上传到服务器任意目录如“/home”。
  4. 执行如下命令，增加驱动和固件包的可执行权限。

    chmod +x Ascend-hdk-xxx-npu-driver_23.0.rc2.2_linux-aarch64.run
chmod +x Ascend-hdk-xxx-npu-firmware_6.4.0.2.220.run

  5. 执行以下命令，完成驱动固件安装，软件包默认安装路径为“/usr/local/Ascend”。

    • 安装驱动

      执行以下命令，完成驱动安装。

      ./Ascend-hdk-xxx-npu-driver_23.0.rc2.2_linux-aarch64.run --full --install-for-all

      若执行上述安装命令出现类似如下回显信息，请参见安装驱动固件报错解决。

      [ERROR]The list of missing tools: lspci,ifconfig,
      若系统出现如下关键回显信息，则表示驱动安装成功。 
      Driver package installed successfully!
    • 安装固件
      执行以下命令，完成固件安装。 
      ./Ascend-hdk-xxx-npu-firmware_6.4.0.2.220.run --full

      若系统出现如下关键回显信息，表示固件安装成功。

      Firmware package installed successfully! Reboot now or after driver installation for the installation/upgrade to take effect

  6. 执行reboot命令重启系统。
  7. 执行npu-smi info查看驱动加载是否成功。

    若出现类似如下图所示回显信息，说明加载成功。否则，说明加载失败。请联系华为技术支持处理。

父主题： 昇腾软件安装指南