All Products
Search
Document Center

PolarDB:Perform a temporary cluster upgrade

Last Updated:Mar 11, 2024

You can temporarily upgrade the specifications of a cluster or a single node in the cluster. When the specified rollback time is reached, the cluster is automatically rolled back to the original specifications. You can temporarily upgrade the specifications of a PolarDB subscription cluster to meet business requirements during peak hours.

Prerequisites

  • Your cluster is a subscription cluster.

  • Your cluster does not have pending renewal, upgrade, downgrade, or temporary upgrade orders.

  • The edition of the PolarDB for MySQL cluster is Cluster Edition, Multi-master Cluster (Database/Table) Edition, or X-Engine Edition. Single Node Edition is not supported. For more information about cluster editions, see Overview.

Usage notes

  • PolarDB clusters do not support temporary downgrades.

  • When PolarDB temporarily scales up or back a cluster, transient connections to the cluster may occur. Make sure that your application is configured with the automatic reconnection mechanism.

  • The rollback time must be at least one day before the expiration date of the cluster. For example, if a cluster expires on January 10, the restoration time must be on January 9 at latest.

  • If a cluster is temporarily upgraded, you cannot add nodes to the cluster or remove nodes from the cluster. In addition, the cluster does not support automatic scaling. For more information about how to add or remove node, see Add or remove read-only nodes. If you want to perform manual horizontal scaling or use automatic scaling when the temporary upgrade is still effective, you must permanently upgrade the cluster. For more information, see Permanently retain the temporarily upgraded specifications.

  • When the temporary upgrade remains effective (the cluster is in the running state), you can perform manual upgrades. For more information about how to manually upgrade a cluster, see Manually upgrade or downgrade a PolarDB cluster.

  • The earliest scale-back time that you can specify is 1 hour after the cluster is upgraded. We recommend that you set the validity period of a temporary upgrade to no more than 14 days.

  • After you perform a temporary upgrade, if the cluster still does not meet your business requirements or you want to extend validity period of the temporary upgrade, you can perform another temporary upgrade before the first temporary upgrade is rolled back. The rollback time of the second temporary upgrade must not be earlier than that of the first temporary upgrade.

Permanently retain the temporarily upgraded specifications

If you want to retain the specifications used for the temporary upgrade, you can perform a manual upgrade when the temporary upgrade is still effective (the cluster is in the running state). In this case, the cluster is not scaled back to the original specifications when the scale-back time is reached. To perform a manual upgrade, choose Upgrade in the Change Configurations dialog box. For more information, see Manually upgrade or downgrade a PolarDB cluster.

Note

This operation does not affect your business.

Select different specifications for the primary node and read-only nodes

For a PolarDB cluster, you can perform separate temporary upgrades for the primary node and read-only nodes. This means that you can select different specifications for the primary node and read-only nodes.

Limits

  • In a cluster, at least one read-only node must have the same specifications as the primary node.

  • We recommend that you select similar specifications for the primary node and read-only nodes:

    • The memory of a read-only node cannot be less than half of the memory of the primary node.

    • The following table lists the correspondence of CPU specifications for the primary node and read-only nodes.

      CPU cores for primary node

      Minimum CPU cores for read-only node

      2

      2

      4

      4

      8

      4

      16

      8

      32

      16

      64

      32

      88

      32

  • Read-only nodes must be of the same specifications as the primary node if hot standby nodes are configured.

  • We recommend that you specify higher specifications for read-only column store nodes than the primary node. For more information, see Add a read-only column store node.

Note

PolarDB Multi-master Cluster (Database/Table) Edition is not subject to the preceding limits.

Billing

A temporary upgrade fee is 1.5 times the price difference between the original and new specifications. For example, the validity period of a temporary upgrade is N days. You can calculate the temporary upgrade fee by using the following formula:

Temporary upgrade fee = (Monthly subscription fee for the new specifications - Monthly subscription fee for the original specifications)/30 × 1.5 × N

Procedure

  1. Log on to the PolarDB console.

  2. In the top navigation bar, select the region in which the cluster that you want to manage is deployed.

  3. On the Clusters page, find the cluster on which you want to perform a temporary upgrade.

  4. Open the Change Configurations (Subscription) dialog box by using one of the following two methods:

    • Find the cluster on which you want to perform a temporary upgrade, and click Change Configurations in the Actions column.集群列表

      1. Find the cluster on which you want to perform a temporary upgrade and click the cluster ID to go to the Basic Information page.

      2. In the Database Nodes section, click Change Configurations.临时升配

  5. On the Change Configurations (Subscription) page, select Temporary Upgrade and click OK.

    Note

    Temporary Upgrade is available only for subscription clusters.

  6. In the dialog box that appears, configure parameters described in the following table.

    Parameter

    Description

    Resource Type

    The new category of the cluster. Valid values: General Specification and Dedicated Specification.

    Node

    The new node specifications that you want to use.

    Note

    Make sure that at least one read-only node has the same specifications as the primary node.

    PolarProxy Type

    The new PolarProxy type of the cluster. Valid values: Standard Enterprise and Dedicated Enterprise.

    • Standard Enterprise: This value is used when Resource Type is set to General Specification.

    • Dedicated Enterprise: This value is used when Resource Type is set to Dedicated Specification.

    Restore Time

    The time when the temporary upgrade expires. When the time is reached, the cluster is restored to the original specifications.

    Note
    • After you perform a temporary upgrade, if the cluster still does not meet your business requirements or you want to extend the validity period of the temporary upgrade, you can perform another temporary upgrade before the first temporary upgrade is rolled back. The scale-back time of the second temporary upgrade must not be earlier than that of the first temporary upgrade.

    • The minimum validity period for a temporary upgrade is one hour. We recommend that you set the validity period to up to 14 days. It is because the restoration time cannot be changed after it is specified.

    • The rollback time must be at least one day before the expiration date of the cluster.

  7. Read and select the Terms of Service, click Buy Now, and then complete the payment.

  8. On the Purchase page, confirm the order information and click Subscribe.