安装mxVision
安装准备
- 请参见环境部署,完成环境部署。
- 已通过获取mxVision软件包获取配套版本的mxVision软件包。
- 确保安装环境中已执行CANN环境变量配置脚本,使环境变量生效。
# 以root用户安装toolkit包 . /usr/local/Ascend/ascend-toolkit/set_env.sh # 以非root用户安装toolkit包 . $HOME/Ascend/ascend-toolkit/set_env.sh
具体执行路径,请按照实际安装为准。
- 建议用户通过普通用户进行安装、运行。
- mxVision软件包的安装用户和运行用户需为同一用户。若强制运行非同一用户安装的mxVision软件包,可修改mxVision安装目录的权限为对应的用户属组。
- 软件包的安装升级卸载等管理面的相关日志会保存至“~/log/mindxsdk/deployment.log”文件中保存有登录用户的用户名、访问端地址以及hostname,用于支持后续的日志跟踪及审计的操作。
- 如需升级或卸载mxVision,请参见升级前必读、卸载。
注意事项
安装mxVision会将算子拷贝到CANN的安装路径下,因此安装mxVision后,如果卸载安装或升级CANN,会造成找不到算子,此时需要重新安装mxVision。
安装步骤
- 以软件包的安装用户登录安装环境。
- 将mxVision软件包上传到安装环境的任意路径下并进入软件包所在路径。
- 增加对软件包的可执行权限。
chmod +x Ascend-mindxsdk-mxvision_{version}_linux-{arch}.run
- 执行如下命令,校验软件包的一致性和完整性。
./Ascend-mindxsdk-mxvision_{version}_linux-{arch}.run --check
如果系统没有shasum或者sha256sum工具则会校验失败。
若显示如下信息,说明软件包满足一致性和完整性。
Verifying archive integrity... 100% SHA256 checksums are OK. All good.
- 创建mxVision软件包的安装路径。
- 若用户想指定安装路径,需要先创建安装路径。以安装路径“/home/work/MindX_SDK”为例:
mkdir -p /home/work/MindX_SDK
- 若用户未指定安装路径,软件会默认安装到mxVision软件包所在的路径。
- 若用户想指定安装路径,需要先创建安装路径。以安装路径“/home/work/MindX_SDK”为例:
- 进入软件包的上传路径,参考以下命令安装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
- 若用户指定了安装路径。以安装路径“/home/work/MindX_SDK”为例:
- 可选:安装过程中提示“Do you accept the EULA to install mxVision?”时,输入Y或y,表示同意EULA协议,继续进行安装;输入其他字符时停止安装,退出程序。
- 安装完成后,若未出现错误信息,表示软件成功安装于指定或默认路径下。
若安装时,出现libpython3.9.so.1.0报错,请参见使用mxVersion安装时,出现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”,该参数仅对root用户有效。
--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
不生成虚拟终端。
- 环境变量生效。
进入mxvision的安装路径,运行以下命令,使mxVision的环境变量生效(如使用openEuler操作系统时,出现yum、cmake不可用等情况,请参见openEuler操作系统系统命令yum、cmake不可用处理)。
source set_env.sh
安装验证
mxVision安装完成后,验证mxVision安装结果,初步了解mxVision应用开发。
若在Atlas 500 A2 智能小站默认配置下,无法安装mxVision,请参见在Atlas 500 A2 智能小站默认配置下,无法安装mxVision解决。