To experience features of the new version, you can upgrade the major version of an ApsaraDB for Redis instance with one click in the ApsaraDB for Redis console. For example, you can upgrade the major version from Redis 2.8 to Redis 4.0.

Procedure

The upgrade procedure varies by architecture. For more information, see the following table.

Architecture Procedure
Cluster instances
  1. Apply for resources that are required to create an instance of a new version, such as proxy node resources.
  2. Synchronize the full and incremental data from the original instance to the instances of the new version.
  3. Switch over instances. When data synchronization is close to completion, the original instance is set to read-only and waits less than 60 seconds for data to be completely synchronized. After data synchronization is complete, the system disassociates the virtual IP address (VIP) from the original instance and associates the VIP with the new instance.
    Note If you select Update During Maintenance, the system performs the switchover operation within the maintenance window of the instance.
  4. Complete the upgrade. Release the resources of the original instance and change the state of the new instance to Running.
Read/write splitting instances
Standard instances
  1. Upgrade the replica node. Stop the original replica node and then start a replica node of the new version.
  2. Synchronize data from the master node to the replica node of the new version.
  3. Switch over the master node and the replica node. When data synchronization is close to completion, the instance is set to read-only and waits less than 60 seconds for data to be completely synchronized. After data synchronization is complete, the system disassociates the VIP from the master node and associates the VIP to the replica node. Meanwhile, the system performs a master-replica switchover to promote the replica node of the new version to the master node.
    Note If you select Update During Maintenance, the system performs the master-replica switchover operation within the maintenance window of the instance.
  4. Upgrade the master node that is demoted to replica node. The original master node becomes the replica node. The system repeats Step 1 and Step 2 to upgrade the replica node and synchronize data.
  5. Complete the upgrade. The status of the instance is changed to Running.

Impacts

  • The Redis service remains unaffected during the phases of applying for resources, upgrading replica nodes, and synchronizing data.
  • During the instance switchover or master/replica switchover, the instance experiences transient connection errors. The instance stays in the read-only state for 60 seconds or less to wait until all data is synchronized. Upgrade the instance during off-peak hours and ensure that your application is configured with a reconnection mechanism.

Procedure

  1. Log on to the ApsaraDB for Redis console.
  2. On the top of the page, select the region where the instance is deployed.
  3. On the Instance List page, click the Instance ID of the instance.
  4. In the Basic Information section, click Major Update.
    Figure 1. Upgrade the major version
    Upgrade the major version of an instance
    Note If the Major Update button does not appear, you are using the latest major version.
  5. In the dialog box that appears, select the specified major version and the time to upgrade.
    Figure 2. Select the required major version of the instance
    Select the major version to which you want to upgrade
    Note During the instance switchover or master/replica switchover, the instance experiences transient connection errors within seconds and stays in the read-only state for 60 seconds or less. We recommend that you select Update During Maintenance. In this case, the system performs the switchover operation within the maintenance window of the instance to minimize the impact. For more information about how to set the maintenance window, see Set the maintenance window.
  6. Click OK.

Related API operations

API Description
ModifyInstanceMajorVersion Upgrades the major version of an ApsaraDB for Redis instance.

FAQ

Q: Why does the instance status change to Upgrading Major Version after I select Update During Maintenance to upgrade the major version?

A: When the system prepares for upgrades, such as applying for resources and synchronizing data, instances or master and replica nodes cannot be switched over. Therefore, the system does not affect instances that provide services.
Note The instance experiences transient connection errors within seconds and stays in the read-only state for 60 seconds or less only during the switchover of instances or master and replica nodes.