安装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解决。