ApsaraDB RDS for MySQL releases database proxy updates at irregular intervals. Check the release notes to decide whether to upgrade 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 the full version history, see Release notes for the database proxy version.
Prerequisites
Before you begin, ensure that you have:
The database proxy feature enabled on your RDS instance. For more information, see Enable the database proxy feature.
Usage notes
During an upgrade, new sessions connect to the new proxy version immediately. This minimizes the impact on your workloads.
Active sessions on the original proxy version are retained for 8 hours. The original proxy is then disconnected within the first maintenance window.
When the original proxy disconnects, all existing connections on it are terminated immediately. Make sure your application is configured to reconnect automatically.
If you run multiple upgrades in quick succession, the system retains only the sessions from before the most recent upgrade.
Schedule the upgrade during off-peak hours. Confirm that your application reconnects automatically before proceeding.
Upgrade the database proxy version
Go to the Instances page. In the top navigation bar, select the region where your RDS instance resides. Find the instance and click its ID.
In the left-side navigation pane, click Database Proxy.
In the Basic Information section, click Upgrade to the right of Proxy Version.
If the database proxy is already on the latest version, the Upgrade button is not displayed.
In the dialog box, set the Upgrade Time parameter and click OK.
- Upgrade Now: Starts the upgrade immediately. - Upgrade Within Maintenance Window: The instance generates an upgrade plan based on the current maintenance window. If you modify the maintenance window later, the existing upgrade plan is not affected. For more information about maintenance windows, see Configure a maintenance window.
API reference
| Operation | Description |
|---|---|
| UpgradeDBProxyInstanceKernelVersion | Upgrades the database proxy version. |