Upgrading Kernel Minor Version of Database Proxy
Last updated:2026-01-06 12:11:47
This document describes how to manually upgrade the kernel minor version of the database proxy in the console.
Prerequisite
Notes
There will be a momentary disconnection when you upgrade the kernel minor version of the database proxy. Therefore, upgrade the version during off-peak hours and make sure that your application has an automatic reconnection mechanism.
If the upgrade fails, the reason may be that the kernel minor version of the database is earlier than 20211031. You need to upgrade the kernel minor version of the database before upgrading the kernel version of the database proxy. For more information, see Upgrading Kernel Minor Version.
Versions 1.0, 1.1, and 1.2 of the database proxy kernel are legacy releases that are no longer maintained or updated. These versions may contain known issues and vulnerabilities, and are not recommended for production use. It is recommended to upgrade to version 1.3.1 or later.
Note：
In database proxy kernel versions 1.0 and 1.1, read-only instances with a weight of 0 will not establish connections. In versions 1.2 and later, they will establish connections. It is recommended to check the read-write separation settings after the version is upgraded. For instances that do not participate in read-write separation, disable them in the console rather than setting the weight to 0.
Definition Description of the Database Proxy Kernel Version
Preview version: the latest version of the database proxy, which typically includes new features, but may have unknown bugs. It is released primarily for users to experience the latest features.
Stable version: a tested and verified database proxy version, typically used in production environments. It offers greater reliability than the preview version but may not include the latest features.
Outdated version: older database proxy versions that are no longer maintained or updated. Outdated versions may have known issues and vulnerabilities and are not recommended for production use.
Directions
1. Log in to the TencentDB for MySQL console. Select the region at the top and click the target instance ID to enter the instance management page.
2. On the instance management page, select the Database Proxy tab.
3. In Overview > Basic Info > Proxy Version on the Database Proxy tab, click Upgrade Kernel Minor Version.
4. In the pop-up window, check the target version and select the upgrade switch time. After confirming that everything is correct, click OK.
Switch Time:
During maintenance time: The upgrade will be performed during the maintenance time, which can be modified on the instance details page.
Upon upgrade completion: The upgrade will be performed immediately after the upgrade operation is confirmed.
Note:
After a version upgrade, rolling back to an earlier version is not supported.
There will be a momentary disconnection during upgrade. Therefore, make sure that your business has a reconnection mechanism.
Except for abnormal nodes, all nodes are upgraded at the same time by default during the kernel minor version upgrade.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback