All Products
Search
Document Center

Tair:Change the configurations of an instance

Last Updated:Feb 23, 2024

Tair allows you to change the configurations of instances. You can change configurations such as the architecture and specifications of an instance to meet different performance and capacity requirements.

Billing

If you change the configurations of a pay-as-you-go instance, you are charged based on the new specifications after the change. If you change the configurations of a subscription instance, you are charged or are refunded the difference in cost based on whether you upgrade or downgrade the configurations.

For more information about the billing rules for configuration changes and the refund for configuration downgrade, see Configuration change.

Change process

Local disk-based instances and cloud disk-based standard instances

After you submit a configuration change request, the status of the instance immediately changes to Changing Configuration. Tair creates a new instance and automatically synchronizes data from the original instance to the new instance. After data synchronization is complete, Tair switches business to the new instance at the specified switchover time. During the switchover, the instance may experience one or two transient connections that each lasts up to 30 seconds. After the switchover is complete, the instance is in the Running state and the configuration change is complete.

image

Cloud disk-based cluster instances

After you submit a request to change the shard specifications, the status of the instance immediately changes to Changing Configuration. Tair evaluates the resources first. If sufficient resources are available, the shard specifications are changed without impacts on your business. If resources are insufficient, a new node that has the specified specifications is created, and data is synchronized to the new node. Business is switched to the new node at the specified switchover time. The nodes involved in the switchover may experience transient connections.

image

Impacts of configuration changes

Local disk-based instances and cloud disk-based standard instances

  • When you change the configurations of an instance, the instance may experience one or two transient connections that each lasts up to 30 seconds.

  • To synchronize incremental data from the original instance to the new instance and prevent dual writes caused by the Domain Name System (DNS) cache, the instance becomes read-only for up to 1 minute during the configuration change.

  • To ensure higher performance and stability, the system updates the minor version of the instance to the latest version during the configuration change.

  • If you change the architecture of an instance, the following impacts may occur:

Cloud disk-based cluster instances

If you change the specifications of a shard, a master-replica switchover may occur. During the switchover, the shard may experience a transient connection.

Limits

Limits on instance configuration changes

  • Local disk-based instances

    If a private endpoint is allocated to a cluster instance and you want to change the shard configurations of the instance, you can adjust either the shard specifications or the number of shards. For more information, see Why am I unable to change the configurations of a classic (local disk-based) cluster instance?

  • You can increase the storage capacity of ESSD-based instances in increments of at least 10 GB. However, you cannot decrease the storage capacity of ESSD-based instances.

  • Child instances in a distributed instance

    • You cannot change the architecture of a child instance. For example, you cannot change the architecture from cluster to standard.

    • All child instances in a distributed instance must have the same configurations. Otherwise, performance or capacity issues may occur.

    • When you change the configurations of a cluster instance, you can adjust either the shard specifications or the number of shards. For more information, see Why am I unable to change the configurations of a classic (local disk-based) cluster instance?

Feature matrix for configuration changes

The configuration change options that are supported on the Change Configurations page (Upgrade or Downgrade page for subscription instances) vary based on the deployment method and architecture.

The following list describes the symbols that are used in the following tables:

  • ✔️ indicates that you can perform operations on the Change Configurations page.

  • ⭕️ indicates that you cannot perform operations on the Change Configurations page. For specific operation methods, see the note below the table.

  • ❌ indicates that this type of configuration change is not supported.

  • ➖ indicates that this type of configuration change is not involved.

Deployment type/Change option

Switch to the cluster architecture

Switch to the read/write splitting architecture

Switch to the standard architecture

Change shard specifications

Change the number of shards

Change the number of read replicas

Classic deployment

✔️

✔️

✔️

✔️

✔️

✔️

Cloud-native standard architecture

✔️

⭕️1

✔️

Cloud-native cluster architecture

⭕️2

✔️3

✔️

⭕️4

Cloud-native read/write splitting architecture

⭕️5

⭕️6

✔️

⭕️7

Note

1To change the architecture of an instance from the cloud-native standard architecture to the read/write splitting architecture, enable read/write splitting for the instance on the Read/Write Splitting Settings page. For more information, see Enable read/write splitting.

2To change the architecture of an instance from the cloud-native cluster architecture to the read/write splitting architecture, change the instance to a standard instance, and then enable read/write splitting for the instance on the Read/Write Splitting Settings page.

3To change the architecture of an instance from the cloud-native cluster architecture to the standard architecture, the instance must run in proxy mode. The direct connection mode is not supported.

4To change the number of shards for a cloud-native cluster instance, add or remove shards. For more information, see Adjust the number of data shards for an instance.

5To change the architecture of an instance from the cloud-native read/write splitting architecture to the cluster architecture, disable read/write splitting and then change the architecture on the Change Configurations page.

6To change the architecture of an instance from the cloud-native read/write splitting architecture to the standard architecture, disable read/write splitting on the Read/Write Splitting Settings page. For more information, see Enable read/write splitting.

