Help Center/ GeminiDB/ GeminiDB Cassandra API/ Working with GeminiDB Cassandra API/ Instance Modifications/ Upgrading a Minor Version
Updated on 2024-11-20 GMT+08:00
View PDF

Upgrading a Minor Version

GeminiDB Cassandra can be upgraded by installing patches to improve performance, release new features, or fix bugs.

If a new patch is released, you can upgrade your instance by clicking the upgrade button in the Compatible API column on the Instances page.

Figure 1 Patch installation

If the kernel version of your instance has potential risks or major defects, has expired, or has been brought offline, the system will notify you by SMS message or email and deliver an upgrade task during maintenance.

Precautions

  • Upgrade your instance once there are new patches released.
  • If the database version is a risky version, the system prompts you to upgrade the database patch.
  • The instance will be restarted and services may be interrupted during the upgrade. The interruption duration depends on services, quantity of nodes, and the amount of service data. Upgrade your instance during off-peak hours.
  • When you upgrade a cluster, services may be interrupted a number of times equal to the number of nodes in the cluster plus one. Each interruption will last for no more than a minute and will only affect the services on that node. The upgrade duration is as follows:

    600 + (N x 60) ≤ Total upgrade duration (s) ≤ 600 + (N x 120)

    For example, if there are 9 nodes in a cluster instance, the upgrade duration is 19 to 28 minutes.

    The upgrade duration of most instances is close to 600+ (N x 60). If there are too many tokens on a single node, the upgrade duration may be increased.

  • Before you upgrade a DR instance, upgrade the corresponding standby instance first and then the primary instance afterwards.

Procedure

  1. Log in to the GeminiDB console.
  2. In the service list, choose Databases > GeminiDB.
  3. On the Instances page, locate the instance you want to upgrade and click Upgrade Minor Version in the Compatible API column.

    Figure 2 Patch installation

    Alternatively, click the instance name to go to the Basic Information page. In the DB Information area, click Upgrade Minor Version in the Compatible API field.

    Figure 3 Patch installation

  4. In the displayed dialog box, click OK.

    Figure 4 Confirming dialog box

  5. View the upgrade result on the Instances page.

    • When the upgrade is ongoing, the instance status is Upgrading minor version.
    • After the upgrade is complete, the instance status changes Available.

Parent topic: Instance Modifications