# Install_Tool_Atlas **Repository Path**: evan-wt/install_tool_atlas ## Basic Information - **Project Name**: Install_Tool_Atlas - **Description**: 这是一个昇腾环境搭建的一键安装脚本 - **Primary Language**: Shell - **License**: MulanPSL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 7 - **Forks**: 0 - **Created**: 2021-02-02 - **Last Updated**: 2023-01-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Atlas_Istall_Tool.sh 脚本的使用指导 目录 [Atlas_Istall_Tool.sh 脚本的使用指导... 1](#_Toc63254711) [脚本使用前说明：... 2](#_Toc63254712) [一、 Install_Tool_Atlas_V1.1.sh 脚本功能说明：... 3](#_Toc63254713) [二、 Install_Tool_Atlas_V1.1.sh文件夹说明... 4](#_Toc63254714) [1 Install_Tool_Atlas_Vx.x.sh脚本文件... 4](#_Toc63254715) [2 Atlas_Istall_Tool的离线软件包目录... 4](#_Toc63254716) [三、Install_Tool_Atlas_Vx.x.sh使用指导... 5](#_Toc63254717) [1. #执行脚本... 6](#_Toc63254718) [2. #选择是否创建用户... 6](#_Toc63254719) [3. #选择安装系统依赖配置... 6](#_Toc63254720) [4 #安装Python配置... 7](#_Toc63254721) [5. #选择推理还是训练... 7](#_Toc63254722) [四、自定义配置安装（可用于批量安装）... 10](#_Toc63254723) ## 脚本使用前说明： **在使用本脚本前需准备设备以及系统，如果已准备好请跳过“脚本使用”此步骤：** **1.** **准备设备** **1.1 PC****机（搭建****WSL****开发环境）** **1.2****昇腾服务器（搭建****Atlas****运行环境****+****开发环境）** **并且目前版本中，** **推理服务器为：****Atlas800 (3000/3010)** ​ **训练服务器为：****Atlas800 (9000/9010)** **2.** **准备系统环境** **2.1** **PC****机（搭建****WSL****系统，如果您已安装虚拟机可以忽略此步骤）** **这是一个在****Windows****上的****linux****子系统，方便那些不适合安装虚拟机的同志。** 参见：https://docs.microsoft.com/en-us/windows/wsl/install-win10 **2.2** **Atlas 800****推理服务器** **（型号****3000****）** 参见：https://support.huaweicloud.com/instg-cli-cann/atlascli_03_0009.html **2.3** **Atlas 800****推理服务器** **（型号****3010****）** 参见：https://support.huaweicloud.com/instg-cli-cann/atlascli_03_0010.html **2.4** **Atlas 800****推理服务器** **（型号****9000****）** 参见：https://support.huaweicloud.com/instg-cli-cann/atlascli_03_0013.html **2.5** **Atlas 800****推理服务器** **（型号****9010****）** 参见：https://support.huaweicloud.com/instg-cli-cann/atlascli_03_0014.html ## 一、 Install_Tool_Atlas_V1.1.sh 脚本简介： **1)** **昇腾环境在线安装：** （Atlas商用软件包需要自行下载并放在“Atlas_V20_0”或“Atlas_V20_1”文件夹中，其中驱动包放在“Atlas_driver”，CANN包放在“Atlas_cann”）。 **2)** **昇腾环境离线安装：** (需要提前准备好离线包，可以使用本脚本在联网的相同环境的设备去拉取“OS依赖”包和“Python”包。并保存到与系统架构相同的文件夹中。) **3)** **脚本轻巧、交互式界面：** 只需一个Install_Tool_Atlas_V1.1.sh文件即可在系统上执行在线安装系统环境；客户可以根据每一步骤的选择提示信息，选择安装自己需要的版本。 **4)** **自动识别安装系统与架构：** （目前支持Ubuntu18.04与centOS 下的X86与ARM系统），并在安装所有软件时，选择与之对应的版本。 **5)** **Atlas****软件栈版本：** 脚本支持选择Atlas V20.0与Atlas V20.1 的版本，以及通用自定义版本 **6)** **Atlas****软件栈模式：** 脚本支持“推理运行”和“训练运行”以及“推理开发”和“训练开发”环境。 **7)** **自定义配置选择安装：** 可修改“Atlas_Istall_Tool.sh”中的 “My_SET”配置后；已定义的配置选项，安装时不再询问使用者输入选择。 **8)** **Log****清屏与****Log****日志保存功能** **9)** **脚本保存地址：****https://gitee.com/evan-wt/install_-tool_-atlas** **10)** **脚本负责人：** 王涛 84172537 董长杰 84168824 ## 二、 Install_Tool_Atlas_V1.1.sh文件夹说明 ### 1 Install_Tool_Atlas_Vx.x.sh脚本文件 这是一个shell脚本文件，支持在linux系统上执行。 **脚本仓库地址：****https://gitee.com/evan-wt/install_-tool_-atlas** ### 2 Atlas_Istall_Tool的离线软件包目录 #### 2.1 OS系统依赖文件说明 以下目录结构放置了Ubuntu和centOS的对应的x86与arm系统依赖,共四个文件夹，**离线安装时**对应一个系统只需要获取其中一个文件夹即可。**如果没有以下文件夹，脚本会自动创建脚本所在系统上的离线系统依赖文件夹！** ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113208_ec4a36f1_8028950.png "屏幕截图.png") ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113219_7636e7f7_8028950.png "屏幕截图.png") #### 2.2 Python 文件夹结构说明 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113229_97a6babf_8028950.png "屏幕截图.png") **离线安装时**对应系统架构只需要获取其中一个文件夹即可。**如果没有以下文件夹，脚本会自动创建！** Python3.7_Pack_x86下的目录结构 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113241_0df8abc5_8028950.png "屏幕截图.png") #### 2.3 Atlas软件文件夹结构说明 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113252_ff334696_8028950.png "屏幕截图.png") Atlas_V20_1下的目录结构展示 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113301_159f42bf_8028950.png "屏幕截图.png") #### 2.4 目录示例 **提示：如果没有以下文件夹，脚本会在执行后自动创建需要的文件夹！** **以下图片目录包含多个系统与昇腾版本：** ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113313_20851822_8028950.png "屏幕截图.png") **UbuntuX86****上搭建****Atlas V20.1****环境时离线安装目录结构示例：** ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113322_35a19b1a_8028950.png "屏幕截图.png") ## 三、Install_Tool_Atlas_Vx.x.sh使用指导 ### 1. #执行脚本 1.1 执行脚本前请准备好设备系统环境，参见脚本[使用前说明](#_脚本使用前说明：) 1.2 将该脚本与昇腾软件包放入需要搭建昇腾环境的设备上，并按照[文件夹结构说明](#_Install_Tool_Atlas_V1.1.sh文件夹说明)放置文件。 1.3 离线安装时，还需要用户额外准备好设备对应系统的，离线系统依赖、Python安装包、以及Python第三方库安装包等。当然可以使用该脚本在线获取，以上软件包。 ### 2. #选择是否创建用户 [图片上传中…(image-GVr6KRkgeRsji2t0J2U1)] **选项说明：** 第一次安装时，请输入y/yes 创建HwHiAiUser用户. ### 3. #选择安装系统依赖配置 [图片上传中…(image-HtIWzDrrlZNvgkBdLxHi)] **选项说明：** #### 3.1在线安装时，输入“1”。 #### 3.2 离线安装时，输入“5”，没有离线安装包时请先选择3。 **#** **选择****1****和****2** **时安装和卸载，昇腾配置清单里的****OS****系统依赖，详见脚本中的配置清单** **#** **选择****4** **单独下载****OS****包**会根据该设备系统去下载对应的OS依赖，并保存到以系统和时间命名的文件中。 ​ ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113428_884149ce_8028950.png "屏幕截图.png") ### 4 #安装Python配置 #### 4.1 Python安装选项 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113438_ae9efc6e_8028950.png "屏幕截图.png") 1） 如果没有安装Python3.7.5，输入“1”。没有准备Python安装包，先选3下载！ 2） 如果已安装Python3.7.5，输入“2”。安装Python依赖；如果都安装了，可输入“b”跳过。 #### 4.2 #安装Python第三方库配置 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/113444_9c1fea31_8028950.png "屏幕截图.png") ### 5. #选择推理还是训练 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/135335_7bed786f_8028950.png "屏幕截图.png") ​ \# "0: 推理环境" \# "1: 训练环境" ​ \# "b：跳过 " #### 5.1 #选择Atlas版本 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/135352_fe97a98d_8028950.png "屏幕截图.png") ​ \# " please input num[0-1]" ​ \# "0. 安装 Atlas 20.0V" ​ \# "1. 安装 Atlas 20.1V" #### 5.2 #（第五步选择推理时）选择推理环境配置 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/135412_714b02f7_8028950.png "屏幕截图.png") ​ \# "0.安装开发和运行环境，Atlas-driver和CANN、NNRT（包含toolbox）" ​ \# "1.安装纯运行环境，Atlas-driver和NNRT（包含toolbox）" ​ \# "2.安装纯开发环境，CANN包" ​ \# "3.单独安装运行推理包，NNRT包（包含toolbox）" ​ \# "4.单独安装运行驱动，Atlas-driver" ​ \# "b. 跳过 " #### 5.3. #（第五步选择训练后进入此步骤）选择训练环境配置 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/135424_863c9237_8028950.png "屏幕截图.png") ​ \# "0.安装训练 开发与运行环境driver和cann、nnae(包含TFPlugin、toolbox)" ​ \# "1.安装训练 运行环境驱动driver" ​ \# "2.安装训练 开发环境cann(包含TFPlugin)" ​ \# "3.安装训练 运行环境nnae(包含TFPlugin、toolbox)" ​ \# "b. 跳过 " #### 5.4. #（第五步选择自定义安装后进入此步骤） ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/135446_9beee098_8028950.png "屏幕截图.png") 1） 安装自定义昇腾软件，请把昇腾软件分CANN包和driver驱动包放在./Atlas_V0_0/下。 2） 并且在脚本的配置清单中添加，自定义软件的全名。详见，配置清单中的 [ #set train配置自定义训练软件包](#_#set_train配置自定义训练软件包) 和 [ #set infer配置自定义推理软件包](#_#set_infer配置自定义推理软件包) ## 四、自定义配置安装（可用于批量安装） 根据用户喜好与要求，配置固定安装选项。安装时不再询问使用者选择输入，可实现真正一键操作全流程跑通。 编辑器打开Install_Tool_Atlas_Vx.x.sh脚本后，修改如下选项后，安装时会指定安装，指定选项后不会再有选择界面。 编辑脚本截图如下(linux中，使用vi 编辑器)： ![输入图片说明](https://images.gitee.com/uploads/images/2021/0325/135548_72d5aaaa_8028950.png "屏幕截图.png") 跳转到“My_SET Config”选项下 \# My_SET Config ############################### \#################安装配置定义################## #### #是否创建用户 ​ add_HwHiAiUser_set=-1 ​ \# "你想要创建一个 HwHiAiUser用户, 和HwHiAiUser用户组吗?" ​ \# -1（默认）：不配置 add_HwHiAiUser_set=-1 ​ \# yes：是 add_HwHiAiUser_set=yes ​ \# no：否 add_HwHiAiUser_set=no #### #安装系统依赖配置 ​ Use_os_pack_set=-1 ​ \# "-1（默认） 不配置" ​ \# "1 下载并安装 OS依赖" ​ \# "2 卸载OS 依赖" ​ \# "3 更新OS包" ​ \# "4 单独下载OS包" ​ \# "5 离线安装OS依赖" ​ \# "b 跳过系统环境包 安装" #### #安装Python配置 ​ install_Python_set=-1 ​ \# "-1（默认） 不配置" ​ \# "0. 安装Python and Python第三方库（如果没有包先下载Python-3.7.5.tgz）" ​ \# "1. 仅安装Python，离线安装（如果没有包先下载Python-3.7.5.tgz）" ​ \# "2. 仅安装或者下载Python依赖 " ​ \# "3. 下载Python-3.7.5.tgz包 " ​ \# "b. 跳过 " #### #安装Python第三方库配置 ​ install_pip_IDE_set=-1 ​ \# "-1（默认） 不配置" ​ \# "0：Python依赖 离线安装" ​ \# "1：Python依赖 在线安装" ​ \# "2：Python依赖 下载更新" ​ \# "3：Python 卸载 " ​ \# "b：跳过 Python依赖安装 " #### #选择推理还是训练 ​ atlas_Inf_or_Tra_set=-1 ​ \# "-1（默认） 不配置" ​ \# "0: 推理环境" ​ \# "1: 训练环境" ​ \# "b：跳过 " ​ #### #选择Atlas版本 ​ atlas_V_set=-1 ​ \# "-1（默认） 不配置" ​ \# " please input num[0-1]" ​ \# "0. 安装 Atlas 20.0V" ​ \# "1. 安装 Atlas 20.1V" ​ #### #选择推理环境配置 ​ install_A300_set=-1 ​ \# "-1（默认） 不配置" ​ \# "0.安装开发和运行环境，Atlas-driver和CANN、NNRT（包含toolbox）" ​ \# "1.安装纯运行环境，Atlas-driver和NNRT（包含toolbox）" ​ \# "2.安装纯开发环境，CANN包" ​ \# "3.单独安装运行推理包，NNRT包（包含toolbox）" ​ \# "4.单独安装运行驱动，Atlas-driver" ​ \# "b. 跳过 " #### #选择训练环境配置 ​ install_A9000_set=-1 ​ \# "-1（默认） 不配置" ​ \# "0.安装训练 开发与运行环境driver和cann、nnae(包含TFPlugin、toolbox)" ​ \# "1.安装训练 运行环境驱动driver" ​ \# "2.安装训练 开发环境cann(包含TFPlugin)" ​ \# "3.安装训练 运行环境nnae(包含TFPlugin、toolbox)" ​ \# "b. 跳过 " #### #配置是否清屏 ​ set_clear=1 #### #配置是否打印日志 ​ set_log=1 ​ \#0:不打印日志 ​ \#1：打印日志 ​ #### #set infer配置自定义推理软件包 ​ set_F_A300="" ​ set_F_A301="" ​ set_F_A300_cann="" ​ set_F_A300_nnrt="" ​ set_F_A300_toolbox="" #### #set train配置自定义训练软件包 ​ set_F_A9000="" ​ set_F_A9001="" ​ set_F_A9000_cann="" ​ set_F_A9000_fwk="" ​ set_F_A9000_nnae="" ​ set_F_A9000_toolbox="" ​ \################################My_SET Config end