Release Notes
Product Announcements
Upgrading Kernel Minor Version
TDSQL-C for MySQL will release new database kernel minor versions successively. By upgrading the database kernel minor version, your database instance can gain performance enhancements, enhanced security, new feature support, compatibility improvements, and error fixes. This document shows you the operations and instructions for upgrading the database kernel minor version through the console.
Note:
For details on the features of each database kernel minor version, see Kernel Version Release Notes.
Overview
When the system releases a new database kernel minor version, or the current database kernel minor version of your cluster is outdated and needs to be upgraded to a new database kernel minor version, you can manually upgrade it through the console.
Note:
If a bug occurs in the background program or the system detects a security risk, the system will push upgrade notifications via the message center and SMS. TDSQL-C for MySQL will perform the system upgrade and repair at the specified time.
When operations that trigger cluster migration occur (such as cluster specification scaling, disk capacity scaling, and database version upgrade), the system will not automatically upgrade your cluster to the latest kernel minor version. If an upgrade is required, you can upgrade it manually.
Upgrade Rules
To ensure data replication consistency, the kernel minor versions of all associated instances (read-write and read-only instances) in the cluster whose database kernel minor version is to be upgraded will be upgraded together.
Upgrading the minor version of the database kernel will pull up additional computing nodes for upgrade, does not involve data migration, and can achieve second-level upgrades.
Precautions
During the minor version upgrade phase of the database kernel, there is a momentary disruption lasting only seconds. It is advisable to schedule the switch during maintenance hours or periods of low business activity to minimize impact on operations.
If the number of tables in a single instance exceeds one million, upgrade may fail and database monitoring may be affected. Please regulate the number of tables reasonably and control the number of tables in a single instance not to exceed one million.
The kernel minor version cannot be downgraded once upgraded.
Description of the Four-digit Minor Version Number
The database kernel minor versions of TDSQL-C for MySQL now support four-digit minor version numbers. The version number has been updated from three digits to four digits, which can avoid passive upgrades and ensure stable operation of instances during version updates. Meanwhile, within a major version (such as a three-digit major version like 3.1.15), the system can release multiple minor versions with new capabilities to help you better experience the new capabilities of the product.
The description of each digit in the four-digit minor version number is shown in the figure below.
TDSQL-C for MySQL provides two options for kernel minor version upgrades. You can select one as needed.
Stable version: version that is stable and has undergone long-time testing, with an update frequency of 3 to 4 months. Currently, all versions with the major version 3.1.16 are stable versions, such as 3.1.16.001, 3.1.16.002, and 3.1.16.003.
New-feature version: version with new features, which is the currently general kernel minor version.
Note: It is recommended that you select the "new-feature version" and maintain periodic upgrades for upgrading the kernel minor version.
Upgrading the Kernel Minor Version
1. Log in to the TDSQL-C for MySQL Console.
2. On the cluster list page, proceed based on the view mode you actually use to go to the database kernel minor version upgrade window.
1. In the cluster list on the left, click the target cluster to go to the cluster management page.
2. On the cluster management page, after the database version, click Details/Upgrade.
1. In the cluster list, find the target cluster and click the cluster ID or Manage in the Operation column to go to the cluster details page.
2. On the cluster details page, under Configuration Info > Database Version , click Details/Upgrade.
3. In the pop-up sidebar, click Upgrade Cluster Now.
4. In the pop-up window, select the switch time and the target kernel minor version to be upgraded, check "I have read and agreed to Database Version Upgrade", and click OK.
Switch Time
During maintenance time: After the upgrade is completed, the switch will be performed within the instance maintenance time. For more information on modifying the maintenance window, see Set Instance Maintenance Time.
Upon upgrade completion: The switch will be triggered immediately after the upgrade is completed.
Kernel Minor Version
New-Feature Version：Version with new features, which is the currently general kernel minor version. Select the desired version under the New-Feature Version.
Stable Version：Version that is stable and has undergone long-time testing, with an update frequency of 3 to 4 months. Select the desired version under the Stable Version.
5. If you want to know the progress of the upgrade task, you can go to the Task List for inquiries.
6. The upgrade is completed when the instance running status is updated to "Running".
Related APIs
API | Description |
This API (UpgradeClusterVersion) is used to upgrade the kernel minor version. |
Help and Support
Was this page helpful?
You can also Contact sales or Submit a Ticket for help.
Help us improve! Rate your documentation experience in 5 mins.
Feedback