Alibaba Cloud Elasticsearch allows you to upgrade the version or kernel of your Alibaba Cloud Elasticsearch cluster. This ensures that your business is up-to-date. This topic describes how to upgrade the version of an Elasticsearch cluster and provides the related precautions.
- The cluster whose version you want to upgrade meets the following requirements.
Type Limit 5.5.3 to 5.6.16 None. 5.6.16 to 6.3.2 None. 6.3.2 to 6.7.0 None.
- A precheck is performed for the version upgrade.
For more information about the related check items, see Check items for cluster status and Check for and modify incompatible configurations before you perform an upgrade from V5.6 to V6.3.
- Kernel upgrades: A new kernel version is available.
You can go to the Basic Information page of your cluster to check whether a new kernel version is available for the cluster.
- Upgrades from V5.6.16 to V6.3.2: The configurations of your cluster are modified to
prevent configuration incompatibility. V6.X may be incompatible with some configurations
in V5.X. If these configurations are not modified, the cluster may not provide services
as expected after the upgrade. For more information, see Check for and modify incompatible configurations before you perform an upgrade from V5.6 to V6.3. For more information about major changes in Elasticsearch V6.X, see Breaking changes in 6.0.
Notice If your client is connected to the cluster whose version you want to upgrade, update the client version before the upgrade. This ensures that the client is compatible with the cluster version after the upgrade. For more information about the version compatibility between clients and clusters, see Compatibility.
|Restart mode||Principle||Risk and recommendation||Scenario|
|Blue-green restart||The system adds nodes of a later version to the cluster, migrates data stored on original nodes to the added nodes, and removes the original nodes from the cluster.||
|Full restart||The system disables all nodes in the cluster and restarts the cluster.||During an upgrade, the system installs a TLS certificate on your cluster. This may interrupt your services but does not cause data loss. Upgrade
duration depends on the specifications of the cluster and the volume of data stored
on the cluster. We recommend that you plan the upgrade in advance.
Note A full restart does not change the IP addresses of the nodes in the cluster. Therefore, you do not need to update the IP addresses.
|5.6.16 to 6.3.2|
Check items for cluster status
|Check item||Normal state|
|Cluster status||The cluster is in the Active state (indicated by the color green).|
|JVM heap memory usage||The JVM heap memory usage of the cluster is less than 75%.|
|Disk usage||The disk usage of nodes is less than the value of cluster.routing.allocation.disk.watermark.low.|
|Replica shards||All indexes are configured with replica shards.|
|Snapshots||The cluster created snapshots during the last hour.|
|Custom plug-ins||The cluster does not have custom plug-ins installed.|
|ECS instances in the zone where the cluster resides||The zone where the cluster resides has sufficient ECS instances.
Note When you upgrade the version or kernel of a cluster, the system adds nodes of a later version to the cluster. Then, the system migrates data stored on original nodes to the added nodes and removes the original nodes from the cluster. Therefore, before the upgrade, make sure that the zone where the cluster resides has sufficient ECS instances.
|YML configuration file||The cluster of a later version is compatible with the YML configuration file in an earlier version.|
- Log on to the Alibaba Cloud Elasticsearch console.
- In the left-side navigation pane, click Elasticsearch Clusters.
- In the top navigation bar, select a resource group and a region. On the Clusters page, click the ID of the desired cluster.
- In the upper-right corner of the Basic Information page, click Update and Upgrade.
- In the Upgrade dialog box, select the desired version.Notice A kernel upgrade does not change the version of the cluster. The kernel upgrade entry is displayed only after the system detects a new kernel version. After the kernel is upgraded, the entry is no longer displayed. For more information about the new features that are provided by the upgraded kernel, see AliES release notes.
- Click Precheck.Then, the system checks the configuration compatibility, status, snapshots, and basic resources of the cluster.After the check is complete, handle exceptions as prompted. The following description provides specific instructions on the check items:
- Configuration compatibility check
Check 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 instructions provided in Check for and modify incompatible configurations before you perform an upgrade from V5.6 to V6.3 and perform the upgrade again.
- Cluster status check
Check whether the cluster is in the Active state (indicated by the color green) and whether its load is normal. Before the check or if the cluster fails the check, you can check whether the cluster load is normal based on the instructions provided in Check items for cluster status.
- Snapshot check
Check 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 creationNotice 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, a longer time is required to create the first snapshot.
- Configuration compatibility check
- 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.