ascend-deployer

.. sectnum::

简介

离线安装工具提供系统组件、python第三方依赖自动下载以及一键式安装的功能，并支持驱动、固件、CANN软件包以及MindX DL和MindX Edge MEF Center的安装。

快速指南

本工具主要支持开局场景（环境仅安装了OS），如果遇到问题，请参考\ ascend-deployer用户指南 <https://www.hiascend.com/document/detail/zh/ascend-deployer>__\。

安装内容

工具支持安装的内容参考下图，其中红色部分是昇腾设备上必须安装的，橙色部分和绿色部分是可选安装的，如果需要直接运行AI框架或Toolbox，橙色部分也是必须安装的。

.. image:: ./assets/1.png

使用样例

以下以Ubuntu_18.04_x86_64系统，服务器上插Atlas 300I Pro推理卡为例快速展示工具的使用方式。

1. 以root用户登录待安装设备。

2. 执行 pip3 install ascend-deployer==<version> 安装ascend-deployer工具。为ascend-deployer工具的版本号， 建议参考\ 官网 <https://pypi.org/project/ascend-deployer/#history>__\下载最新发布版本的工具包。如果提示pip3命令不存在，请用户自行安装。

3. 执行下载命令。

   ::

   ascend-download --os-list=Ubuntu_18.04_x86_64 --download=CANN==6.3.RC1,MindSpore==2.0.0rc1

   执行以上命令后，会自动下载好OS所需依赖，CANN软件包和配套的驱动和固件包，以及docker软件等，并存放到$HOME/ascend-deployer/resources目录下。

4. 创建驱动的运行用户HwHiAiUser。

   ::

   groupadd HwHiAiUser useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash

   创建完用户后，执行 passwd HwHiAiUser 命令设置用户密码。

5. 安装驱动和固件时，如果不是归一包（包名以 Ascend-hdk 开头），需在inventory_file中提前配置cus_npu_info变量。

   ::

   [ascend] localhost ansible_connection='local'

6. 执行以下安装命令，自动安装所有能找到的包（MindX DL和MEF Center除外，该两者请参考 \ ascend-deployer用户指南 <https://www.hiascend.com/document/detail/zh/ascend-deployer>__\）。

   ::

   ascend-deployer --install-scene=auto

7. 安装后配置。 使用python和CANN前，需要根据实际情况配置环境变量，以下内容以配置python和nnae的环境变量为例。

   ::

   source /usr/local/ascendrc # 配置python环境变量 source /usr/local/Ascend/nnae/set_env.sh # 配置nnae的环境变量

8. 详细指南请参考\ ascend-deployer用户指南 <https://www.hiascend.com/document/detail/zh/ascend-deployer>__\