安装MindIE

安装前必读

执行安装前请确保安装环境满足硬件环境软件环境要求,并参照环境准备章节安装所有需要的依赖组件。执行MindIE软件包的安装,会依次安装MindIE-ATB、MindIE-RT、MindIE-Service和MindIE-Torch各组件,组件包的路径在MindIE的子路径下。

MindIE会联网安装依赖的Python第三方库,依赖的第三方库列表请见软件环境。请用户自行配置pip镜像源确保联网安装Python第三方库成功

安装步骤

  1. 以CANN软件包的安装用户登录安装环境。
  2. 将获取到的MindIE软件包上传到安装环境任意路径(如/home/package)。
  3. 进入软件包所在路径。

    cd /home/package

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

    chmod +x 软件包名.run

    软件包名.run表示开发套件包Ascend-mindie-{version}_linux-{arch}.run,请根据实际包名进行替换。

  5. 执行以下命令添加ascend-toolkit包的环境变量。

    source /usr/local/Ascend/ascend-toolkit/set_env.sh

  6. 执行以下命令校验软件包安装文件的一致性和完整性。

    ./软件包名.run --check

  7. 执行以下命令安装软件(以下命令支持--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文件方式设置永久环境变量,操作如下:
  1. 以运行用户在任意目录下执行vi ~/.bashrc命令,打开.bashrc文件,在文件最后一行后面添加上述内容。
  2. 执行:wq!命令保存文件并退出。
  3. 执行source ~/.bashrc命令使其立即生效。

对于MindIE-Service的环境变量以及配置准备,请先确保已设置了atb-models软件包里的环境变量,详情请参见配置MindIE-Server