7To change the number of read replicas for a cloud-native read/write splitting instance, increase or decrease the number of read replicas on the Read/Write Splitting Settings page. For more information, see Enable read/write splitting.

Procedure

  1. Log on to the Tair console and go to the Instances page. In the top navigation bar, select the region in which the instance that you want to manage resides. Then, find the instance and click the instance ID.

  2. For a pay-as-you-go instance, click Change Configurations in the upper-right corner of the page. For a subscription instance, click Upgrade in the upper-right corner of the page.

  3. On the Upgrade/Downgrade page, make required configuration changes and click Buy Now.

    Important

    When you change the configurations of an instance, we recommend that you set the Switching Time parameter to Switch Within Maintenance Window. In this case, the instance configurations are changed in the next maintenance window. For more information, see Set a maintenance window.

  4. Complete the payment.

FAQ

What causes a configuration change to fail?

  • If large keys exist in the original instance, the configuration change may fail.

    In this case, we recommend that you identify and delete large keys from the instance before you change the configurations. For more information about how to identify large keys, see Use the offline key analysis feature .

  • When you downgrade the configurations of an instance, take note that 80% of the memory capacity of the new instance must be greater than the amount of occupied memory in the original instance. Otherwise, the instance cannot be downgraded. For example, if the original instance is a standard DRAM-based instance that has a storage capacity of 8 GB and has 2 GB used, you can downgrade the instance to a standard DRAM-based instance that has a storage capacity of 4 GB.

Does the endpoint of an instance change after a configuration change? Do I need to modify the application code?

Regardless of whether you change a standard instance to a cluster instance or change a standalone instance to a master-replica instance, the instance information remains unchanged. The information includes the instance ID, endpoints, data, whitelists, and existing accounts and their corresponding passwords.

Can I change the configurations of my Tair instance across storage types?

Tair does not support configuration changes between different storage types, such as memory, persistent memory, and enhanced SSDs (ESSDs).

Can I separately improve the CPU performance of an instance?

Tair does not allow you to separately upgrade CPU specifications. You can use the following methods to improve the overall CPU performance of an instance:

  • Change a standard instance to a cluster or read/write splitting instance.

  • Increase the number of read replicas for a read/write splitting instance.

  • Increase the number of shards for a cluster instance.

For more information, see How do I upgrade the CPU specifications of an ApsaraDB for Redis instance?

For more information about instance types, see Overview.

Can I directly upgrade a local disk-based instance to a cloud disk-based instance?

You cannot directly upgrade a local disk-based instance to a cloud disk-based instance.

If you want to upgrade a local disk-based instance to a cloud-disk based instance, separately purchase a cloud disk-based instance, and then migrate data from the local disk-based instance to the cloud disk-based instance. For more information, see Migrate data between ApsaraDB for Redis instances.

How do I change a cluster instance to a standard instance?

  • You can change a local disk-based cluster instance to a standard instance by changing configurations on the Change Configurations page.

  • You can change a cloud disk-based cluster instance in proxy mode to a standard instance. Cluster instances in direct connection mode cannot be changed to standard instances.

How do I change a high-availability master-replica instance to a standalone instance?

You cannot change a high-availability instance to a standalone instance because standalone instances do not ensure data reliability.

If you want to change a high-availability instance to a standalone instance, separately purchase a high-availability instance, and use Data Transmission Service (DTS) to migrate data from the high-availability instance to a standalone instance. For more information, see Migrate data between ApsaraDB for Redis instances.

Do I need to suspend read and write operations when I change the configurations of an instance?

No. You do not need to suspend read and write operations during the configuration change. However, the instance may become read-only for up to 1 minute and experience one or two transient connections that each lasts up to 30 seconds. We recommend that you change the configurations and perform switchover during off-peak hours. For more information, see Impacts of configuration changes.

When I change a standard instance to a cluster instance or adjust the number of shards for a cluster instance, is data automatically migrated to each shard?

Yes. When you change a standard instance to a cluster instance or adjust the number of shards for a cluster instance, data is automatically migrated in the background and evenly distributed across shards.

How long does it take to perform a configuration change?

The time required for a configuration change is affected by various factors such as the network conditions, the number of business requests, and the data volume. Therefore, the exact duration cannot be estimated.

You can click the image.png icon in the upper-right corner of the Instance Information page to check the progress of the task.

image.png

Does a configuration change cause data loss?

A configuration change does not cause data loss.

Why is the instance in the Changing Configuration state after I set the switchover time to Switch Within Maintenance Window and submit a configuration change request?

After you submit the configuration change request, the status of the instance immediately changes to Changing Configuration. During this phase, the system executes the required preparatory tasks for the configuration change, such as applying for resources and synchronizing data. No switchover is performed and the instance can run as expected.

Related API operations

API operation

Description

ModifyInstanceSpec

Changes the configurations of a Tair instance.