快速安装指导

本章节内容旨在指导用户快速上手整个安装过程，ascend-deployer的详细操作流程可参考安装过程。

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

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

不修改默认配置。
仅适用于单机安装。
使用root用户作为安装用户。
在线下载的软件包为昇腾社区版本的软件包，如需获取商用版本请在下载时仅选择下载OS依赖包，对应软件包请参考准备软件包自行上传。

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

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

场景一

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

以root用户登录待安装设备。
单击ascend-deployer工具获取ascend-deployer工具的zip包（建议下载5.0.RC3版本最新发布的工具包），并上传至待安装设备（Linux系统）上解压使用
（可选）安装esdk-obs-python软件包，启用CANN包的断点续传功能，防止出现因软件包较大、网络原因导致下载失败或者重新下载耗时较久的情况（使用前确保环境上存在pip3命令）。
```
pip3 install esdk-obs-python==3.22.2
```
需进入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,MindSpore,MindStudio,TensorFlow,Torch-npu,DL,MEF
```
- --os-list参数用于指定待安装设备的OS，为必选参数，--download参数用户指定下载的软件包，为可选参数，下载软件包即表示您同意华为企业业务最终用户许可协议（EULA）的条款和条件。
- 当“ --download=NPU”时，会自动下载驱动和固件包，存放于ascend-deployer/ascend_deployer/resources/npu目录下。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 指定--download=CANN，会自动下载可选范围内最新版本的toolkit、nnrt、nnae、kernels、tfplugin以及toolbox软件包。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 指定--download=MindSpore，会自动下载可选范围内最新版本的MindSpore软件包。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 指定--download=MindStudio，会自动下载可选范围内最新版本的MindStudio软件包。目前使用ascend-deployer工具下载安装MindStudio，仅支持Ubuntu_18.04_x86_64、 Ubuntu_18.04_aarch64、Ubuntu_22.04_x86_64、Ubuntu_22.04_aarch64、openEuler_22.03LTS_x86_64、openEuler_22.03LTS_aarch64、EulerOS_2.8_aarch64系统。
- 指定--download=DL，会自动下载可选范围内最新版本的DL相关软件包。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。仅支持Ubuntu_18.04_x86_64、Ubuntu_18.04_aarch64、Ubuntu_20.04_x86_64、Ubuntu_20.04_aarch64、Ubuntu_22.04_x86_64、Ubuntu_22.04_aarch64、openEuler_20.03LTS_x86_64、openEuler_20.03LTS_aarch64、openEuler_22.03LTS_x86_64、openEuler_22.03LTS_aarch64、CentOS_7.6_x86_64、CentOS_7.6_aarch64系统。
- 指定--download=MEF，会自动下载可选范围内最新版本的MEF Center相关软件包。仅支持Ubuntu_20.04_x86_64、Ubuntu_20.04_aarch64、openEuler_22.03LTS_x86_64、openEuler_22.03LTS_aarch64系统。
- 由于ascend-deployer工具不能自动下载x86_64架构的Atlas A2 训练系列产品驱动固件包，如果用户想在该场景下部署环境，请参考准备软件包的方式二，将对应的驱动固件包上传至ascend-deployer工具文件下的resources目录。
- 当“ --download=TensorFlow”时，会自动下载可选范围内最新版本的TensorFlow软件包。
- 当“ --download=Torch-npu”时，会自动下载可选范围内最新版本官方torch包、torch_npu并存放于ascend-deployer/ascend_deployer/resources/pylibs目录下。APEX软件包请参考Gitee链接自行编译，并放置在同一目录下。
若UID和GID为1000没有被占用，执行安装命令时，会自动创建HwHiAiUser用户。若已被占用，请手动执行以下命令创建驱动的运行用户HwHiAiUser。
```
groupadd HwHiAiUser
useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash
```
创建完用户后，执行passwd HwHiAiUser命令设置用户密码。请确认HwHiAiUser账号符合安全规范，如密码复杂度等。密码有效期为90天，您可以通过chage命令来设置用户的有效期，详情请参见设置用户有效期。

执行安装命令。

bash install.sh --install-scene=auto      //安装驱动固件、CANN,MindSpore,MindStudio,Torch-npu等
bash install.sh --install-scene=dl        //安装驱动固件、DL相关组件等
bash install.sh --install-scene=mef      //MEF Center相关组件

ascend-deployer工具提供几个基本安装场景，具体可参考可选安装场景。

安装场景涉及安装CANN和ToolBox时，用户需签署华为企业业务最终用户许可协议（EULA）后进入安装流程，根据回显页面执行y或Y确认协议，输入其他任意字符为拒绝协议，确认接受协议后自动开始安装。
若当前语言环境不满足要求，可以执行如下命令配置系统的默认语言环境。
```
#配置为中文（简体）
export LANG=zh_CN.UTF-8
#配置为英文
export LANG=en_US.UTF-8
```
安装后配置，具体可参考安装后操作。

场景二

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

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

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

下载后解压使用。
启动下载。
进入解压后的ascend-deployer-{version}目录（以下简称为ascend-deployer目录），运行start_download_ui.bat。在弹出的简易UI界面上勾选待安装设备的OS和需要在线下载的软件包，单击“开始下载”。

例如在“OS_LIST”列勾选Ubuntu_18.04_x86_64，在“PKG_LIST”列选择NPU、CANN、MindSpore、MindStudio、TensorFlow、Torch-npu、DL版本。
- 在“PKG_LIST”列选择软件包并下载即表示您同意华为企业业务最终用户许可协议（EULA）的条款和条件。
- 在“PKG_LIST”列选择NPU的版本，会自动下载配套版本的驱动和固件包，若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 在“PKG_LIST”列选择CANN的版本，会自动下载配套版本的toolkit、nnrt、nnae、kernels、tfplugin以及toolbox软件包，若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 在“PKG_LIST”列选择MindSpore的版本，会自动下载所选版本的MindSpore软件包，若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。
- 在“PKG_LIST”列选择MindStudio的版本，会自动下载所选版本的MindStudio软件包。目前使用ascend-deployer工具下载安装MindStudio，仅支持Ubuntu_18.04_x86_64、 Ubuntu_18.04_aarch64、Ubuntu_22.04_x86_64、Ubuntu_22.04_aarch64、openEuler_22.03LTS_x86_64、openEuler_22.03LTS_aarch64、EulerOS_2.8_aarch64系统。
- 在“PKG_LIST”列选择TensorFlow的版本，会自动下载TensorFlow软件包。
- 在“PKG_LIST”列选择Torch-npu的版本，会自动下载官方torch包、torch_npu。APEX软件包请参考Gitee链接自行编译，并放置在同一目录下。
- 在“PKG_LIST”列选择DL的版本，会自动下载MindX DL相关软件包。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。仅支持Ubuntu_18.04_x86_64、Ubuntu_18.04_aarch64、Ubuntu_20.04_x86_64、Ubuntu_20.04_aarch64、Ubuntu_22.04_x86_64、Ubuntu_22.04_aarch64、openEuler_20.03LTS_x86_64、openEuler_20.03LTS_aarch64、openEuler_22.03LTS_x86_64、openEuler_22.03LTS_aarch64、CentOS_7.6_x86_64、CentOS_7.6_aarch64系统。
- 在“PKG_LIST”列选择MEF的版本，会自动下载MEF Center相关软件包。仅支持Ubuntu_20.04_x86_64、Ubuntu_20.04_aarch64、openEuler_22.03LTS_x86_64、openEuler_22.03LTS_aarch64系统。
- 由于ascend-deployer工具不能自动下载x86_64架构的Atlas A2 训练系列产品驱动固件包，如果用户想在该场景下部署环境，请参考准备软件包的方式二，将对应的驱动固件包上传至ascend-deployer工具文件下的resources目录。
以root用户登录待安装设备，将Windows系统上执行完下载操作后的ascend-deployer整个目录上传到待安装设备的任意目录下（如“~”）。
若uid和gid为1000没有被占用，执行安装命令时，会自动创建HwHiAiUser用户。若已被占用，请手动执行以下命令创建驱动的运行用户HwHiAiUser。
```
groupadd HwHiAiUser
useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash
```
创建完用户后，执行passwd HwHiAiUser命令设置用户密码。请确认HwHiAiUser账号符合安全规范，如密码复杂度等。密码有效期为90天，您可以通过chage命令来设置用户的有效期，详情请参见设置用户有效期。

进入ascend-deployer目录（如“~/ascend-deployer”），执行安装脚本。

bash install.sh --install-scene=auto      //安装驱动固件、CANN,MindSpore,MindStudio,Torch-npu等
bash install.sh --install-scene=dl        //安装驱动固件、DL相关组件等
bash install.sh --install-scene=mef      //MEF Center相关组件

ascend-deployer工具提供几个基本安装场景，具体可参考可选安装场景。

安装场景涉及安装CANN和ToolBox时，用户需签署华为企业业务最终用户许可协议（EULA）后进入安装流程，根据回显页面执行y或Y确认协议，输入其他任意字符为拒绝协议，确认接受协议后自动开始安装。
若当前语言环境不满足要求，可以执行如下命令配置系统的默认语言环境。
```
#配置为中文（简体）
export LANG=zh_CN.UTF-8
#配置为英文
export LANG=en_US.UTF-8
```
安装后配置，具体可参考安装后操作。