PolarDB:Upgrade an Archive Database Single Node Edition to an Archive Database Cluster Edition

How it works

When you trigger the upgrade, PolarDB performs the following steps automatically:

1. Converts the cluster architecture from single-node to multi-node (Cluster Edition).

2. Restarts all nodes in the cluster. In most cases, the restart takes 3–5 minutes, depending on the volume of redo logs accumulated before the upgrade. In rare cases, it can take up to 30 minutes.

3. Keeps all nodes on the primary endpoint after the restart completes.

Your cluster is unavailable during the restart. Plan the upgrade during off-peak hours to minimize business impact.

Constraints

• After the upgrade, all nodes continue to use the primary endpoint. To use a cluster endpoint, configure it manually.

• To scale capacity after the upgrade, add read-only nodes. Existing nodes are not restarted when you add nodes. Adding and removing nodes follows the same process as Cluster Edition. For details, see Add or remove read-only nodes.

Prerequisites

Before you begin, ensure that you have:

• An existing Archive Database Standalone Edition cluster

• Access to the PolarDB console

Upgrade the cluster

1. Log on to the PolarDB console.

2. In the upper-left corner, select the region where your cluster is deployed.

3. Open the Change Configurations dialog box using either of the following methods:

   • Method 1: On the Clusters page, find the cluster and click Upgrade to Archive Database Cluster Edition in the Actions column.

   • Method 2: On the Clusters page, click the cluster ID. On the Basic Information page, go to the Database Nodes section and click Upgrade to Archive Database Cluster Edition.

4. In the Change Configurations dialog box, click + Add a read-only node to add at least one read-only node. To add multiple nodes at once, click + Add a read-only node again for each additional node.

5. Set Switching Time:

   • Switch Now: The upgrade starts immediately after purchase.

   • Switch At: Specify a point in time within the next 24 hours. Nodes are added within 30 minutes after the specified time. To view or cancel the scheduled task, go to the Scheduled Tasks page. For details, see View or cancel a scheduled task.

   Note

   To minimize business impact, use Switch At to schedule the upgrade during off-peak hours.

6. Read and accept the terms of service, then click Buy Now.

7. On the Purchase page, confirm the order and click Purchase.

What to do next

After the upgrade completes:

• Add or remove read-only nodes to scale your cluster.

• Configure a cluster endpoint if your application needs to distribute reads across nodes. For more information about Archive Database Cluster Edition, see X-Engine Edition.