使用deployer快速安装软件包

场景介绍

Ascend Deployer工具提供OS依赖和docker的自动下载以及一键式安装的功能，并支持驱动、固件、CANN、MindStudio、MindX DL、MEF Center软件包等软件包在线下载与安装；支持驱动固件、CANN、ToolBox和MindX DL组件的升级。

本章节内容旨在指导用户快速上手整个安装过程，Ascend Deployer的详细操作流程可参考使用Deployer批量安装软件包。

安装前须知

参考本章节内容进行安装，有以下约束：

不修改默认配置。
仅适用于单机安装。
使用root用户作为安装用户。
在线下载的软件包为昇腾社区版本的软件包，如需获取商用版本请在下载时仅选择下载OS依赖包，对应软件包请参考准备软件包自行上传。
下载软件包和依赖所需空间较多，请确保下载目录的可用空间至少为20G，下载过程中如遇空间不足的报错信息，请根据实际情况配置可用空间。

快速安装

根据待安装设备（Linux系统）是否能够连接网络，可分为以下两种场景：

场景一：待安装设备可以连接网络，直接在待安装设备上执行下载、安装操作。
场景二：待安装设备无法连接网络，需在Windows系统上执行下载操作后，再将Ascend Deployer整个目录上传到待安装设备上进行安装。

场景一

请确保待安装设备能够连接网络。

以root用户登录待安装设备。
单击Ascend Deployer工具获取Ascend Deployer工具的zip包（建议下载6.0.RC2版本最新发布的工具包），并上传至待安装设备（Linux系统）上解压使用
（可选）安装指定版本的esdk-obs-python软件包，启用CANN包的断点续传功能，防止出现因软件包较大、网络原因导致下载失败或者重新下载耗时较久的情况（使用前确保环境上存在pip3命令）。
```
pip3 install esdk-obs-python==3.23.12
```
需进入ascend_deployer目录，执行下载命令。
```
bash start_download.sh --os-list=<OS1>,<OS2> --download=<PK1>,<PK2>==<Version>
```
<OS1>，<OS2>和<PK1>，<PK2>==<Version>可选范围可通过执行bash start_download.sh --help查看。若不指定软件包版本，则会下载最新可选版本的软件包。下载命令示例如下：
```
bash start_download.sh --os-list=Ubuntu_18.04_x86_64 --download=NPU,CANN,Torch-npu,DL
```
- --os-list参数用于指定待安装设备的OS，为必选参数，--download参数用户指定下载的软件包，为可选参数，下载软件包即表示您同意华为企业业务最终用户许可协议（EULA）的条款和条件。
- 当“ --download=NPU”时，会自动下载驱动和固件包，存放于ascend-deployer/ascend_deployer/resources/npu目录下。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 指定--download=CANN，会自动下载可选范围内最新版本的toolkit、nnrt、nnae、kernels、tfplugin以及toolbox软件包。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 指定--download=DL，会自动下载可选范围内最新版本的DL相关软件包。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。支持安装DL的OS清单具体请参见支持OS清单和安装场景。
- 当“ --download=Torch-npu”时，会自动下载可选范围内最新版本官方torch包、torch_npu并存放于ascend-deployer/ascend_deployer/resources/pylibs目录下。APEX软件包请参考Gitee链接自行编译，并放置在同一目录下。MindSpore、TensorFlow和Torch-npu仅支持指定其中一个AI框架下载和安装，当前以PyTorch为例。
执行安装命令。
```
bash install.sh --install-scene=auto      //安装驱动固件、CANN,AI框架等
```
Ascend Deployer工具提供几个基本安装场景，具体可参考可选安装场景。

