tencent cloud


Upgrading Proxy

Last updated: 2022-07-06 15:44:23


    Minor versions of the TencentDB for Redis proxy are released from time to time to add more database features or fix known bugs.

    Proxy VersionProxy Minor VersionNew Feature, Optimization, or Fix
    Proxy 5.0 5.6.0Supported SSL encryption to implement encrypted data transfer.
    • Supported the "Read Local Nodes Only" feature.
    • Supported the `dbsize` command in Cluster Edition instances to return the number of keys in all shards.
    • Supported displaying the client port information in slow logs.
    • Supported `flushall` and `flushdb` commands, which can be distributed to the master node of all shards in a Cluster Architecture instance while retaining data in nodes with the specified `nodeid`.
    • Supported monitoring the number of big value requests.
    • Supported the `Scan` command in Cluster Edition instances to traverse all shards.
    • Fixed the issue where "ERR unknown command 'select' command" might be returned when the `select` command was executed after a transaction.
    • Fixed the issue where the command was sent to an incorrect node and the `Move` error was reported when the locked connection wasn't released in time as the `watch+` transaction was used in the pipeline scenario.
    5.4.0Optimized the statistics collection policies of P99 monitoring metrics, including metrics for all Redis commands.
    5.2.0Supported the five-second granularity for monitoring data.
    • Supported the `keys` command in Cluster Architecture instances.
    • Supported displaying the client address in slow logs.
    • Fixed the "ERR MULTI calls can not be nested" error.
    5.0.0Supported `unlink` and `exists` commands in Cluster Architecture instances.
    Proxy 4.0 3.5.0Supported the command analysis feature. You can view information such as QPS, P99 execution latency, average execution latency, and max execution latency of individual commands.
    3.3.0Supported the five-second granularity for system monitoring data collection.
  • Supported displaying the client address in slow logs.
  • Fixed the "ERR MULTI calls can not be nested" error.
  • Notes on Upgrade

    • The system automatically detects the minor version of the proxy. If the Upgrade Proxy button is grayed out, the instance proxy is already on the latest minor version.
    • As the version release time varies by region, the minor version release status is as displayed in the console.

    Impact of Upgrade

    The version upgrade process mainly consists of data sync and instance switch:

    • During data sync, the service will not be affected.
    • During switch, the instances will become read-only for less than one minute (to wait for the data sync completion), and a momentary disconnection (within seconds) will occur; therefore, your business should have an automatic reconnection mechanism.

    Preparations for Upgrade

    • The instance to be upgraded is in Running status and is not executing any tasks.
    • We recommend you perform upgrade in the maintenance time during off-peak hours.

    Upgrade Directions

    1. Log in to the TencentDB for Redis console.
    2. Above the instance list on the right, select the region.
    3. In the instance list, find the target instance.
    4. Click the instance ID to enter the Instance Details page.
    5. In the Specs Info section on the Instance Details page, click Upgrade Proxy after Proxy Version.
    6. In the pop-up window, confirm the information of the target instance based on the following table, configure the target version, and click OK.
      Instance IDID of the instance to be upgraded.
      Current VersionCurrent minor version of the proxy.
      Target VersionTarget version after proxy upgrade. The target version cannot be selected.
      Switch Time
      • Switch Now: The switch will be performed when the data sync is almost completed (the data left to be synced is less than 10 MB).
      • Switch in Maintenance Time: The switch will be performed during the instance maintenance time. If the switch conditions cannot be met in the current maintenance time, the switch will be attempted in the next maintenance time. You can modify the Maintenance Time on the instance details page.
    7. Return to the instance list. After the Instance Status changes to Running, you can see that the instance version has been upgraded in the instance list or instance details.
    API Description
    UpgradeProxyVersion Upgrades proxy version
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support