执行升级命令

升级前必读

• 使用MindCluster Ascend Deployer工具升级前，请确保MindCluster Ascend Deployer执行机的硬盘存储空间在16G以上。

前提条件

• 已完成软件包的下载。
• 升级用户为root用户，且具有install.sh的可执行权限。

升级步骤

1. 以软件包的升级用户登录待升级设备。
2. 执行升级命令。
   • pip安装MindCluster Ascend Deployer时，在本机任意路径使用ascend-deployer命令进行升级。

     ascend-deployer --upgrade=<package_name_1>,<package_name_2>

   • 通过下载zip包解压使用MindCluster Ascend Deployer工具时，需进入ascend_deployer目录，使用bash install.sh命令升级。

     bash install.sh --upgrade=<package_name_1>,<package_name_2>

   命令示例如表1所示。

   <package_name_x>可选范围参见支持安装及升级场景或通过执行bash install.sh --help查看全部可用参数。

   请按照“NPU>CANN、MindCluster（性能测试，故障诊断，集群调度）”的顺序进行升级，升级时resources目录下的CANN包版本需和NPU配套。

   表1 升级命令示例

   安装类型	升级命令
   NPU驱动和固件 （右侧命令任选其一执行）	bash install.sh --upgrade=npu
   	bash install.sh --upgrade=driver,firmware
   MCU固件	bash install.sh --upgrade=mcu
   CANN软件 （训练&推理&开发调试场景）	bash install.sh --upgrade=kernels,toolkit
   CANN软件 （边缘推理场景）	bash install.sh --upgrade=nnrt,kernels
   CANN软件 （训练&推理场景）	bash install.sh --upgrade=nnae,kernels
   MindCluster集群调度	bash install.sh --upgrade=ascend-device-plugin,ascend-docker-runtime,hccl-controller,noded,npu-exporter,volcano,ascend-operator,clusterd,resilience-controller
   MindCluster性能测试	bash install.sh --upgrade=toolbox
   MindCluster故障诊断	bash install.sh --upgrade=fault-diag
   说明 安装上述软件包的详细约束请参见表1。 <package_name_x>的全部可选参数详见支持安装及升级的软件包。

3. （可选）涉及升级CANN和MindCluster性能测试时，用户需签署华为企业业务最终用户许可协议（EULA）后进入升级流程，根据回显页面执行y或Y确认协议，输入其他任意字符为拒绝协议，确认接受协议后自动开始升级。

   若当前语言环境不满足要求，可以执行如下命令配置系统的默认语言环境。

   • 配置为中文

     export LANG=zh_CN.UTF-8

   • 配置为英文

     export LANG=en_US.UTF-8

4. （可选）涉及到升级驱动固件时，建议升级完成后立即重启。
   单机升级时重启请执行reboot命令。批量升级则执行以下命令重启所有设备。

   1. 如果MindCluster Ascend Deployer工具是部署在某一台待升级设备上，需要先在“inventory_file”屏蔽本机IP地址，如下加粗内容所示，否则执行5.2时可能还未发送重启命令到其他服务器，本机就已重启，导致其他服务器无法重启。如果MindCluster Ascend Deployer工具是部署在通用服务器可以跳过本步骤。

      #本机IP address ansible_ssh_user="root" # 屏蔽本机IP

   2. 重启服务器。

      ansible -i inventory_file all -m shell -a 'reboot'

   3. 其他待升级设备重启后，请在“inventory_file”中解除屏蔽的本机IP，然后执行reboot命令重启本机。