This topic describes how to upgrade a Standard Edition instance to Enterprise Edition.
Background
As business grows, users of PolarDB-X Standard Edition may encounter the bottlenecks typical of single-node databases. These issues can include poor query performance on large tables, high database load from concurrent queries, and an inability to meet analytical demands. At this stage, vertically scaling the database is often insufficient and not cost-effective.
PolarDB-X lets you upgrade a Standard Edition instance to an Enterprise Edition instance. The upgrade leverages distributed features and Hybrid Transactional/Analytical Processing (HTAP) to resolve the limitations of a single-node database while maintaining a user experience similar to a standalone MySQL database.
Prerequisites
-
The PolarDB-X Standard Edition instance must be upgraded to the latest kernel version.
-
If the PolarDB-X Standard Edition instance has a public endpoint, you must first release the public endpoint.
-
During the upgrade, the data node specifications for the Enterprise Edition instance must match those of the current Standard Edition instance. If you want to increase the data node specifications for the Enterprise Edition instance, you must first upgrade the specifications of the Standard Edition instance.
Pre-upgrade check
-
Log on to the PolarDB-X console.
-
In the top navigation bar, select the region where the instance is deployed.
-
On the Instances page, click the PolarDB-X 2.0 tab.
-
Find the instance that you want to manage and click its ID.
-
In the Upgrade to Enterprise Edition section, click Upgrade to Enterprise Edition.
-
Before the upgrade, you must run a pre-check. In the background, a temporary Enterprise Edition instance is created that shares the data node with the Standard Edition instance. Click Start Check. The following items are checked:
Check item
Description
Pass criterion
Account
Checks whether accounts can be imported.
Database accounts on the Standard Edition instance can be successfully imported into the temporary Enterprise Edition instance.
Whitelist
Checks whether whitelists can be imported.
Whitelists on the Standard Edition instance can be successfully imported into the temporary Enterprise Edition instance.
XA transaction
Checks for the existence of XA transactions.
Enterprise Edition instances do not support XA transaction-related commands. The check runs the
XA RECOVERcommand on the Standard Edition instance to verify that no active XA transactions exist.Number of databases
Checks if the number of databases exceeds the limit for Enterprise Edition.
The number of business databases on the Standard Edition instance must not exceed the logical database limit of Enterprise Edition. If this check fails, contact us.
Stored procedure or custom function
Checks for user-created stored procedures or custom functions.
No user-created stored procedures or custom functions exist.
Endpoint
Checks if there is only one endpoint.
Only one VPC endpoint exists.
Read-only instance
Checks for the existence of read-only instances.
No read-only instances exist.
Isolation level
Checks if the isolation level is supported by Enterprise Edition.
The isolation level is supported by Enterprise Edition.
-
Click OK. PolarDB-X initiates an upgrade check task. You can click the
task icon in the upper-right corner to view the task progress.After the check task is complete, view the results in the Upgrade to Enterprise Edition dialog box.
Upgrade to Enterprise Edition
Procedure
-
In the Upgrade to Enterprise Edition dialog box, click Start Upgrade.
-
On the upgrade configuration page, select the compute node specifications and the number of compute nodes.
-
Click Buy Now.
-
Click Sign and Purchase.
-
On the instance basic information page, click the
icon in the upper-right corner to open the task list and view the task progress.The task list displays columns for Task name, Task progress, State, Start time, and Operation. In the Operation column, you can click Switchover or Cancel.
-
After the task state changes to Metadata Imported, click Switchover to direct traffic to the Enterprise Edition instance.
ImportantThe switchover operation triggers a restart, during which the service is unavailable for several minutes.
-
Click Cleanup. This operation cleans up residual metadata and completes the upgrade process.
After the upgrade is complete, wait a few minutes. On the Instances page, the instance edition changes to Enterprise Edition. Click the instance ID to go to the details page of the Enterprise Edition instance.
ImportantThe cleanup operation removes resources related to the Standard Edition instance. This action cannot be rolled back.
Operations
During the upgrade from Standard Edition to Enterprise Edition, you can view the task status and perform the following operations from the task list:
|
Actions |
Description |
|
Switchover |
A required operation to complete the upgrade. It performs the following actions:
|
|
Cleanup |
A required operation to complete the upgrade. It cleans up residual metadata from the Standard Edition instance. |
|
Switchback |
Use this operation to roll back after a switchover. It performs the following actions:
|
|
Cancel |
Terminates the upgrade process. The order will be refunded. |