Upgrade Cloud Platform

Manually upgrade the management nodes of ZStack Cloud, and all other nodes, such as hosts, primary storage, image storage, and VPC vRouters, will be automatically reconnected and upgraded.

ZStack Cloud provides single-management node and dual-management node deployment methods. The two deployment methods have different upgrading processes.

For more information about single-management node upgrading, see Single-Management Node Upgrading.
For more information about dual-management node upgrading, see Dual-Management Node Upgrading.

Single-Management Node Upgrading

This topic describes the upgrading process of a single-management node platform.

Obtain software packages for upgrading.
Prepare the following packages and save them in the /root/ directory of the management node:
- ZStack Cloud ISO:
  - Software: ZStack-Cloud-x86_64-DVD-5.3.0-h84r.iso
  - Download address: Click here
- ZStack Cloud installation package:
  - Software: ZStack-Cloud-installer-5.3.0.bin
  - Download address: Click here
- ZStack Cloud Upgrade Script:
  - Software: ZStack-Cloud-upgrade
  - Download address: Click here
Note:
- ZStack-Cloud supports offline upgrading, which allows you to upgrade the cloud platform without connecting to the public network. Therefore, you need to download the software packages and upgrade script in advance.
- After you download the software packages and upgrade script, check the MD5 hash of the packages or scripts. If the MD5 hash is inconsistent with that on the official website, download again.
Disable VM HA globally.

Login to the UI, choose Settings > Platform Setting > HA Policy, on the HA Policy page, click the Disable button on the upper right corner.
Back up the database and upgrading script.
Before you upgrade the cloud platform, back up the database and upgrading script, in case of any unexpected situations.
- Run the following command on the management node to back up the database in the /var/lib/zstack/mysql-backup/ directory:
```
[root@localhost ~]# zstack-ctl dump_mysql --file-name zstack-db-backup
```
- Run the following command on the management node to back up the upgrading script in the /root/ directory:
```
[root@localhost ~]# cp /usr/local/bin/zstack-upgrade /root/zstack-upgrade-bk
```
Upgrade the cloud platform.
Run the following commands on the management node to implement offline upgrading:
```
# Two offline upgrading methods are supported. The first one is recommended: # First method: Upgrade the local repo and management service simultaneously: [root@zstack-1 opt]# zstack-upgrade ZStack-Cloud-x86_64-DVD-5.3.0-h84r.iso # Second method: Upgrade the local repo first and then the management service: [root@localhost ~]# zstack-upgrade -r ZStack-Cloud-x86_64-DVD-5.3.0-h84r.iso [root@localhost ~]# bash ZStack-Cloud-installer-5.3.0.bin -u -P MYSQL_ROOT_PASSWORD
```
Note:
- If the root password of the database is the default password, you do not need to specify -P MYSQL_ROOT_PASSWORD.
- Before you run the zstack-upgrade command, make sure that you use ISO of the h84r version instead of other versions.
- While upgrading the local repo, the upgrade script is auto-updated. When the update is completed, rerun the preceding command.
Clean up the browser cache.

To make sure that the upgraded platform works as expected, after the upgrading is completed, you need to login to the UI platform and press Ctrl+F5 or Ctrl+Shift+R to clean up the browser cache.
Enable VM HA globally.

Login to the UI, choose Settings > Platform Setting > HA Policy, on the HA Policy page, click the Enable button on the upper right corner.

Now, the management node has been upgraded. The system will automatically reconnects other nodes, such as hosts, primary storage, image storage, and VPC vRouters, to complete the cloud platform upgrading.
You can continue to upgrade virtualization tools and Kernel as needed.

Dual-Management Node Upgrading

This topic describes the upgrading process of a dual-management node platform.

Obtain software packages for upgrading.
Prepare the following packages and save them respectively in the /root/ directory of the two management nodes:
- ZStack Cloud ISO:
  - Software: ZStack-Cloud-x86_64-DVD-5.3.0-h84r.iso
  - Download address: Click here
- ZStack Cloud installation package:
  - Software: ZStack-Cloud-installer-5.3.0.bin
  - Download address: Click here
- ZStack Cloud Upgrade Script:
  - Software: ZStack-Cloud-upgrade
  - Download address: Click here
- Multi-MN-HA Suite:
  - Software: ZStack-Multinode-HA-Suite-5.3.0.tar.gz
  - Download address: Click here
Note:
- ZStack-Cloud supports offline upgrading, which allows you to upgrade the cloud platform without connecting to the public network. Therefore, you need to download the software packages and upgrade script in advance.
- After you download the software packages and upgrade script, check the MD5 hash of the packages or scripts. If the MD5 hash is inconsistent with that on the official website, download again.
Disable VM HA globally.

Login to the UI, choose Settings > Platform Setting > HA Policy, on the HA Policy page, click the Disable button on the upper right corner.
Back up the database and upgrading script.
Before you upgrade the cloud platform, back up the database and upgrading script, in case of any unexpected situations.
- Run the following command on the management nodes respectively to back up the database in the /var/lib/zstack/mysql-backup/ directory:
```
[root@localhost ~]# zstack-ctl dump_mysql --file-name zstack-db-backup
```
- Run the following command on the management nodes respectively to back up the upgrading script in the /root/ directory:
```
[root@localhost ~]# cp /usr/local/bin/zstack-upgrade /root/zstack-upgrade-bk
```
Update the local repo.
Run the following command on the management nodes respectively to update the local repo:
```
[root@localhost ~]# bash zstack-upgrade -r ZStack-Cloud-x86_64-DVD-5.3.0-h84r.iso
```
Note: While upgrading the local repo, the upgrade script is auto-updated. When the update is completed, rerun the preceding command.
Obtain the IP address of the management node that corresponds to the VIP you use.
Run the following command to obtain the IP address of the management node that corresponds to the VIP you use. The management node that corresponds to the yes result is the management node you need:
```
[root@localhost ~]# zsha2 status
```
Decompress the Multi-MN-HA file and grant the decompressed files execution permission.
Run the following commands on the management node that corresponds to the VIP you use to decompress the Multi-MN-HA file and grant the decompressed files zsha2 and zstack-hamon execution permission:
```
[root@localhost ~]# tar zxvf ZStack-Multinode-HA-Suite-5.3.0.tar.gz      #Decompress the Multi-MN-HA file [root@localhost ~]# chmod +x zsha2 zstack-hamon    #Grant the decompressed files execution permission
```
Upgrade Multi-MN-HA Suite
Run the following command on the management node that corresponds to the VIP you use to upgrade Multi-MN-HA Suite:
```
[root@localhost ~]# ./zsha2 upgrade-ha
```
Upgrade the cloud platform.
Run the following command on the management node that corresponds to the VIP you use to upgrade the management nodes:
```
zsha2 upgrade-mn -peerpass password ZStack-Cloud-installer-5.3.0.bin
```
Note: -peerpass is optional. You can use the parameter to set the password of SSH login to the peer management nodes.
Clean up the browser cache.

To make sure that the upgraded platform works as expected, after the upgrading is completed, you need to login to the UI platform and press Ctrl+F5 or Ctrl+Shift+R to clean up the browser cache.
Enable VM HA globally.

Login to the UI, choose Settings > Platform Setting > HA Policy, on the HA Policy page, click the Enable button on the upper right corner.

Now, the management nodes have been upgraded. The system will automatically reconnects other nodes, such as hosts, primary storage, image storage, and VPC vRouters, to complete the cloud platform upgrading.
You can continue to upgrade virtualization tools and Kernel as needed.

Single-Management Node Upgrading

Dual-Management Node Upgrading

Products

Solutions

Help & Support

Contact Us