执行安装命令时，会自动创建HwHiAiUser用户。可以执行passwd HwHiAiUser命令设置用户密码。请确认HwHiAiUser账号符合安全规范，如密码复杂度等。密码有效期为90天，您可以通过chage命令来设置用户的有效期，详情请参见设置用户有效期。
涉及安装CANN和ToolBox时，用户需签署华为企业业务最终用户许可协议（EULA）后进入安装流程，根据回显页面执行y或Y确认协议，输入其他任意字符为拒绝协议，确认接受协议后自动开始安装。
若当前语言环境不满足要求，可以执行如下命令配置系统的默认语言环境。
```
#配置为中文（简体）
export LANG=zh_CN.UTF-8
#配置为英文
export LANG=en_US.UTF-8
```
涉及安装驱动固件时，建议安装完成后立即重启系统，请执行reboot命令重启。
安装后配置，具体可参考安装后配置。

场景二

请确保执行下载操作的Windows系统能够连接网络。

在Windows系统上安装Python3.7。如果已安装3.7版本及以上的Python，请忽略。
下载链接：Python3.7.5

请根据界面提示完成安装。注意安装时在“Advanced Options”界面勾选“Add Python to environment variables”，否则需手动添加环境变量。
（可选）在Windows系统上使用cmd安装指定版本的esdk-obs-python软件包，启用CANN包的断点续传功能，防止出现因软件包较大、网络原因导致下载失败或者重新下载耗时较久的情况。
```
pip3 install esdk-obs-python==3.23.12
```
在Windows系统上获取Ascend Deployer工具。
获取链接：Ascend Deployer工具（建议下载最新发布6.0.RC2版本的工具包）

下载后解压使用。
进入解压后的ascend-deployer-{version}目录下的ascend_deployer文件下，运行start_download_ui.bat。在弹出的简易UI界面上勾选待安装设备的OS和需要在线下载的软件包，单击“开始下载”。
例如在“OS_LIST”列勾选Ubuntu_18.04_x86_64，在“PKG_LIST”列选择NPU、CANN、Torch-npu、DL版本。
- 在“PKG_LIST”列选择软件包并下载即表示您同意华为企业业务最终用户许可协议（EULA）的条款和条件。
- 在“PKG_LIST”列选择NPU的版本，会自动下载配套版本的驱动和固件包，若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 在“PKG_LIST”列选择CANN的版本，会自动下载配套版本的toolkit、nnrt、nnae、kernels、tfplugin以及toolbox软件包，若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 在“PKG_LIST”列选择Torch-npu的版本，会自动下载官方torch包、torch_npu。APEX软件包请参考Gitee链接自行编译，并放置在同一目录下。MindSpore、TensorFlow和Torch-npu仅支持指定其中一个AI框架下载和安装，当前以PyTorch为例。
- 在“PKG_LIST”列选择DL的版本，会自动下载MindX DL相关软件包。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。支持安装DL的OS清单具体请参见支持OS清单和安装场景。
以root用户登录待安装设备，将Windows系统上执行完下载操作后的ascend-deployer整个目录上传到待安装设备的任意目录下（如“~”）。
进入解压后的ascend-deployer-{version}目录下的ascend_deployer文件，执行安装脚本。
```
bash install.sh --install-scene=auto      //安装驱动固件，CANN，AI框架等
```
Ascend Deployer工具提供几个基本安装场景，具体可参考可选安装场景。

执行安装命令时，会自动创建HwHiAiUser用户，可执行passwd HwHiAiUser命令设置用户密码。请确认HwHiAiUser账号符合安全规范，如密码复杂度等。密码有效期为90天，您可以通过chage命令来设置用户的有效期，详情请参见设置用户有效期。
涉及安装CANN和ToolBox时，用户需签署华为企业业务最终用户许可协议（EULA）后进入安装流程，根据回显页面执行y或Y确认协议，输入其他任意字符为拒绝协议，确认接受协议后自动开始安装。
若当前语言环境不满足要求，可以执行如下命令配置系统的默认语言环境。
```
#配置为中文（简体）
export LANG=zh_CN.UTF-8
#配置为英文
export LANG=en_US.UTF-8
```
涉及安装驱动固件时，建议安装完成后立即重启系统，请执行reboot命令重启。
安装后配置，具体可参考安装后配置。

父主题： 快速入门