升级虚拟化组件（可选）

平台版本升级后，可按需升级主机上的 QEMU 和 Libvirt，以使用新版本组件提供的功能和修复。

已完成平台版本升级，管理服务运行正常。
已准备与目标平台版本及当前环境操作系统匹配的 ISO。本任务以 H84r 版 ISO 为例。
已安排维护窗口。升级后需要使虚拟机使用新版 QEMU，请提前安排相关虚拟机的停机时间。

Note: 生产环境升级前，建议联系售后技术支持，确认升级方案及相关注意事项。

不同平台版本使用的 QEMU、Libvirt 版本可能不同。平台版本升级后，主机上的虚拟化组件不会自动更新，需要时可按集群执行本任务。

Note: QEMU 和 Libvirt 升级后不支持回滚至旧版本。

确认管理节点的本地仓库已更新至目标版本。
如果平台升级时已使用对应 ISO 更新本地仓库，无需重复执行。尚未更新时，请登录管理节点，在 ISO 所在目录执行以下命令。已设置管理节点 HA 的环境，需分别在两个管理节点执行。
```
[root@localhost ~]# zstack-upgrade -r ZStack-ZSphere-x86_64-DVD-5.2.0-H84r.iso
```
备份管理节点数据库。
在管理节点执行以下命令，将数据库备份至 /var/lib/zstack/mysql-backup/ 目录。已设置管理节点 HA 的环境，需分别在两个管理节点执行。
```
[root@localhost ~]# zstack-ctl dump_mysql --file-name zstack-db-backup-before-component-upgrade
```
检查平台服务和资源连接状态。
确认管理服务运行正常，并在管理界面检查待升级主机及相关存储资源的连接状态，确保资源均已连接。
关闭虚拟机高可用策略。
登录 ZSphere 管理界面，点击可靠服务 > 高可用策略，记录当前开关状态，并关闭高可用策略。若当前已关闭，保持关闭状态。
登录管理节点 CLI。
登录管理节点，执行以下命令。已设置管理节点 HA 的环境，需在 VIP 所在管理节点执行；可通过 zsha2 status 查看 VIP 所在节点。将 ADMIN_PASSWORD 替换为实际的 admin 账户密码。
```
[root@localhost ~]# zstack-cli
- >>> LogInByAccount accountName=admin password=ADMIN_PASSWORD
```
升级指定集群内主机的 QEMU。
在 CLI 中查询集群，获取待升级集群的 UUID。将 CLUSTER_UUID 替换为实际集群 UUID，执行升级命令：
```
admin >>> QueryCluster
admin >>> UpdateClusterOS updatePackages=qemu-kvm excludePackages=python2-crypto uuid=CLUSTER_UUID
```
记录返回的升级任务 UUID，将以下命令中的 LONG_JOB_UUID 替换为该 UUID，查询任务状态。等待 state 为 Succeeded 后，再继续后续操作。
```
admin >>> QueryLongJob uuid=LONG_JOB_UUID
```
升级同一集群内主机的 Libvirt。
1. 先更新 Libvirt 依赖的 glib2 软件包。
  将 CLUSTER_UUID 替换为待升级集群的 UUID，执行以下命令：
```
admin >>> UpdateClusterOS updatePackages=glib2 uuid=CLUSTER_UUID
```
  使用返回的任务 UUID 查询任务状态，等待 state 为 Succeeded 后，再升级 Libvirt。
```
admin >>> QueryLongJob uuid=LONG_JOB_UUID
```
2. 升级 Libvirt，并等待升级任务完成。
```
admin >>> UpdateClusterOS updatePackages=libvirt excludePackages=python2-crypto uuid=CLUSTER_UUID
```
  使用本次返回的任务 UUID 查询任务状态，等待 state 为 Succeeded。
```
admin >>> QueryLongJob uuid=LONG_JOB_UUID
```
检查主机上已安装的 QEMU 和 Libvirt 版本。
登录已升级的主机，执行以下命令，确认组件已更新至目标版本：
```
[root@localhost ~]# qemu-img -V
[root@localhost ~]# rpm -qa | grep libvirt
```
如需升级其他集群，请依次完成各集群的 QEMU、Libvirt 升级和版本检查。
使虚拟机使用新版 QEMU。
登录管理界面，将已升级主机上的相关虚拟机关机后重新开机，并检查虚拟机运行状态和业务是否正常。
按原状态恢复虚拟机高可用策略。
如果本任务执行前高可用策略处于开启状态，请在确认环境和虚拟机业务正常后，进入可靠服务 > 高可用策略，重新开启高可用策略。原先已关闭的，保持关闭状态。

上一篇平台升级后检查与处理下一篇升级 Kernel（可选）