安装Vision SDK

安装须知

安装和运行Vision SDK的用户，需要满足：
- 通过普通用户进行安装、运行。
- 安装和运行Vision SDK的用户需为同一用户。
- 安装Vision SDK和toolkit/nnae的用户需为同一用户。
软件包的安装升级卸载等管理面的相关日志会保存至“~/log/mindxsdk/deployment.log”，文件中保存有登录用户的用户名、访问端地址以及hostname，用于支持后续的日志跟踪及审计的操作。
安装Vision SDK会将算子拷贝到CANN的安装路径下，因此安装Vision SDK后，如果卸载重新安装CANN，会造成找不到算子，此时需要重新安装Vision SDK。
如需升级或卸载Vision SDK，请参见升级、卸载。

安装准备

已完成安装依赖章节的环境部署。
已通过获取Vision SDK软件包获取配套版本的Vision SDK软件包。
确保安装环境中已执行CANN环境变量配置脚本，使环境变量生效。具体执行路径，请按照实际安装为准。
```
# 安装toolkit/nnae包
. $HOME/Ascend/ascend-toolkit/set_env.sh
或
. $HOME/Ascend/nnae/set_env.sh
```

安装步骤

以软件包的安装用户登录安装环境。
将Vision SDK软件包上传到安装环境的任意路径下并进入软件包所在路径。

增加对软件包的可执行权限。

chmod u+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.    
```
创建Vision SDK软件包的安装路径。不建议在“/tmp”路径下安装Vision SDK。
- 若用户想指定安装路径，需要先创建安装路径。以安装路径“/home/work/MindX_SDK”为例：
```
mkdir -p /home/work/MindX_SDK
```
- 若用户未指定安装路径，软件会默认安装到Vision SDK软件包所在的路径。
进入软件包的上传路径，参考以下命令安装Vision SDK（安装路径中不能包含空格）。安装Vision SDK时会弹出确认是否接受EULA协议的说明，若需要在安装时直接跳过该步骤，可在安装命令前增加echo y |，表示同意华为企业业务最终用户许可协议（EULA）。
- 若用户指定了安装路径。以安装路径“/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
```
--install安装命令同时支持输入可选参数，如表1所示。
可选：安装过程中提示“Do you accept the EULA to install mxVision?”时，输入Y或y，表示同意EULA协议，继续进行安装；输入其他字符时停止安装，退出程序。
安装完成后，若未出现错误信息，表示软件成功安装于指定或默认路径下。
```
Successfully installed mindx-xxx
```
具体安装命令的接口参数介绍，请见表1。
环境变量生效。
进入Vision SDK的安装路径，运行以下命令，使Vision SDK的环境变量生效（如使用openEuler操作系统时，出现yum、cmake不可用等情况，请参见openEuler操作系统系统命令yum、cmake不可用处理）。
```
source set_env.sh
```
Vision SDK安装完成后，可参考快速入门，验证Vision SDK安装结果，初步了解Vision SDK应用开发。

部分接口通过AscendC算子实现，安装部署后在安装路径下会生成AscendC算子相关文件。
若安装时，出现libpython3.9.so.1.0报错，请参见使用Vision SDK安装时，出现libpython3.9.so.1.0报错解决。
若安装时，出现CMake报错显示算子编译失败，请参见使用Vision SDK安装时，显示算子编译失败，并有算子编译中间文件残留解决。
若在Atlas 500 A2 智能小站默认配置下，无法安装Vision SDK，请参见在Atlas 500 A2 智能小站默认配置下，无法安装Vision SDK解决。

相关参考

表1 接口参数表
输入参数	含义
--help \| -h	查询帮助信息。
--info	查询包构建信息。
--list	查询文件列表。
--check	查询包完整性。
--quiet	启用静默模式，并默认接受华为企业业务最终用户许可协议（EULA），需要和--install或--upgrade参数配合使用。
--noexec	不执行内部脚本，一般配合“--install” “--install-path”选项使用。
--install	执行安装。当前路径不能存在非法字符，仅支持大小写字母、数字、-_./特殊字符。
--install-path=<path>	（可选）自定义软件包安装根目录。如未设置，默认为当前命令执行所在目录。建议用户使用绝对路径安装开发套件，在指定安装路径时请避免使用相对路径。与“--version”输入参数有冲突，不建议在“/tmp”路径下安装Vision SDK。需要和--install或--upgrade参数配合使用。传入参数路径不能存在非法字符，仅支持大小写字母、数字、-_./特殊字符。
--uninstall	卸载，仅对run包同目录下的安装包有效。具体使用操作请参见卸载。当前路径不能存在非法字符，仅支持大小写字母、数字、-_./特殊字符。
--cann-path	CANN自定义安装的路径，如CANN安装路径为用户自定义，请通过该参数导入。比如“/home/xxx/Ascend”。
--upgrade	升级Vision SDK。具体使用操作请参见升级。执行此操作时，会在“/tmp”下临时安装Vision SDK的run包，如已存在则会将其卸载，不建议在“/tmp”下安装Vision SDK。
--version	查询Vision SDK的版本。执行此操作时，会在“/tmp”下临时安装Vision SDK的run包，查询完版本号后再卸载。
--choose-gcc=<0,1>	根据gcc的版本选择对应的run包进行安装。需要和--install或--upgrade参数配合使用。 “0”：安装gcc 7的编译器版本，默认值。 “1”：安装gcc 4.8.5的编译器版本。
--nox11	不生成虚拟终端。需要和--install或--upgrade参数配合使用。

父主题： 安装部署