依赖组件介绍

本章节针对常见支持的硬件设备提供了对应的驱动、固件等安装包名以供参考，对于未提及的相关硬件型号的驱动、固件安装包等，请向华为工程师获取帮助。

FeatureRetrieval通过二进制动态共享库提供，其依赖开放态的CANN、OpenBLAS、Faiss，使用FeatureRetrieval前请提前安装这些依赖库。开放态CANN软件包获取和具体环境安装方法参考《CANN 软件安装指南》或《CANN 软件安装指南（开放态）》。如果需要在Docker环境中部署FeatureRetrieval，请参考《MindX ToolBox用户指南》中的“容器使用指导”内容完成Docker容器的部署，再执行后续FeatureRetrieval的安装。

表1 依赖包列表
简称	安装包全名	默认安装路径
CANN开发套件包	Ascend-cann-toolkit_{version}_linux-{arch}.run	/usr/local/Ascend/ascend-toolkit/latest
npu-driver驱动包	昇腾310 AI处理器硬件型号对应驱动软件包。 Ascend310-hdk-npu-driver_{version}_linux-{arch}.run Atlas 推理系列产品硬件型号对应驱动软件包。 Ascend310P-hdk-npu-driver_{version}_linux-{arch}.run	/usr/local/Ascend
npu-firmware固件包	昇腾310 AI处理器硬件型号对应固件软件包。 Ascend310-hdk-npu-firmware_{version}.run Atlas 推理系列产品硬件型号对应固件软件包。 Ascend310P-hdk-npu-firmware_{version}.run	/usr/local/Ascend
CtrlCPU开放SDK软件包	Ascend-cann-device-sdk_<version>_linux-<arch>.zip	解压后包含Runtime（MiniOS形态）和驱动源码包。
Runtime（MiniOS形态）	CANN-runtime-<version>-minios.aarch64.run 说明：此处的Runtime（MiniOS形态）包名与具体使用的CANN版本有关，FeatureRetrieval对不同版本的Runtime（MiniOS形态）包均已适配。同一个Runtime（MiniOS形态）包在开发环境、运行环境对应不同的默认路径。	/usr/local/AscendMiniOs（开发环境） /usr/local/AscendMiniOSRun（运行环境）
驱动源码包	昇腾310 AI处理器硬件型号对应固件软件包。 Ascend310-driver-{version}-minios.aarch64-src.tar.gz Atlas 推理系列产品硬件型号对应固件软件包。 Ascend310P-driver-{version}-minios.aarch64-src.tar.gz	FeatureRetrieval部署阶段解压使用，用于打包Device侧OS镜像文件。

在Docker容器环境下进行检索部署时，需要关注以下事项。
1. 由于FeatureRetrieval使用开放Control CPU方案，请确保Docker容器中检索相关的文件夹挂载正确(“/usr/local/Ascend/driver”、“/usr/local/Ascend/develop/”、“/usr/local/AscendMiniOs”等)，否则可能导致容器内的检索编译失败。
2. 检索部署算子的操作“bash install.sh”如果在Host侧（容器外）执行，需要确认在容器外能够访问到容器内编译的可执行文件和算子om文件，如果该步骤需要在容器内执行，需要确认该容器实例具备特权权限，防止FeatureRetrieval的部署失败。
对于第三方的开源软件，如果该版本中存在漏洞，需要及时根据开源版本中的对应说明进行修复和更新。

父主题： 安装依赖