下载
中文
注册

安装mxVision

安装准备

  • 请参见环境部署,完成环境部署。
  • 已通过获取mxVision软件包获取配套版本的mxVision软件包。
  • 确保安装环境中已执行CANN环境变量配置脚本,使环境变量生效。
    # 安装toolkit包
    . $HOME/Ascend/ascend-toolkit/set_env.sh

    具体执行路径,请按照实际安装为准。

  • 通过普通用户进行安装、运行。
  • mxVision和toolkit的安装用户需为同一用户。
  • mxVision软件包的安装用户和运行用户需为同一用户。
  • 软件包的安装升级卸载等管理面的相关日志会保存至“~/log/mindxsdk/deployment.log”,文件中保存有登录用户的用户名、访问端地址以及hostname,用于支持后续的日志跟踪及审计的操作。
  • 如需升级或卸载mxVision,请参见升级前必读卸载

注意事项

安装mxVision会将算子拷贝到CANN的安装路径下,因此安装mxVision后,如果卸载安装或升级CANN,会造成找不到算子,此时需要重新安装mxVision。

安装步骤

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

    如果系统没有shasum或者sha256sum工具则会校验失败。

    若显示如下信息,说明软件包满足一致性和完整性。

    Verifying archive integrity...  100%   SHA256 checksums are OK. All good.    
  5. 创建mxVision软件包的安装路径。
    • 若用户想指定安装路径,需要先创建安装路径。以安装路径“/home/work/MindX_SDK”为例:
      mkdir -p /home/work/MindX_SDK
    • 若用户未指定安装路径,软件会默认安装到mxVision软件包所在的路径。
  6. 进入软件包的上传路径,参考以下命令安装mxVision(安装路径中不能包含空格)。安装mxVision时会弹出确认是否接受EULA协议的说明,若需要在安装时直接跳过该步骤,可在安装命令前增加echo y |
    • 若用户指定了安装路径。以安装路径“/home/work/MindX_SDK”为例:
      ./Ascend-mindxsdk-mxvision_{version}_linux-{arch}.run --install --install-path=/home/work/MindX_SDK

      或者

      echo y | ./Ascend-mindxsdk-mxvision_{version}_linux-{arch}.run --install --install-path=/home/work/MindX_SDK
    • 若用户未指定安装路径,将安装在当前路径。
      ./Ascend-mindxsdk-mxvision_{version}_linux-{arch}.run --install

      或者

      echo y | ./Ascend-mindxsdk-mxvision_{version}_linux-{arch}.run --install
  7. 可选:安装过程中提示“Do you accept the EULA to install mxVision?”时,输入Y或y,表示同意EULA协议,继续进行安装;输入其他字符时停止安装,退出程序。
  8. 安装完成后,若未出现错误信息,表示软件成功安装于指定或默认路径下。
    Successfully installed mindx-xxx

    若安装时,出现libpython3.9.so.1.0报错,请参见使用mxVision安装时,出现libpython3.9.so.1.0报错解决。

    具体安装命令的接口参数介绍,请见表1

    表1 接口参数表

    输入参数

    含义

    --help | -h

    查询帮助信息。

    --info

    查询包构建信息。

    --list

    查询文件列表。

    --check

    查询包完整性。

    --quiet

    启用静默模式,并默认接受华为企业业务最终用户许可协议(EULA),需要和--install或--upgrade参数配合使用。

    --noexec

    不执行内部脚本,一般配合“--install” “--install-path”选项使用。

    --install

    执行安装。当前路径不能存在非法字符,仅支持大小写字母、数字、-_./特殊字符。

    --install-path=<path>

    (可选)自定义软件包安装根目录。如未设置,默认为当前命令执行所在目录。

    • 建议用户使用绝对路径安装开发套件,在指定安装路径时请避免使用相对路径。
    • “--version”输入参数有冲突,不建议在“/tmp”路径下安装mxVision。
    • 需要和--install或--upgrade参数配合使用。
    • 传入参数路径不能存在非法字符,仅支持大小写字母、数字、-_./特殊字符。

    --uninstall

    卸载,仅对run包同目录下的安装包有效。具体使用操作请参见卸载。当前路径不能存在非法字符,仅支持大小写字母、数字、-_./特殊字符。

    --cann-path

    CANN自定义安装的路径,如CANN安装路径为用户自定义,请通过该参数导入。比如“/home/xxx/Ascend”

    --upgrade

    升级mxVision。具体使用操作请参见升级前必读

    执行此操作时,会在“/tmp”下临时安装mxVision的run包,如已存在则会将其卸载,不建议在“/tmp”下安装mxVision。

    --version

    查询mxVision的版本。

    执行此操作时,会在“/tmp”下临时安装mxVision的run包,查询完版本号后再卸载。

    --choose-gcc=<0,1>

    根据gcc的版本选择对应的run包进行安装。

    • “0”:安装gcc 7的编译器版本,默认值。
    • “1”:安装gcc 4.8.5的编译器版本。

    --nox11

    不生成虚拟终端。

  9. 环境变量生效。

    进入mxVision的安装路径,运行以下命令,使mxVision的环境变量生效(如使用openEuler操作系统时,出现yum、cmake不可用等情况,请参见openEuler操作系统系统命令yum、cmake不可用处理)。

    source set_env.sh

安装验证

mxVision安装完成后,可参考快速入门,验证mxVision安装结果,初步了解mxVision应用开发。

若在Atlas 500 A2 智能小站默认配置下,无法安装mxVision,请参见在Atlas 500 A2 智能小站默认配置下,无法安装mxVision解决。