Help Center/ Distributed Cache Service/ User Guide/ Changing an Instance/ Upgrading Minor or Proxy Versions of a DCS Instance
Updated on 2025-09-02 GMT+08:00

Upgrading Minor or Proxy Versions of a DCS Instance

DCS optimizes functions and fixes vulnerabilities in minor and proxy upgrades. This section describes how to upgrade the minor or proxy version of an instance.

Upgrading the minor or proxy version does not affect the instance connection addresses, password, whitelist, or monitoring and alarms.

Currently, this function is in restricted use. To enable it, submit a ticket and contact customer service.

Notes and Constraints

  • This function is available only for DCS Redis 4.0 or later basic edition instances.
  • Only Proxy Cluster and read/write splitting instances involve proxy versions.
  • If the minor or proxy version of the instance is already the latest, you cannot upgrade it.
  • To upgrade the minor version of a Redis Cluster instance, ensure that the client can properly process the MOVED and ASK commands. Otherwise, requests will fail.
  • Self-help rollback is unavailable.

Impacts

  • Perform instance upgrades during off-peak hours. Otherwise, upgrades may fail when the instance memory or CPU usage exceeds 90% or write traffic nears bandwidth. In such cases, try again during off-peak hours.
  • The instance's minor version is upgraded by migrating nodes. During the migration, latency will increase. A migrating shard will become read-only for 1 minute and intermittently disconnected. Ensure that the client can reconnect and handle exceptions.
  • The upgrading instance will be intermittently disconnected. Ensure that the client can reconnect and handle exceptions. Perform the upgrade during off-peak hours.

Upgrading Minor or Proxy Versions of a DCS Instance

  1. Log in to the DCS console.
  2. Click in the upper left corner of the console and select the region where your instance is located.
  3. In the navigation pane, choose Cache Manager.
  4. Click a DCS instance.
  5. On the Basic Information page, you can view or upgrade the minor or proxy versions of the instance.

    Figure 1 Upgrading an instance's minor or proxy version
    • Upgrading a minor version
      1. Click Upgrade next to Minor Version.

        Also, to upgrade the proxy version, enable Upgrade Proxy Version in the displayed window.

      2. Click OK. The upgrade is complete when the upgrade task is in the Successful state.
    • Upgrading a proxy version
      1. Click Upgrade next to Proxy Version.

        Also, to upgrade the minor version, enable Upgrade Minor Version in the displayed window.

      2. Click OK. The upgrade is complete when the upgrade task is in the Successful state.

Related Documents