CCE AI套件（Ascend NPU）

插件简介

CCE AI套件（Ascend NPU）是支持容器里使用huawei NPU设备的管理插件。

安装本插件后，可创建“AI加速型”节点，实现快速高效地处理推理和图像识别等工作。

约束与限制

• 集群中使用“AI加速型”节点时必须安装CCE AI套件（Ascend NPU）插件。
• “AI加速型”节点迁移后会重置节点，如果目标集群huawei-npu插件开启了“驱动选择”功能（仅插件版本为1.2.5及以上时支持），且选择了NPU节点机型对应的驱动，节点迁移后将自动安装NPU驱动，驱动安装完成后需要重启节点才能生效。否则不会自动安装NPU驱动，需要手动重新安装。
• 若已在节点池的“安装后执行脚本”设置了NPU驱动安装命令，且开启了“驱动选择”功能并选择了对应机型的NPU驱动，节点池扩容会导致前端设置的安装命令和npu-driver-installer Pod 同时在新增节点上安装驱动，可能导致安装的驱动和预期不符或安装失败。因此，不建议在huawei-npu驱动选择功能已开启的情况下，对已设置“安装后执行脚本”NPU驱动安装命令的节点池进行扩容，或在创建新节点池时设置“安装后执行脚本”用于安装NPU驱动。

安装插件

1. 登录CCE控制台，单击集群名称进入集群，单击左侧导航栏的“插件中心”，在右侧找到CCE AI套件（Ascend NPU）插件，单击“安装”。
2. 选择是否开启驱动选择（仅插件版本为1.2.5及以上时支持）。
   • 开启：可根据NPU机型不同指定相应的驱动版本，驱动维护更灵活。
     根据不同的适用机型选择是否启用驱动，启用后插件将根据用户指定的驱动版本自动进行驱动安装。默认使用“推荐驱动”，您也可以选择“自定义驱动”并填写完整的驱动地址。

     

     • 插件将根据用户针对指定机型选择的驱动版本进行驱动安装。仅对未安装NPU驱动的节点生效，已安装 NPU 驱动的节点会保持现状。升级或编辑插件参数时修改驱动版本也只对未安装 NPU 驱动的节点生效。
     • 驱动安装成功后需要重启节点才能生效，驱动安装成功确认方式请参见如何确认节点NPU驱动已安装完成。
     • 插件卸载不会自动删除已安装的NPU驱动，如需卸载，卸载方式请参见NPU驱动卸载。
   • 关闭：无法根据用户诉求指定驱动版本，无法依靠插件进行驱动维护。当不开启驱动选择时，如从控制台创建NPU节点，控制台会自动补充NPU驱动（用户无法指定版本和类型）安装命令，并在安装完成后自动重启节点；如通过API或其他方式创建节点则需要用户在“安装后执行脚本”中添加驱动安装命令。
   • 支持的NPU卡类型和对应的操作系统规格如下：

     NPU卡类型	支持的操作系统
     D310	EulerOS 2.5 x86、CentOS 7.6 x86、EulerOS 2.9 x86、EulerOS 2.8 arm

3. 设置NPU参数，该插件默认使用如下参数。插件提供的默认NPU参数可满足大多数的使用场景，您无需修改。

   {
   	"check_frequency_failed_threshold": 100,
   	"check_frequency_fall_times": 3,
   	"check_frequency_gate": false,
   	"check_frequency_recover_threshold": 100,
   	"check_frequency_rise_times": 2,
   	"container_path": "/usr/local/HiAI_unused",
   	"host_path": "/usr/local/HiAI_unused"
   }

4. 单击“安装”。

组件说明

如何确认节点NPU驱动已安装完成

NPU驱动安装成功后需要重启节点才能生效，且重启节点前需要确认驱动已经安装完成，否则驱动将无法生效，NPU资源不可用。驱动安装完成确认方式如下：

1. 在集群 “插件中心”页面，单击插件名称查看插件“实例列表”。

   

2. 查看该节点上部署的 npu-driver-installer 实例状态为“运行中”。

   

   

   若在NPU驱动安装完成前就重启了节点，可能导致驱动安装失败，节点重启后集群“节点管理”页面对应的节点会显示“昇腾驱动未就绪”。此时需要先卸载该节点上的NPU驱动，再重启 npu-driver-installer Pod，才能重新安装NPU驱动，按上述步骤确认驱动安装完成后再重启节点。驱动卸载方式请参见NPU驱动卸载。

NPU驱动卸载

请登录节点，通过 /var/log/ascend_seclog/operation.log 获取驱动操作记录，确认最后一次安装的驱动 run 包；若该日志不存在，则一般是用 npu_x86_latest.run或 npu_arm_latest.run 驱动合一包安装的；找到驱动安装包后，执行 bash {run 包名称} --uninstall 命令即可卸载，卸载成功后根据提示决定是否重启节点。

1. 登录需要卸载NPU驱动的节点，查看 /var/log/ascend_seclog/operation.log 是否存在。
2. 若 /var/log/ascend_seclog/operation.log 日志存在，查看驱动安装日志，可查找到驱动安装记录。

   

   若 /var/log/ascend_seclog/operation.log 日志不存在，则可能是通过 npu_x86_latest.run或 npu_arm_latest.run 驱动合一包安装的，可通过 /usr/local/HiAI/driver/ 路径是否存在进行确认。

   

   NPU驱动合一包一般放在 /root/d310_driver 目录下，其他驱动安装包一般放在 /root/npu-drivers 目录下。

3. 找到驱动安装包后，执行 bash {run 包路径} --uninstall 命令即可卸载，以 Ascend310-hdk-npu-driver_6.0.rc1_linux-x86-64.run 为例：

   bash /root/npu-drivers/Ascend310-hdk-npu-driver_6.0.rc1_linux-x86-64.run --uninstall

   

4. 根据提示信息确认是否需要重启节点（当前使用的NPU驱动安装和卸载都需要重启节点才能生效）。

版本记录