安装NPU驱动

本章节介绍虚拟机上NPU驱动的安装方法，以Ascend-hdk-310b-npu-driver_x.x.x_linux-{arch}.run软件包为例说明，具体操作以客户系统对应驱动包为准。

前提条件

物理机已经安装过驱动和固件，详情请参见安装驱动和安装固件。
当前环境已创建并启动虚拟机。
当前环境已经将NPU芯片直通到虚拟机，具体请参见《Atlas 系列硬件产品 25.5.0 虚拟机配置指南》的“安装虚拟机>配置NPU直通虚拟机>NPU直通虚拟机”章节。

操作步骤

将获取软件包准备的安装包上传至虚拟机的任意目录下（如“/opt”）。
使用PuTTY登录虚拟机的OS命令行，参见通过PuTTY登录（网口方式）。
执行如下命令，切换至root用户。
su - root
执行如下命令，进入软件包所在路径（如“/opt”）。
cd /opt
执行如下命令，增加软件包的可执行权限。
chmod +x Ascend-hdk-310b-npu-driver_x.x.x_linux-{arch}.run
执行如下命令，校验run安装包的一致性和完整性。
./Ascend-hdk-310b-npu-driver_x.x.x_linux-{arch}.run --check
若出现如下回显信息，表示软件包校验成功。
```
Verifying archive integrity...  100%   SHA256 checksums are OK. All good.
```
软件包校验使用SHA256加密方式；校验过程中若提示：./Ascend-hdk-310b-npu-driver_x.x.x_linux-{arch}.run does not contain an embedded MD5 checksum.和./Ascend-hdk-310b-npu-driver_x.x.x_linux-{arch}.run does not contain a CRC checksum，表示没有使用MD5和CRC加密方式，可忽略。
执行如下命令，完成驱动安装，软件包默认安装路径为“/usr/local/Ascend”。
./Ascend-hdk-310b-npu-driver_x.x.x_linux-{arch}.run --full
安装详细日志路径：/var/log/ascend_seclog/ascend_install.log。
安装后软件包的安装路径、安装命令以及运行用户信息记录路径为“/etc/ascend_install.info”。
安装run包驱动时，会将动态库libdcmi.so和头文件dcmi_interface_api.h拷贝到“/usr/local/dcmi/”目录下。
如果运行用户为root用户，KMSAgent服务不可用，安装日志/var/log/ascend_seclog/ascend_install.log中会有相关WARNING记录。
若创建运行用户是非HwHiAiUser，安装驱动软件包时需要指定运行用户（通过--install-username=username --install-usergroup=usergroup参数指定）。
如果使用参数--install-username=root --install-usergroup=root，则需要与--install-for-all参数配合使用，该场景下权限控制可能存在安全风险。

Device侧系统类日志通过msnpureport工具传输到Host侧进行查看。导出操作以及导出日志的存储路径具体请参见《Atlas 系列硬件产品 25.5.0 msnpureport 工具使用指南》的“导出Device侧系统类日志和其他维测信息”章节。
若用户需要指定安装路径，如以“/test/HiAI/”为例，可执行如下命令完成安装。

./Ascend-hdk-310b-npu-driver_x.x.x_linux-{arch}.run --full --install-path=/test/HiAI/
- 若指定路径不存在，则安装时会自动创建目录，若有多层目录，则只有最后一层目录不存在时会自动创建。
- 若指定路径已存在：
  若该路径下所有层级目录属主为root用户，则请确保所有层级目录权限至少为755。若不满足要求，请执行如下命令修改路径权限。
  chmod 755 路径
  
  若该路径下有一层目录属主为非root用户，则请用户自行修改为root属主，并确保所有层级目录权限为755。若不满足要求，请执行如下命令修改路径属主为root。
  chown root:群组名路径
- 指定路径安装过程中，系统会对“自定义安装路径/driver/device/*”字符串的长度进行逐一校验（*代表该路径下的全部文件），若等于或大于128个字符则会安装失败。
若系统出现如下关键回显信息，则表示驱动安装成功。
```
Driver package installed successfully! 
```
（可选）根据系统提示信息决定是否重启系统，若需要重启，请执行以下命令；否则，请跳过此步骤。
reboot
执行如下命令，查看驱动加载是否成功。
/usr/local/Ascend/driver/tools/upgrade-tool --device_index -1 --system_version
若出现如下回显信息，说明加载成功，具体版本号和Device个数请以实际情况为准。否则，说明加载失败。请联系华为技术支持处理。
```
{
Get system version(25.5.0) succeed, deviceId(0)
        {"device_id":0, "version":25.5.0}
}
```
如果安装驱动时指定安装路径，则命令中的“/usr/local/Ascend”请根据实际情况替换。

父主题： 虚拟机安装与卸载