Considerations

When you upgrade ZStack Cloud, note that:
  • During the upgrading, the management nodes are inaccessible and you cannot apply VM and volume resources. Therefore, we recommend that you upgrade the cloud platform during business troughs to avoid resource application and business change needs.
  • After the management node upgrading is completed, all hosts, primary storages, backup storages, VPC vRouters are reconnected and related resources are auto-upgraded. During the connection, you cannot perform operations on VM instances and volumes.
  • If an error occurs during the upgrading and interrupts the upgrading, you can troubleshoot the error. After the error is solved, you can upgrade the cloud platform again.
  • Starting from ZStack Cloud 4.7.0, the following are upgraded:
    • Provided ISO versions are upgraded.

      Starting from 4.7.0, ZStack Cloud provides two ISO versions based on the self-developed Helix: h76c and h79c. Multiple repos are supported.

      Starting from 4.7.0, ISO of the c76/c79 version is no longer used for installation and deployment of the new cloud platform. You can use an h76c/h79c ISO to upgrade your Cloud of an earlier version to 4.7.0 seamlessly.

  • Starting from ZStack Cloud 4.6.0, the following are upgraded:
    • Provided ISO versions are upgraded.
      Starting from ZStack Cloud 4.6.0, ISO of the c79 and c76 versions are available and multiple repos are supported. When you upgrade the cloud platform, note that:
      • ISO of the c74 version is no longer used for installation and deployment of the new cloud platform. If you need to expand the capacity or upgrade the operating system, contact the official technical support for help.
    • Affinity group is upgraded to VM scheduling policy.
      • The VM Scheduling Policy feature provides four types of policies: VM Exclusive from Each Other, VM Affinitive to Each Other, VMs Affinitive to Hosts, and VMs Exclusive from Hosts. Each policy has two execution mechanisms: Hard and Soft.
      • Anti-Affinity Group (Hard) and Anti-Affinity Group (Soft) policies provided in earlier versions are upgraded to VM Affinitive to Each Other (Hard) and VM Affinitive to Each Other (Soft) respectively, without any modification to the underlying working principles. This upgrade has no impact on your existing application workloads and is annoyance-free.
  • Starting from ZStack Cloud 4.3.12, the QEMU version is automatically upgraded from 2.12 to 4.2.
    • If you deploy a new Cloud by using the ISO of 4.3.12 or a later version, QEMU 4.2 is installed by default. If you upgrade your Cloud to 4.3.12 or a later version, QEMU 2.12 is used by default.
    • To use the Cloud properly, make sure that all hosts in the same cluster use the same QEMU version. Therefore, if you upgrade your Cloud to 4.3.12 or a later version, you could not expand the capacity by adding hosts (installed using the ISO of 4.3.12 or a later version) to the existing cluster. To expand the capacity, use a new cluster.
  • Starting from ZStack Cloud 4.0.0, we bring you the following enhancements:
    • vRouter is upgraded to VPC vRouter.

      Starting from 4.0.0, vRouter is upgraded to VPC vRouter and vRouter network is upgraded to VPC network. vRouter is no longer available on the UI. The seamless upgrade does not affect your business continuity.

    • User Group and User are replaced by Tenant Management Account System.
      Starting from 4.0.0, User Group and User are replaced by Tenant Management Account System. User Group and User are no longer available on the UI. You cannot login to the Cloud by using a user or user group account. Before you implement upgrading, migrate the user and user group account data to Tenant Management.
      Note: User accounts created by the admin and have the admin permissions are also cancelled. Platform admins in Tenant Management have the equivalent permissions. You can use Tenant Management to create platform managers based on your business needs.
    • The integration of AD/LDAP and accounts is adjusted.

      Starting from 4.0.0, the integration of AD/LDAP and accounts is managed by Tenant Management. Before you implement upgrading, migrate the AD/LDAP account data managed by the original account system to Tenant Management.

  • Starting from ZStack Cloud 3.9.0, if you use c74 ISO and QEMU 2.9, the libvirt version is automatically upgraded to 4.9.0.
    • If you use open-source Ceph distributed storage and enable the CEPHX (Ceph authentication) feature, when you hot-plug VM CD-ROM, an error may occur because libvirt of the new version does not support hot plugging. You can contact the official technical support when necessary.
    • Starting from 3.2.0, libvirt updates the format of shared volumes to raw. Therefore, when you create a shared volume, the format of the volume is raw. This type of volume does not allow you to create snapshots and resize capacities, or create images for powered-on VM instances to which this type of volume is attached. In later versions of ZStack Cloud, these limitations will be eliminated.
    • The libvirt auto-upgrading feature is enabled by default. You can disable the feature by using the following method:
      Enter the /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/ path of the management node (MN) and set the following parameter in the zstack.properties configuration file:
      updatePkgWhenConnect = false # Disable libvirt auto-upgrading.

      In a multi-MN environment, you need to configure the preceding parameter in all MN nodes. After you complete the configuration, restart the management node to make the modification take effect.

  • Starting from ZStack Cloud 3.7.1, ISO of the c76 and c74 editions are available and multiple repos are supported. When you upgrade the cloud platform, note that:
    • Starting from 3.7.1, ISO of the c72 edition is no longer used for installation and deployment of the new cloud platform. If you need to expand the capacity or upgrade the operating system, contact the official technical support for help.
    • Starting from 3.7.1, the local repo of ISO of the c72 edition is redirected to ISO of the c74 version. If you use offline upgrading, you need to obtain ISO of the c74 version to update the local repo.

Back to Top

Download

Already filled the basic info?Click here.

Enter at least 2 characters.
Invalid mobile number.
Enter at least 4 characters.
Invalid email address.
Wrong code. Try again. Send Code Resend Code (60s)

An email with a verification code will be sent to you. Make sure the address you provided is valid and correct.

Download

Not filled the basic info yet? Click here.

Invalid email address or mobile number.

Email Us

contact@zstack.io
ZStack Training and Certification
Enter at least 2 characters.
Invalid mobile number.
Enter at least 4 characters.
Invalid email address.
Wrong code. Try again. Send Code Resend Code (60s)

Email Us

contact@zstack.io
Request Trial
Enter at least 2 characters.
Invalid mobile number.
Enter at least 4 characters.
Invalid email address.
Wrong code. Try again. Send Code Resend Code (60s)

Email Us

contact@zstack.io

The download link is sent to your email address.

If you don't see it, check your spam folder, subscription folder, or AD folder. After receiving the email, click the URL to download the documentation.

The download link is sent to your email address.

If you don't see it, check your spam folder, subscription folder, or AD folder.
Or click on the URL below. (For Internet Explorer, right-click the URL and save it.)

Thank you for using ZStack products and services.

Submit successfully.

We'll connect soon.

Thank you for using ZStack products and services.