:Update the minor version of an instance

Precautions

• When you update the database version of an instance, Tair first updates the replica instance or prepares a new instance. When the specified execution time arrives, the system performs a master/replica switchover or instance switchover to complete the update. During the switchover, the instance experiences transient connections that last for a few seconds and remains read-only for up to 60 seconds until all data is synchronized. Make sure that your application can automatically reconnect to the instance.

• When you update the minor version of proxy nodes, Tair uses the hot update technology. This way, the new version of the proxy nodes leverages the client connection information from the old version to restore the connections. This enables uninterrupted connections with minimal millisecond-level latency fluctuations. However, specific types of commands, such as BLOCK, Transactions, and Pub/Sub, may experience interruptions during the update. Make sure that your business logic has appropriate reconnection mechanisms for these commands. If a client uses a private endpoint to connect to the Tair instance, all commands remain unaffected during the update.

• Canary release of later minor versions may be available only in specific regions. The system checks the minor version of your instance. If your instance is of the latest minor version, the Minor Version Update or Upgrade Proxy button is not displayed or is unavailable in the Tair console.

• Unless otherwise stated, Alibaba Cloud ensures compatibility between the minor engine versions of Tair. You do not need to worry about compatibility issues that may be caused by updates. For more information, see Release notes for Tair minor versions and Release notes for minor versions of proxy nodes.

Update level description

The icon changes colors based on the minor version update level. The update level is displayed in green, yellow, or red to represent the regular, recommended, or critical update.

Configure automatic update

Version Management Center allows you to check information about the version status of each instance, including whether the latest version is used. You can also use this feature to update instance versions or configure automatic update policies. This feature helps you manage instance versions in a centralized manner.

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.

2. In the left-side navigation pane, click Version Management Center.

3. In the upper-left corner of the console, select a region.

4. On the Version Management Center page, you can view the current minor version and whether it is the latest minor version for all instances in the current region.

5. Click Configure in the Actions column corresponding to the instance that you want to manage. In the Configure dialog box, turn on Automatic Update to configure automatic update operations.

   After you turn on Automatic Update, the system checks the instance versions on a regular basis. If a new version is identified, the system updates the instance to the new version during the specified Update Period within 14 days.

   The update period of an instance is the same as the maintenance window of the instance. If you modify one of the periods, the modification is automatically synchronized to the other period.

   Note

   • You can select multiple instances and batch perform Update or Configure operations on the instances.

   • You can choose Event Center > Scheduled Events to query the version update records of instances.

Manual update

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. In the Basic Information section, move the pointer over the icon next to Minor Version Update or Upgrade Proxy to view the current minor version, the minor version to which you want to update, and the release notes of minor versions.

3. After you view the release notes of minor versions, click Minor Version Update or Upgrade Proxy.

4. In the panel that appears, specify the time when you want to perform the update.

5. Click OK.

FAQ

• Why does the status of an instance change to Upgrading Minor Version after I select Switch within Maintenance Window to update the minor version?

  The status of an instance changes to Upgrading Minor Version because the instance is preparing for the update. When the system prepares for updates, such as applying for resources and synchronizing data, instance switchovers or master/replica switchovers are not performed, and service availability is not affected. The instance experiences transient connections that last for a few seconds and remains read-only for up to 60 seconds only during instance switchovers or master/replica switchovers.

• Why is the Minor Version Update button not displayed in the console?

  The Minor Version Upgrade button is not displayed in the console because the current minor version of your instance is already up to date.

Related API operations