All Products
Search
Document Center

ApsaraDB RDS:Upgrade the database proxy kernel version

Last Updated:Jun 09, 2026

ApsaraDB RDS for MySQL upgrades the database proxy version at irregular intervals. You can view the release notes for the database proxy version of ApsaraDB RDS for MySQL and determine whether to upgrade the database proxy version based on your business requirements. This topic describes how to upgrade the database proxy version of an ApsaraDB RDS for MySQL instance in the ApsaraDB RDS console or by calling an API operation.

For more information about the database proxy version, see Release notes for the database proxy version.

Prerequisites

The database proxy feature is enabled. For more information, see Enable the database proxy feature.

Usage notes

  • When you upgrade the database proxy version of your RDS instance, new sessions are connected to the database proxy of the new version to reduce the impacts on your workloads.

    • Active sessions on the database proxy of the original version are retained for 8 hours. The database proxy of the original version is automatically disconnected within the first maintenance window.

    • When the database proxy of the original version is disconnected, existing connections on the database proxy are immediately terminated. Make sure that your application is configured to automatically reconnect to your database system.

  • If you upgrade the database proxy version multiple times within a short period of time, the system retains only the sessions on the database proxy before the most recent upgrade.

  • We recommend that you perform the upgrade during off-peak hours. Make sure that your application can automatically reconnect to your RDS instance.

Procedure

  1. Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.

  2. In the left-side navigation pane, click Database Proxy.

  3. In the Basic Information section, click Upgrade next to Proxy Version.

  4. In the dialog box that appears, select an Update Time and click OK.

    Note
    • For Upgrade Now, you can select Upgrade Now or Within Maintenance Window. For more information about maintenance windows, see Set a maintenance window.

    • If you set Update Time to Within Maintenance Window and click OK, the RDS instance generates an upgrade plan based on the current maintenance window. The generated upgrade plan is not affected by subsequent changes to the maintenance window.

References

Related operations

Operation

Description

UpgradeDBProxyInstanceKernelVersion

Upgrades the database proxy version.