Help Center/ GeminiDB/ GeminiDB Redis API/ Working with GeminiDB Redis API/ Modifying Instance Settings/ Upgrading a Minor Version
Updated on 2025-07-29 GMT+08:00
View PDF
Share

Upgrading a Minor Version

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

After a new patch version involving performance improvement, new functions, or problem rectification is released, you can upgrade your instance to the latest version at a proper time based on service requirements.

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 is a new patch released.
  • If the database version is a risky version, the system prompts you to upgrade the database patch.
  • Upgrading the minor version of an instance will restart each node of the instance in sequence. When a node is being restarted, its services will be taken over by another node. Each takeover will interrupt services for 3 to 5 seconds. So, perform an upgrade during off-peak hours and enable automatic reconnection so that each node can be reconnected immediately after being restarted.
  • Upgrading basic components takes about 15 minutes. The duration of upgrading data components depends on the number of nodes. The upgrade of each node takes about 1 to 2 minutes.
  • The system automatically checks the minor version of the instance. If the Upgrade Minor Version button does not exist on the console, the current minor version is the latest version.
  • After GeminiDB Redis API is upgraded, the compatible Redis version may be upgraded too. For example, after upgrade, Redis 5.0 is compatible with 6.2. A later version is compatible with earlier versions. After upgrade, the service usage remains unchanged, and Redis 6.2 commands are supported.
  • Services are unavailable during the parallel upgrade. You are advised to perform the parallel upgrade during off-peak hours. The parallel upgrade takes about 17 to 20 minutes, regardless of the number of nodes.

Procedure

  1. Log in to the Huawei Cloud 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 Specification Information area, click Upgrade Minor Version in the Compatible API field.

    Figure 3 Patch installation

  4. In the displayed dialog box, click OK.

    • You can upgrade nodes one by one or all at once.
    • You can select Immediate or During maintenance window for Scheduled Time. If During maintenance window is selected, the scheduled upgrade task will be executed in the next time window.
      Figure 4 Confirming information

  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 to Available.

Parent Topic: Modifying Instance Settings