安装MindIE

安装前必读

执行安装前请确保安装环境满足硬件环境，支持的操作系统要求，并已参照安装驱动和固件和安装开发环境章节完成开发环境的安装。执行MindIE软件包的安装，会依次安装MindIE RT、MindIE Torch、MindIE Service、MindIE LLM和MindIE SD各组件，组件包的路径在MindIE的子路径下。

安装步骤

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

   cd /home/package

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

   chmod +x 软件包名.run

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

5. 执行以下命令添加ascend-toolkit包的环境变量。（以root用户为例，以下为root用户的默认安装路径。）

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

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

   ./软件包名.run --check

7. 执行以下命令安装软件（以下命令支持--install-path=<path>等参数，具体参数说明请参见软件包参数说明）。

   ./软件包名.run --install --quiet

   

   • 如果以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版本的安装包。

     从GCC 5.1版本开始，libstdc++为了更好的实现C++11规范，更改了std::string和std::list的一些接口，导致新老版本ABI不兼容。在C++代码编译时使用-D_GLIBCXX_USE_CXX11_ABI宏选择新老版本。

     • 当安装abi1版本时，使用新的ABI规范；
     • 当安装abi0版本时，使用老的ABI规范。

     用户可根据实际工程的ABI版本，选择合适ABI的MindIE安装包。

   • MindIE默认安装torch2.1.0版本的CPP与Python的API，如需获取其他版本torch版本的安装包，请参见如何获取MindIE Torch其它torch版本安装包。

   执行以上命令默认同意华为企业业务最终用户许可协议（EULA）的条款和条件。

   安装完成后，若显示如下信息，则说明软件安装成功：

   xxx install success

   xxx表示安装的实际软件包名。

配置环境变量

当前提供进程级环境变量设置脚本，供用户在进程中引用，以自动完成环境变量设置。用户进程结束后自动失效。示例如下：

root用户默认安装路径下配置环境变量：

source /usr/local/Ascend/mindie/set_env.sh

非root用户默认安装路径下配置环境变量：

source /home/{当前用户名}/Ascend/mindie/set_env.sh