ZStack Cloud 5.3.20>ZStack Cloud 实践教程>私有云>云平台升级教程>平台版本升级

平台版本升级

手动升级ZStack Cloud管理节点至最新版本。升级后，平台将重连物理机、主存储、镜像服务器、VPC路由器等资源，自动完成对应节点的升级。

ZStack Cloud支持单管理节点和双管理节点两种部署方式，不同部署方式的平台升级流程存在较大区别，请务必按照对应升级流程进行操作：

单管理节点典型升级流程请参考单管理节点升级章节。
双管理节点典型升级流程请参考双管理节点升级章节。

单管理节点升级

背景信息

本章节详细介绍单管理节点升级的操作流程。

操作步骤

获取升级安装包。
准备以下软件包，并存放在管理节点/root/目录：
- ZStack Cloud ISO：
  - 软件名称: ZStack-Cloud-x86_64-DVD-5.3.20-h84r.iso
  - 下载地址：点击这里
- ZStack Cloud安装包：
  - 软件名称：ZStack-Cloud-installer-5.3.20.bin
  - 下载地址：点击这里
- ZStack Cloud升级脚本：
  - 软件名称：ZStack-Cloud-upgrade
  - 下载地址：点击这里
说明:
- ZStack Cloud支持离线升级，无需连接公网，请提前获取软件包和升级脚本。
- 软件包或升级脚本下载完成后，请确保MD5与官网一致，如不一致请重新下载。
关闭云主机高可用全局开关。

登录ZStack Cloud UI界面，点击设置 > 平台设置 > 高可用策略，在高可用策略界面，点击右上角的停用按钮。
备份数据库和升级脚本。
升级前，备份数据库和升级脚本以用于意外恢复。
- 登录管理节点，执行以下命令将数据库备份至/var/lib/zstack/mysql-backup/目录：
```
[root@localhost ~]# zstack-ctl dump_mysql --file-name zstack-db-backup
```
- 在管理节点执行以下命令将升级脚本备份备份至/root/目录：
```
[root@localhost ~]# cp /usr/local/bin/zstack-upgrade /root/zstack-upgrade-bk
```

升级平台版本。

在管理节点进行离线升级：

#支持两种离线升级方式，推荐使用第一种: # 第一种方式： 升级本地仓库和管理服务 [root@zstack-1 opt]# zstack-upgrade ZStack-Cloud-x86_64-DVD-5.3.20-h84r.iso # 第二种方式： 先升级本地仓库再升级管理服务: [root@zstack-1 opt]# zstack-upgrade -r ZStack-Cloud-x86_64-DVD-5.3.20-h84r.iso  [root@zstack-1 opt]# bash ZStack-Cloud-installer-5.3.20.bin -u -P MYSQL_ROOT_PASSWORD

说明:

若数据库root密码采用系统默认密码zstack.mysql.password， -P MYSQL_ROOT_PASSWORD参数可省略。
执行zstack-upgrade命令前需确认所准备的ISO是基于h84r版，避免使用其他ISO覆盖本地源。
升级本地仓库时会自动更新升级脚本，脚本升级完成后，可按提示重新执行上一步命令即可。

手动清理浏览器缓存。

为了保证新功能能够正常使用，请在升级完成后登录ZStack Cloud UI界面，并按下Ctrl+F5或Ctrl+Shift+R，手动清理浏览器缓存。
开启云主机高可用开关。

在ZStack Cloud UI界面，点击设置 > 平台设置 > 高可用策略，在高可用策略界面，点击右上角的启用按钮。

后续操作

至此，单管理节点升级已完成，平台将自动重连物理机、主存储、镜像服务器、VPC路由器等资源，完成其他相关节点升级。用户可按需继续进行虚拟化组件和Kernel升级。

双管理节点升级

背景信息

本章节详细介绍双管理节点升级的操作流程。

操作步骤

获取升级安装包。
准备以下软件包，并分别存放在两个管理节点的/root/目录：
- ZStack Cloud ISO：
  - 软件名称: ZStack-Cloud-x86_64-DVD-5.3.20-h84r.iso
  - 下载地址：点击这里
- ZStack Cloud安装包：
  - 软件名称：ZStack-Cloud-installer-5.3.20.bin
  - 下载地址：点击这里
- ZStack Cloud升级脚本：
  - 软件名称：ZStack-Cloud-upgrade
  - 下载地址：点击这里
- 多管理节点高可用套件 Multi-MN-HA：
  - 软件名称：ZStack-Multinode-HA-Suite-5.3.20.tar.gz
  - 下载地址：点击这里
说明:
- ZStack Cloud支持离线升级，无需连接公网，请提前获取软件包和升级脚本。
- 软件包或升级脚本下载完成后，请确保MD5与官网一致，如不一致请重新下载。
关闭云主机高可用全局开关。

登录ZStack Cloud UI界面，点击设置 > 平台设置 > 高可用策略，在高可用策略界面，点击右上角的停用按钮。
备份数据库和升级脚本
升级前，备份数据库和升级脚本以用于意外恢复。
- 分别登录两个管理节点，执行以下命令将数据库备份至/var/lib/zstack/mysql-backup/目录：
```
[root@localhost ~]# zstack-ctl dump_mysql --file-name zstack-db-backup
```
- 分别在两个管理节点执行以下命令将升级脚本备份至/root/目录：
```
[root@localhost ~]# cp /usr/local/bin/zstack-upgrade /root/zstack-upgrade-bk
```
更新本地repo源
分别在两个管理节点执行以下命令，更新本地repo源：
```
[root@localhost ~]# zstack-upgrade -r ZStack-Cloud-x86_64-DVD-5.3.20-h84r.iso
```
说明: 升级本地repo时会自动更新升级脚本，脚本升级完成后，可按提示重新执行上一步命令即可。
获取VIP所在管理节点IP地址
执行以下命令获取VIP所在管理节点IP地址，返回结果中VIP为yes的节点即为VIP所在的管理节点：
```
[root@localhost ~]# zsha2 status
```
解压高可用套件，并赋予可执行权限
在VIP所在管理节点依次执行以下命令，解压高可用套件，并对zsha2和zstack-hamon文件赋予可执行权限：
```
[root@localhost ~]# tar zxvf ZStack-Multinode-HA-Suite-5.3.20.tar.gz      #解压高可用套件 [root@localhost ~]# chmod +x zsha2 zstack-hamon    #赋予可执行权限
```
升级高可用套件
在VIP所在管理节点执行以下命令，完成高可用套件升级：
```
[root@localhost ~]# ./zsha2 upgrade-ha
```
升级云平台
在VIP所在管理节点依次执行以下命令，升级双管理节点：
```
zsha2 upgrade-mn -peerpass password ZStack-Cloud-installer-5.3.20.bin
```
说明: -peerpass为可选参数，可设置Peer管理节点SSH登录密码。
手动清理浏览器缓存。

为了保证新功能能够正常使用，请在升级完成后登录ZStack Cloud UI界面，并按下Ctrl+F5或Ctrl+Shift+R，手动清理浏览器缓存。
开启云主机高可用开关。

在ZStack Cloud UI界面，点击设置 > 平台设置 > 高可用策略，在高可用策略界面，点击右上角的启用按钮。