在Linux系统上下载
MindCluster Ascend Deployer工具支持在Linux系统上下载系统依赖、CANN软件包、NPU固件与驱动、AI框架、MindCluster组件（性能测试，故障诊断，集群调度）等。MindCluster Ascend Deployer工具支持下载的全部软件包请参见表2。
当前支持以下2种下载方式。
须知
- MindCluster Ascend Deployer工具在线下载仅提供昇腾社区版本的软件包，商用版本无法拉取。如需获取商用版本请在下载时仅选择下载OS依赖包，对应软件包请参考安装昇腾软件（自行准备软件包方式）自行上传。
- 下载软件包和依赖所需空间较多，请确保下载目录的可用空间至少为20G，下载过程中如遇空间不足的报错信息，请根据实际情况配置可用空间。
- 由于需要安装大量开源软件，MindCluster Ascend Deployer工具下载的开源软件均来自操作系统源，开源软件的漏洞和修复需要用户自行根据情况修复，强烈建议使用官方源定期更新。
- 了解全部MindCluster Ascend Deployer工具下载须知请参见下载注意事项。
- MTOS由于需使用到公网无法获取的kernel-devel包，下载功能仅为预埋，若需使用，请下载完成后替换为镜像解压后的kernel-devel-5.10.0-218.0.0.mt20240808.560.mt2203sp4.aarch64.rpm包。
- Linux用户可通过如下命令，触发刷新可下载的软件包列表。
bash start_download.sh -h
若使用pip方式刷新，可使用如下命令。
ascend-download -h
前提条件
- 已获取MindCluster Ascend Deployer工具。
- 执行下载操作的用户需具有MindCluster Ascend Deployer工具目录的可执行权限。
- 当前环境上存在Python3及pip3。
下载方式一
ascend-download --os-list=<OS> --download=<PK1>,<PK2>==<Version>
关于以上参数的详细说明请参考表1或执行ascend-download --help查看。
执行以上命令时需确认$HOME目录不存在ascend-deployer目录，若存在需删除该目录后再执行。因为执行命令时会默认在$HOME目录下生成ascend-deployer目录，可通过设置环境变量ASCEND_DEPLOYER_HOME修改该目录所在路径。
下载方式二
当通过下载zip包解压使用MindCluster Ascend Deployer工具时，可执行此种下载方式。
进入MindCluster Ascend Deployer解压后的目录。示例如下。
cd $HOME/ascend-deployer-{version}/ascend_deployer
bash start_download.sh --os-list=<OS> --download=<PK1>,<PK2>==<Version>
参数说明具体请参考表1或执行bash start_download.sh --help查看。
参数 |
说明 |
是否可选 |
|---|---|---|
--os-list=<OS> |
--os-list参数用于指定待安装设备的OS，请根据实际替换，可同时指定多个。 示例如下： --os-list=Ubuntu_18.04_aarch64 查看MindCluster Ascend Deployer工具支持的全部OS，请查看支持的OS及架构。 须知：
|
必选 |
--download=<PK1>,<PK2>==<Version> |
使用--download参数可以在线下载的全部软件包请参见支持下载的软件包。 如用户想指定下载的软件包版本，请联系华为技术支持获取版本配套表；若不指定软件包版本，则会下载最新可选版本的软件包。由于MindIE-image较大，下载时需要指定其版本及型号。示例如下： --download=NPU,CANN,Torch-npu,DL,FaultDiag 在以上示例中，各软件包包含的组件说明如下： NPU：npu(driver、firmware)，mcu CANN：nnae，nnrt，tfplugin，toolkit，kernels，toolbox DL：ascend-device-plugin，ascend-docker-runtime，hccl-controller，noded，npu-exporter，volcano，ascend-operator，resilience-controller，clusterd，mindio FaultDiag：faultDiag MindSpore：mindspore TensorFlow：tensorflow Torch-npu：torch-npu，torch MindIE-image：mindie-image 说明：
|
可选 |
存放路径说明
查看下载结果报告
下载完成后，在~/.ascend_deployer/download_info下会生成下载结果文件failed_download_result_{pid}_{下载时间}.json。若下载失败，可在此查看下载失败的结果报告。