昇腾社区首页
中文
注册
开发者
下载
支持

安装Index SDK

安装须知

  • 安装和运行Index SDK的用户，需要满足：
    • 安装和运行Index SDK的用户需为同一用户，且必须与安装CANN为同一用户，否则存在运行生成算子时访问CANN的权限问题。
    • 安装和运行Index SDK的用户建议为普通用户。Index SDK依赖于CANN包的低权限用户的动态库，使用root用户运行程序时，存在链接的动态库被低权限用户篡改的安全风险。
    • 安装包所在目录、安装目标目录的属主必须为安装用户。
    • 安装Index SDK时必须保证有“~”目录且安装用户对该目录有读、写权限。
  • 特征检索以二进制共享库形式发布，软件包在本地用户自定义路径通过run包安装。

安装步骤

  1. 以软件包的安装用户登录安装环境。
  2. 将软件包上传到安装环境的任意路径下（如：“/home/work/FeatureRetrieval”）并进入软件包所在路径。
  3. 增加对软件包的可执行权限。
    chmod +x Ascend-mindxsdk-mxindex_{version}_linux-{arch}.run
  4. 执行如下命令，校验软件包的一致性和完整性。
    ./Ascend-mindxsdk-mxindex_{version}_linux-{arch}.run --check

    若显示如下信息，说明软件包已通过校验。

    Verifying archive integrity...  100%   SHA256 checksums are OK. All good.
  5. 创建软件包的安装路径。
    • 若用户未指定安装路径，软件会默认安装到软件包所在的路径。
    • 若用户想指定安装路径，需要先创建安装路径。以安装路径“/home/work/FeatureRetrieval”为例：
      mkdir -p /home/work/FeatureRetrieval
  6. 获取安装命令。请在下方根据实际情况单击对应选项，获取Index SDK的安装命令。
    表1 快速安装详细信息

    产品系列

    产品型号

    CPU架构

    是否指定安装路径

    安装命令

    Atlas 200/300/500 推理产品

    Atlas 300I 推理卡（型号 3000）

    aarch64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --install-path=/home/work/FeatureRetrieval --platform=310

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --platform=310

    # 安装路径默认为命令执行所在目录。

    x86_64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --install-path=/home/work/FeatureRetrieval --platform=310

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --platform=310

    # 安装路径默认为命令执行所在目录。

    Atlas 300I 推理卡（型号 3010）

    aarch64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --install-path=/home/work/FeatureRetrieval --platform=310

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --platform=310

    # 安装路径默认为命令执行所在目录。

    x86_64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --install-path=/home/work/FeatureRetrieval --platform=310

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --platform=310

    # 安装路径默认为命令执行所在目录。

    Atlas 推理系列产品

    Atlas 300I Pro 推理卡

    x86_64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    aarch64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    Atlas 300V 视频解析卡

    x86_64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    aarch64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    Atlas 300V Pro 视频解析卡

    x86_64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    aarch64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    Atlas 300I Duo 推理卡

    x86_64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    aarch64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    Atlas 200I SoC A1 核心板

    x86_64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    aarch64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --install-path=/home/work/FeatureRetrieval --platform=310P

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --platform=310P

    # 安装路径默认为命令执行所在目录。

    Atlas 800I A2推理产品

    Atlas 800I A2 推理服务器

    x86_64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --install-path=/home/work/FeatureRetrieval --platform=npu_type

    # 该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换；npu_type表示芯片名称，可在安装昇腾AI处理器的服务器执行npu-smi info命令进行查询，将查询到的“Name”最后一位数字删除，即是npu_type的取值。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-x86_64.run --install --platform=npu_type

    # 安装路径默认为命令执行所在目录；npu_type表示芯片名称，可在安装昇腾AI处理器的服务器执行npu-smi info命令进行查询，将查询到的“Name”最后一位数字删除，即是npu_type的取值。

    aarch64

    是

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --install-path=/home/work/FeatureRetrieval --platform=npu_type

    #该命令以安装路径“/home/work/FeatureRetrieval”为例，请根据实际情况进行替换；npu_type表示芯片名称，可在安装昇腾AI处理器的服务器执行npu-smi info命令进行查询，将查询到的“Name”最后一位数字删除，即是npu_type的取值。

    否

    		 
    ./Ascend-mindxsdk-mxindex_6.0.RC3_linux-aarch64.run --install --platform=npu_type

    #安装路径默认为命令执行所在目录；npu_type表示芯片名称，可在安装昇腾AI处理器的服务器执行npu-smi info命令进行查询，将查询到的“Name”最后一位数字删除，即是npu_type的取值。
  7. 执行安装命令，安装软件包。用户需确保整个安装过程由同一用户执行，安装路径和解压路径仅允许该用户访问。

    --install安装命令同时支持输入可选参数，如表2所示。输入不在列表中的参数可能正常安装或者报错。

  8. 安装过程中提示Do you accept the EULA to install mxIndex?时，输入Y或y，表示同意EULA协议，继续进行安装；输入其他字符时停止安装，退出程序。
    安装完成后会生成目录“mxIndex-{version}”，若显示如下信息，则表示软件成功安装。
    Uncompressing ASCEND MXINDEX RUN PACKAGE  100%
  9. 添加Index软件包路径的环境变量。以Index SDK的安装路径“/home/work/FeatureRetrieval”为例：
    export LD_LIBRARY_PATH=/home/work/FeatureRetrieval/mxIndex/host/lib/:$LD_LIBRARY_PATH

相关参考

表2 --install安装命令可选参数表

输入参数

含义

--help | -h

查询帮助信息。

--check

查询包完整性。

--install

特征检索软件包安装操作命令。

--install-path=<path>

（可选）自定义特征检索软件包安装根目录。如未设置，默认为当前命令执行所在目录。

--version

查询安装包Index SDK版本。

--upgrade

特征检索软件包升级操作命令，将特征检索升级到安装包所包含的Index SDK版本。

--platform

对应昇腾AI处理器类型。

  • 使用Atlas 200/300/500 推理产品请输入“310”。
  • 使用Atlas 推理系列产品，请输入“310P”。
  • 使用Atlas 800I A2推理产品，请在安装昇腾AI处理器的服务器执行npu-smi info命令进行查询，将查询到的“Name”最后一位数字删掉，即是--platform的取值。

--quiet

静默安装，使用该参数，默认同意华为企业业务最终用户许可协议（EULA），跳过协议签署过程，并减少人机交互的信息的打印。
父主题： 安装部署