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

Upgrading a Minor Version

You can install patches for GeminiDB Redis instances to improve performance, add functions, or fix bugs.

If a new patch is released, you can click Upgrade Minor Version 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. A later version is compatible with earlier versions. For example, after Redis 5.0 is upgraded to 7.0, the service usage remains unchanged, and Redis 7.0 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.

Open-source Redis has multiple major versions. Generally, existing instances cannot be directly upgraded to a later version. GeminiDB Redis API has only one major version, so you can upgrade an instance to the latest stable minor version. Bugs have been fixed and new functions are added. The new version is fully compatible with earlier versions. Services do not need to be adjusted. In addition, the new version is compatible with Redis 6.0, 7.0, and later versions, providing more functions and better O&M experience.

Procedure

  1. Log in to the GeminiDB console.
  2. 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

  3. 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

  4. 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