Overview

Upgrading ZStack Cube Ultimate updates the management nodes, compute nodes, and network nodes to the latest versions, along with basic software packages, software library dependencies, and core virtualization tools. This document details the operational procedure for upgrading ZStack Cube Ultimate.

Limitations

This document applies to hyper-converged platform upgrade of the same repository (repo), specifically:
- All management nodes and hosts within the current platform are using the same operating system (OS) version, for example, all use the h84r OS.
- The target OS edition is consistent with that currently used by the management nodes and hosts. For example, if all management nodes and hosts on the current platform are running the h84r OS, you must use the h84r edition ISO to perform the upgrading.
- If you need to change the OS edition or perform an upgrade in multi-repo environments, contact official technical support for assistance.
This document covers only the upgrade of the hyper-converged platforms. To upgrade the connected distributed storage, contact official technical support for assistance.

Upgrading Mechanism

ZStack Cube Ultimate provides the following upgrading mechanisms:

Seamless Upgrading: In a same-repo environment, ZStack Cube Ultimate version 1.3.1 and all subsequent versions can be seamlessly upgraded to the latest version with one click.
Lossless Upgrading: ZStack Cube Ultimate upgrade process does not affect services running on VM instances.

Considerations

Before upgrading ZStack Cube Ultimate, be aware of the following points:

During the ZStack Cube Ultimate upgrade, management nodes are inaccessible, and you cannot apply for resources such as VM instances and volumes. Therefore, we recommend that you perform the upgrade during off-peak business hours to avoid resource application or service changes during the upgrade.
After the upgrade is completed, the system reconnects all hosts, primary storage, image storage, and VPC vRouters and automatically upgrades related resources. You cannot perform operations on VM instances, volumes, and other related resources during the reconnection.
If an error occurs and interrupts the upgrade, you can troubleshoot the error and re-execute the upgrade operation. If you have any question or need a help, contact the official technical support.

Preparations

The following software packages may be required for upgrading ZStack Cube Ultimate. You can obtain packages according to your actual scenario:

ZStack Cube Ultimate ISO. ZStack Cube Ultimate provides multiple ISO versions, allowing you to select and download the appropriate one based on your situation:
- x86-h84r version: ZStack-Cube-x86_64-DVD-2.5.4.2-h84r.iso
- x86-kylinsp3 version: ZStack-Cube-x86_64-DVD-2.5.4.2-ky10sp3.iso
- x86-kylinsp3.2403 version: ZStack-Cube-x86_64-DVD-2.5.4.2-ky10sp3.2403.iso
- ARM-kylinsp3 version: ZStack-Cube-arrch64-DVD-2.5.4.2-ky10sp3.iso
Multi-MN-HA Suite:
- Software Name: Multinode-HA-Suite-zsha2_ZStack-Cube_2.5.4.2.tar.gz
- Download Link: Contact official technical support or access.

Note: After you download the software packages and upgrade script, check the MD5 hash of the packages or scripts.

Typical Upgrade Procedure

About this task

This topic takes the x86-h84r edition as an example to describe the detailed upgrade procedure of ZStack Cube Ultimate.

Procedure

Query the current version of ZStack Cube Ultimate.
Run the following command on the management node to query the current version of ZStack Cube Ultimate. The result can serve as a reference to verify the success of the upgrade once the entire procedure is complete.
```
[root@localhost ~]# zstack-ctl status
```
Obtain software packages for upgrading.

Refer to Preparations to prepare the ISO package and the Multi-MN-HA Suite and store them in the /root/ directory of a management node.
Note: You can select any management node to execute the steps guided in this topic to complete the upgrade process and do not need to repeat the operations on the other management node.
Disable VM HA globally.

Log in to the ZStack Cube Ultimate 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.
Before you upgrade the management node, back up the database for recovery if any errors occur.
- Run the following command on two management nodes respectively to back up the database to the /var/lib/zstack/mysql-backup/lib/zstack/mysql-backup/ directory:
```
[root@localhost ~]# zstack-ctl dump_mysql --file-name zstack-db-backup
```
Decompress the Multi-MN-HA Suite.
Run the following command on the management node to decompress the Multi-MN-HA Suite:
```
#Decompress the Multi-MN-HA Suite
[root@localhost ~]# tar zxvf Multinode-HA-Suite-zsha2_ZStack-Cube_2.5.4.2.tar.gz
```
Upgrade the Multi-MN-HA Suite.
Run the following command on the management node to upgrade the Multi-MN-HA suite:
```
[root@localhost ~]# ./zsha2 upgrade-ha
```
Confirm the management node status.
After you upgrade the Multi-MN-HA Suite, run the following command to check the management node status:
```
[root@localhost ~]# zsha2 status
```
Upgrade the management nodes.
Run the following command on the management node to upgrade the management nodes:
```
[root@localhost ~]# zsha2 upgrade-mn -peerpass password ./ZStack-Cube-x86_64-DVD-2.5.4.2-h84r.iso
```
Note: -peerpass is an optional parameter. You can set the SSH login password for the Peer management node.
Check the ZStack Cube Ultimate version
After the upgrade is complete, run the following command on the management node to verify whether ZStack Cube Ultimate is upgraded to the latest version as expected:
```
[root@localhost ~]# zstack-ctl status
```
Check the management node status.
run the following command to check the management node status:
```
[root@localhost ~]# zsha2 status
```
Confirm resource connection status.

Log in to the Cloud UI, choose Resource Center > Hardware. On the Hardware page, check the connection status of the hosts, primary storage, and image storage respectively.
Enable VM HA globally.
Log in to the ZStack Cube Ultimate UI, choose Settings > Platform Setting > HA Policy, on the HA Policy page, click the Enable button on the upper right corner.

PreviousInstallation Tutorial