在线下载

支持在Windows或Linux系统上下载CANN软件包所需OS依赖，以及docker软件等。

须知

ascend-deployer工具在线下载仅提供昇腾社区版本的软件包，商用版本无法拉取。如需获取商用版本请在下载时仅选择下载OS依赖包，对应软件包请参考准备软件包自行上传。
通过在线下载方式获取软件包即表示您同意华为企业业务最终用户许可协议（EULA）的条款和条件。
ascend-deployer工具已提供源配置文件，默认使用华为源，用户可根据需要进行替换。具体可参考源配置。
执行下载操作，会自动下载好CANN软件包所需OS依赖，以及docker软件等，并存放于ascend-deployer/ascend_deployer/resources目录下，执行安装部署前，需将ascend-deployer整个目录上传到待安装设备的用户家目录。
Kylin V10SP1系统下载系统依赖时请指定为Kylin_V10Tercel_aarch64或Kylin_V10Tercel_x86_64，Kylin V10SP2系统下载系统依赖时请指定为Kylin_V10Sword_aarch64。
由于ascend-deployer工具不能自动下载x86_64架构的Atlas A2 训练系列产品驱动固件包，如果用户想在该场景下部署环境，请参考准备软件包的方式二，将对应的驱动固件包上传至ascend-deployer工具文件下的resources目录。
（可选）使用ascend-deployer工具下载CANN的软件包时，可以执行pip install esdk-obs-python==3.22.2安装esdk-obs-python，启用CANN软件包断点续传功能，防止出现因软件包较大、网络原因导致下载失败或者重新下载耗时较久的情况。
由于需要安装大量开源软件，ascend-deployer工具下载的开源软件均来自操作系统源，开源软件的漏洞和修复需要用户自行根据情况修复，强烈建议使用官方源定期更新。
由于需要下载大量软件包，ascend-deployer工具默认开启并行下载功能，用户可以修改ascend_deployer/downloader/config.ini文件中的parallel_download字段，决定是否开启并行下载功能，1为开启，0为关闭。默认并行下载线程数为16个，用户可通过ASCEND_DEPLOYER_DOWNLOAD_MAX_SIZE环境变量修改并行数量。

下载操作

使用在线下载功能下载6.0.RC1版本以前的驱动与固件、CANN软件包时，需满足在线下载功能的使用要求所示要求，请根据具体情况配置。

在Windows系统上下载
1. Windows环境需安装Python3，推荐使用Python3.7版本以上。如果已安装，请忽略。
  下载链接：Python3.7.5
  
  请根据界面提示完成安装。注意安装时在“Advanced Options”界面勾选“Add Python to environment variables”，否则需手动添加环境变量。
2. 启动下载：
  运行start_download_ui.bat
  
  在弹出的简易UI界面上勾选待安装设备的OS和需要在线下载的软件包。

在Linux系统上下载

支持root和非root用户执行下载操作，执行下载操作的用户需具有ascend-deployer工具目录的可执行权限。
请确保当前环境上存在Python3及pip3。
如果后续想使用非root用户安装表1中的软件，则需分别使用root和非root用户执行一遍下载操作。

通过下载zip包解压使用时，需进入ascend-deployer目录，执行如下命令：
```
bash start_download.sh --os-list=<OS1>,<OS2> --download=<PK1>,<PK2>==<Version>
```
<OS1>,<OS2>和<PK1>,<PK2>==<Version>可选范围可通过执行bash start_download.sh --help查看。参数说明具体请参考表1。
pip安装ascend-deployer时，执行命令如下：
```
ascend-download --os-list=<OS1>,<OS2> --download=<PK1>,<PK2>==<Version>
```
<OS1>,<OS2>和<PK1>,<PK2>==<Version>可选范围可通过执行ascend-download --help查看。参数说明具体请参考表1。

执行以上命令时需确认$HOME目录不存在ascend-deployer目录，若存在需删除该目录后再执行。

因为执行命令时会默认在$HOME目录下生成ascend-deployer目录，可通过设置环境变量ASCEND_DEPLOYER_HOME修改该目录所在路径。

表1 参数说明
参数	说明	是否必选
--os-list=<OS1>,<OS2>	--os-list参数用于指定待安装设备的OS，请根据实际替换，可同时指定多个。示例如下： --os-list=Ubuntu_18.04_aarch64,Ubuntu_18.04_x86_64 须知：进行批量部署，ascend-deployer工具所在服务器与待安装服务器的架构不相同时，--os-list参数须同时指定工具所在服务器的架构类型，保证当前架构存在nexus镜像。	必选
--download=<PK1>,<PK2>==<Version>	使用--download参数可以在线下载表1中的软件包。若用户想自行准备待安装软件包（具体可参见准备软件包），可删除该参数。如果用户需要安装DL和MEF Center，则只能选择使用--download参数在线下载。如用户想指定下载的软件包版本，请注意版本配套关系，如Ascend Data Center Solution 版本配套表所示。若不指定软件包版本，则会下载最新可选版本的软件包。示例如下： --download=NPU,CANN,MindSpore,MindStudio,Torch-npu,DL,MEF 当“ --download=NPU”时，会自动下载驱动和固件包，存放于ascend-deployer/ascend_deployer/resources/npu目录下。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。当“ --download=CANN”时，会自动下载CANN软件包（nnrt、nnae、toolkit、kernels、tfplugin）、toolbox软件包等，CANN相关和toolbox软件包存放于ascend-deployer/ascend_deployer/resources/CANN_x.x.x目录下。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。当“ --download=MindSpore”时，会自动下载MindSpore软件包并存放于ascend-deployer/ascend_deployer/resources/pylibs下的Ascend和CPU目录下。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。当“ --download=MindStudio”时，会自动下载MindStudio软件包并存放于ascend-deployer/ascend_deployer/resources/MindStudio_x.x.x目录下。目前使用ascend-deployer工具下载安装MindStudio，仅支持Ubuntu_18.04、Ubuntu_22.04、openEuler_22.03LTS系统，及EulerOS_2.8系统的aarch64架构。当“ --download=Torch-npu”时，会自动下载官方torch包、torch_npu并存放于ascend-deployer/ascend_deployer/resources/pylibs目录下。APEX软件包请参考Gitee链接自行编译，并放置在同一目录下。当“ --download=TensorFlow”时，会自动下载TensorFlow软件包并存放于ascend-deployer/ascend_deployer/resources/pylibs目录下。当“ --download=DL”时，会自动下载DL相关组件，DL相关组件存放于ascend-deployer/ascend_deployer/resources/目录下的mindxdl、docker和k8s文件夹内。仅支持Ubuntu_18.04、Ubuntu_20.04、Ubuntu_22.04、openEuler_20.03LTS、openEuler_22.03LTS、CentOS_7.6系统。若存在指定多个软件包版本不配套时，会出现提示信息，用户需确认后再下载。当“ --download=MEF”时，会自动下载MEF Center相关组件并存放于ascend-deployer/ascend_deployer/resources/目录下的mef、docker和kubeedge文件夹内。仅支持Ubuntu_20.04和openEuler_22.03LTS系统。	可选

父主题： 安装过程