ApsaraDB for Redis supports manual hot upgrades of proxy nodes. After you upgrade proxy nodes, you can use the latest features. For example, you can view the audit logs of proxy nodes. This topic describes how to upgrade proxy nodes.


The instance is a cluster or read/write splitting instance.

View the minor version of proxy nodes

You can view the minor version of proxy nodes in the ApsaraDB for Redis console. For more information, see Update the minor version.

Figure 1. View the minor version of proxy nodes
View the minor version of proxy nodes
Note For more information about the detailed release notes of minor versions, see ApsaraDB for Redis proxy nodes.


  • Proxy nodes support hot upgrades. Proxy nodes of the new version can restore a connection based on the client connection information of proxy nodes of the earlier version. This ensures that upgrades do not interrupt services. However, a millisecond-level latency jitter may occur during the upgrades.
  • The hot upgrades are valid only for normal connections. The execution of the block, transaction, Pub, and Sub commands is interrupted during hot upgrades. Make sure that these commands support the reconnection mechanism.
  • If a Redis client uses a private endpoint to connect to the ApsaraDB for Redis instance, no commands are affected by a proxy upgrade.
Note For more information about proxy endpoints and private endpoints, see Proxy mode and Direct connection mode.


Warning This operation may cause transient connections. We recommend that you perform this operation during off-peak hours and make sure that your application is configured to automatically reconnect to your instance.
  1. Log on to the ApsaraDB for Redis console and go to the Instances page. In the top navigation bar, select the region in which the instance that you want to manage resides. Then, find the instance and click its ID.
  2. In the left-side navigation pane, click Service Availability.
  3. In the Proxy Servers section, click Upgrade Proxy.
    Click Upgrade Proxy
    Note All proxy nodes are upgraded at the same time. You cannot separately upgrade specified proxy nodes.
  4. In the panel that appears, select the time when you want the upgrade to take effect.
    • Immediate: immediately upgrades proxy nodes.
    • Maintenance Window: upgrades proxy nodes within the specified maintenance window. For more information about how to modify the maintenance window of an instance, see Set a maintenance window.
  5. Click OK.