安装前必读
执行安装前请确保安装环境满足硬件环境,软件环境要求,并参照环境准备章节安装所有需要的依赖组件。执行MindIE软件包的安装,会依次安装MindIE-ATB、MindIE-RT、MindIE-Service和MindIE-Torch各组件,组件包的路径在MindIE的子路径下。
MindIE会联网安装依赖的Python第三方库,依赖的第三方库列表请见软件环境。请用户自行配置pip镜像源确保联网安装Python第三方库成功。
安装步骤
- 以CANN软件包的安装用户登录安装环境。
- 将获取到的MindIE软件包上传到安装环境任意路径(如/home/package)。
- 进入软件包所在路径。
cd /home/package
- 增加对软件包的可执行权限。
chmod +x 软件包名.run
软件包名.run表示开发套件包Ascend-mindie-{version}_linux-{arch}.run,请根据实际包名进行替换。
- 执行以下命令添加ascend-toolkit包的环境变量。
source /usr/local/Ascend/ascend-toolkit/set_env.sh
- 执行以下命令校验软件包安装文件的一致性和完整性。
./软件包名.run --check
- 执行以下命令安装软件(以下命令支持--install-path=<path>等参数,具体参数说明请参见软件包参数说明)。
./软件包名.run --install
- 如果以root用户安装,请勿安装在非root用户目录下。
- 如果用户未指定安装路径,则软件会安装到默认路径下,默认安装路径如下。
- root用户:“/usr/local/Ascend”
- 非root用户:“/home/{当前用户名}/Ascend”
- 软件包安装详细日志路径如下。
- root用户:“/var/log/mindie_log/mindie_install.log”
- 非root用户:“/home/{当前用户名}/var/log/mindie_log/mindie_install.log”
- 安装过程中会在当前目录临时生成aie_tmp_source文件夹,安装完成后会删除,如果当前有同名文件夹会在安装后被删除。
- MindIE默认安装abi0版本的安装包,如需获取abi1版本的安装包,请参见如何获取abi1版本的安装包。
- MindIE默认安装torch2.1.0版本的CPP与Python的API,如需获取其他版本torch版本的安装包,请参见如何获取MindIE-Torch其它torch版本安装包。
安装完成后,若显示如下信息,则说明软件安装成功:
xxx install success
xxx表示安装的实际软件包名。
安装后子包结构
安装完成后,您将在MindIE安装目录看到以下子目录:
配置环境变量
当前提供进程级环境变量设置脚本,供用户在进程中引用,以自动完成环境变量设置。用户进程结束后自动失效。示例如下:
root用户默认安装路径下配置环境变量:
source /usr/local/Ascend/mindie/set_env.sh
非root用户默认安装路径下配置环境变量:
source /home/{当前用户名}/Ascend/mindie/set_env.sh
用户也可以通过修改~/.bashrc文件方式设置永久环境变量,操作如下:
- 以运行用户在任意目录下执行vi ~/.bashrc命令,打开.bashrc文件,在文件最后一行后面添加上述内容。
- 执行:wq!命令保存文件并退出。
- 执行source ~/.bashrc命令使其立即生效。
对于MindIE-Service的环境变量以及配置准备,请先确保已设置了atb-models软件包里的环境变量,详情请参见配置MindIE-Server。