Elasticsearch:Upgrade the version of a cluster

Limits on cluster versions

Cluster restart modes

Procedure

1. Perform a check before an upgrade.

   Before you upgrade the version or kernel of your cluster, complete the required manual checks. In addition, check the cluster status and configuration compatibility. For more information, see Perform a check before a version upgrade.

   Note

   • Before you upgrade the version or kernel of your cluster, you must complete the required manual checks. We recommend that you also check the cluster status and configuration compatibility in advance. You can also trigger the system to check cluster status and configuration compatibility during the upgrade process. In this case, if an exception is detected, you must handle the exception as prompted and perform the check again.

   • Configuration compatibility checks are required for clusters whose major versions need to be upgraded. For example, if you want to upgrade the version of a cluster from V5.X to V6.X, you need to perform a configuration compatibility check.

2. Create a snapshot to back up data stored on the cluster.

   You must create a snapshot to back up data during the last hour before you upgrade the version or kernel of your cluster. For more information about data backup by using a snapshot, see Data backup overview. If no snapshots are created during the last hour before you upgrade the version or kernel of your cluster, you must manually create a snapshot to back up data during the upgrade.

3. Upgrade the version or kernel of the cluster.

   After you upgrade the version or kernel of the cluster, the system restarts the cluster. The time that is required for the restart depends on the specifications of the cluster, the volume of data stored on the cluster, and the data structure. In most cases, the restart requires about 1 hour.

   Important

   The system selects an appropriate restart mode based on your upgrade scenario. The restart may affect the services of your cluster. For more information, see Cluster restart modes.

Upgrade the version or kernel of a cluster

1. Log on to the Alibaba Cloud Elasticsearch console.
2. In the left-side navigation pane, click Elasticsearch Clusters.
3. Navigate to the desired cluster.
   1. In the top navigation bar, select the resource group to which the cluster belongs and the region where the cluster resides.
   2. On the Elasticsearch Clusters page, find the cluster and click its ID.

4. On the Basic Information page, click Update and Upgrade on the right side.

5. In the Upgrade dialog box, configure the parameters.

   For the Operation Type parameter, select Kernel Patch Update if you want to upgrade the kernel of your cluster and select Elasticsearch Version Upgrade if you want to upgrade the version of your cluster.

   • A kernel upgrade does not change the version of the cluster. If the system detects that new kernel features are released, the A new kernel patch is available message appears on the right side of the Version parameter on the Basic Information page of a cluster. You can also click the message to upgrade the kernel of the cluster. After the kernel is upgraded, the message disappears. For more information about the new features that are provided by the upgraded kernel, see AliES release notes.

   • The kernel of a cluster is not upgraded during the version upgrade of the cluster.

6. Click Precheck.

   Then, the system checks the configuration compatibility, status, snapshots, and basic resources of the cluster.

   If exceptions are detected, handle the exceptions as prompted after the check is complete. The following descriptions provide details:

   • Configuration compatibility check

     The system checks whether the later version is compatible with all configurations in the earlier version, especially for major version upgrades, such as upgrades from V5.X to V6.X. If the cluster fails the check, the upgrade is terminated. In this case, modify the incompatible configurations based on the related instructions and perform the upgrade again. For more information, see Configuration compatibility check and Modify incompatible configurations.

   • Cluster status check

     The system checks whether the cluster is in the Active state (indicated by the color green) and whether its load is normal. Before the check is performed or if the cluster fails the check, you can check whether the cluster load is normal based on the instructions provided in Cluster status check.

   • Snapshot check

     The system checks whether the cluster has created snapshots during the last hour before the upgrade. If the cluster has not created snapshots during the last hour, you can click Create Snapshots in the Upgrade dialog box to trigger snapshot creation.

     Important

     If the upgrade fails, you can restore data from the snapshots. The time that is required to create snapshots depends on the volume of data stored on the cluster. If the Auto Snapshot feature is disabled for the cluster and the data volume is large, the time that is required to create the first snapshot is long.

7. After the cluster passes the precheck, click Upgrade.

   During the upgrade, you can view the upgrade progress in the Tasks dialog box.

   After the upgrade, you can view the cluster or kernel version on the Basic Information page.

FAQ

• How long is required to upgrade the version of an Elasticsearch cluster?

• Can I upgrade or downgrade the version of an Elasticsearch cluster?

• Are services affected when I upgrade the version of an Elasticsearch cluster?

• When I upgrade the configuration of an Elasticsearch cluster, the "UpgradeVersionMustFromConsole" error message is reported. What do I do?