文档首页/ 灵衢智算集群/ 最佳实践/ A5 超节点AI软件栈升级/ 固件和驱动升级/ 升级驱动
更新时间：2026-09-08 GMT+08:00
查看PDF
分享

升级驱动

本章节以Atlas-A5-hdk-npu-driver_x.x.x_linux-{arch}.run包为例说明，具体操作以客户实际Host系统对应驱动包为准。

  • 升级驱动时，会将动态库libdcmi.so和头文件dcmi_interface_api.h拷贝到“/usr/local/dcmi/”目录下。
  • 驱动升级过程中驱动的日志信息输出在“/var/log/ascend_seclog/ascend_install.log”文件中。
  • 如果运行用户为root用户，KMSAgent服务不可用，安装日志/var/log/ascend_seclog/ascend_install.log中会有相关WARNING记录。
  • 若业务或容器占用了Davinci节点，升级过程中系统会提示“The davinci nodes are occupied by some processes, please stop processes and install or uninstall again, details in : /var/log/ascend_seclog/ascend_install.log”报错，可以执行./Atlas-A5-hdk-npu-driver_x.x.x_linux-{arch}.run --upgrade --force命令进行强制升级，但可能导致当前正在运行的业务受到影响。
  • 对于物理机不支持PCIe卡热复位场景，请使用./Atlas-A5-hdk-npu-driver_x.x.x_linux-{arch}.run --upgrade --force命令升级驱动。

操作步骤

  1. 参照固件驱动下载准备软件包“Atlas-A5-hdk-npu-driver_x.x.x_linux-{arch}.run”。
  2. 登录服务器，并在root用户下执行以下操作。
  3. 将“Atlas-A5-hdk-npu-driver_x.x.x_linux-{arch}.run”上传至Linux系统任意目录，如“/opt”。
  4. 执行如下命令，进入软件包所在路径，如“/opt”。 

    cd /opt

  5. 执行如下命令，更改软件包权限。 

    chmod +x Atlas-A5-hdk-npu-driver_x.x.x_linux-{arch}.run

  6. 执行如下命令，校验run安装包的一致性和完整性。 

    ./Atlas-A5-hdk-npu-driver_x.x.x_linux-{arch}.run --check

    出现如下回显信息，表示软件包校验成功。

    Verifying archive integrity...  100%   SHA256 checksums are OK. All good.

    软件包校验使用SHA256加密方式，校验过程中若提示“/Atlas-A5-hdk-npu-firmware_x.x.x.x.X.run does not contain an embedded MD5 checksum.”和“./Atlas-A5-hdk-npu-firmware_x.x.x.x.X.run does not contain a CRC checksum”，表示没有使用MD5和CRC加密方式，可忽略。

  7. 执行如下命令，完成升级。升级过程支持一键式升级操作。 

    ./Atlas-A5-hdk-npu-driver_x.x.x_linux-{arch}.run --upgrade

    若系统出现如下关键回显信息，表示升级成功。

    Driver package upgraded successfully!

  8. （可选）根据系统提示信息决定是否重启系统，若需要重启，请执行以下命令；否则，请跳过此步骤。 

    reboot

  9. 执行如下命令，检查升级后的版本号。 

    /usr/local/Ascend/driver/tools/upgrade-tool --device_index -1 --system_version
    • 若版本号与目标版本号一致，则说明升级成功。
    • 若版本号与目标版本号不一致，则说明升级失败，请联系华为技术工程师处理。

父主题： 固件和驱动升级

相关文档