ZStack Cloud Platform
Single Server, Free Trial for One Year
-
Documentation&Tools
Comprehensive product documentation and tools
-
Support & Services
Upholding the value of Customer First and the mission of Serving Customer, ZStack is dedicated to providing secure and stable services for customers.
-
Training & Certification
To educate ZStack partners and interested individuals about cloud computing and to cultivate cloud computing talent.
-
Content
ZStack provides innovative cloud infrastructure for ten major industries
VMware-to-ZStack Case Collection
The report provides three major
solutions and customer case studies for transitioning from VMware to ZStack.
ZStack Cloud 5.5.0>ZStack Cloud Tutorials>ZStack Cloud Private Cloud>Platform Upgrade Tutorial>Upgrade Cloud Platform
Upgrade Cloud Platform
Manually upgrade the management nodes of ZStack Cloud to the latest version. Then, automatically or manually upgrades resources such as hosts, primary storage, image storage, and VPC vRouters, depending on the selected upgrade method.
ZStack Cloud supports two platform upgrade methods: standard upgrade and grayscale upgrade, for both single-management node and dual-management node deployments. Upgrade procedures vary by upgrade method and deployment method. Select the appropriate upgrade method and procedure based on the actual deployment scenario:
- Standard Upgrade
Standard upgrade method upgrades the management node first. Then, the platform automatically reconnects and upgrades resources such as hosts, primary storage, image storage, and VPC vRouters in a single operation. This method does not support batch-based or phased upgrade control.
- For more information about single-management node upgrading, see Single-Management Node Standard Upgrading.
- For more information about dual-management node upgrading, see Dual-Management Node Standard Upgrading.
- Grayscale Upgrade
Grayscale upgrade method upgrades the management node first but does not immediately upgrade all hosts and other nodes. The platform advanc
es the upgrade in batches by using grayscale control. You can prioritize hosts that run noncritical workloads for validation. After verification completes without issues, gradually proceed to a full upgrade to reduce upgrade risk.
- For more information about single-management node grayscale upgrading, see Single-Management Node Grayscale Upgrading.
- For more information about dual-management node grayscale upgrading, see Dual-Management Node Grayscale Upgrading.
Note: The grayscale upgrade feature is available only in ZStack Cloud 5.0.0 and later. Earlier versions do not support this upgrade mode.
Single-Management Node Standard Upgrading
About this task
This topic describes the standard upgrading process of a single-management node platform.Procedure
- 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.5.0-h84r.iso
- Download address: Click here
- ZStack Cloud installation package:
- Software: ZStack-Cloud-installer-5.5.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.
- ZStack Cloud ISO:
- Disable VM HA globally.
Login to the UI, choose , 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
- Run the following command on the management node to back up the database in the /var/lib/zstack/mysql-backup/ directory:
- 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.5.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.5.0-h84r.iso [root@localhost ~]# bash ZStack-Cloud-installer-5.5.0.bin -u -P <MYSQL_ROOT_PASSWORD>Note: <MYSQL_ROOT_PASSWORD>is the password of the MySQL root user. The placeholder is for example purposes only and must be replaced with the actual password.- 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+F5orCtrl+Shift+Rto clean up the browser cache. - Enable VM HA globally.
Login to the UI, choose , on the HA Policy page, click the Enable button on the upper right corner.
What to do next
- 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 Standard Upgrading
About this task
This topic describes the standard upgrading process of a dual-management node platform.Procedure
- 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.5.0-h84r.iso
- Download address: Click here
- ZStack Cloud installation package:
- Software: ZStack-Cloud-installer-5.5.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.5.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.
- ZStack Cloud ISO:
- Disable VM HA globally.
Login to the UI, choose , 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
- Run the following command on the management nodes respectively to back up the database in the /var/lib/zstack/mysql-backup/ directory:
- 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.5.0-h84r.isoNote: 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.5.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.5.0.binNote: -peerpassis 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+F5orCtrl+Shift+Rto clean up the browser cache. - Enable VM HA globally.
Login to the UI, choose , on the HA Policy page, click the Enable button on the upper right corner.
What to do next
- 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.
Next Chapter: Upgrade Virtualization Tools