As your business develops, you may have higher requirements for the configuration of your Elasticsearch cluster. If the current configuration of your Elasticsearch cluster cannot meet your business requirements, you can upgrade its configuration. This topic describes how to upgrade the configuration of an Elasticsearch cluster and the related precautions.
- Specification upgrades
You can upgrade the configuration for only one type of node during each upgrade. The node types include data nodes, warm nodes, client nodes, dedicated master nodes, Kibana nodes, and elastic nodes.Note You can remove data nodes from your cluster to downgrade the configuration of the cluster. For more information about how to remove data nodes, see Scale in an Elasticsearch cluster.
- Impact on services
- After you upgrade the configuration of your cluster, the system restarts the cluster
to make the changes take effect. The time required for the restart depends on the
specifications, data structure, and data volume of the cluster. In most cases, the
restart requires a few hours. For more information, see Restart a cluster or node.
Notice In most cases, if the load of your cluster is not high and indexes have replica shards, the cluster can still provide services during a restart. In some cases, however, access timeouts may occur during a restart. For example, a number of clusters are forced to restart at the same time, the cluster is heavily loaded and is not accessible, indexes do not have replica shards, or large amounts of data are written and queried. In these cases, we recommend that you design a retry mechanism on your client before you restart your cluster.
- If your cluster is abnormal (indicated by the color yellow or red), you must select Forced Update. This may affect services.
- After you upgrade the configuration of your cluster, the system restarts the cluster to make the changes take effect. The time required for the restart depends on the specifications, data structure, and data volume of the cluster. In most cases, the restart requires a few hours. For more information, see Restart a cluster or node.
- Version upgrades
You cannot upgrade the version of your cluster during a configuration upgrade. For more information, see Upgrade the version of a cluster.Notice If you perform a version upgrade during a configuration upgrade, the system displays the "UpgradeVersionMustFromConsole" error message.
- Changes in billing
After you submit a configuration upgrade order, your cluster is charged based on the new configuration.Note During a configuration upgrade, you can check the price of your order on the Upgrade/Downgrade page in real time.
- 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 lower-right corner of the Basic Information page, choose .
- Change the configuration of the cluster, such as node specifications, the storage
type, and storage space per node.
The Current Config section of the Upgrade/Downgrade page shows the current configuration of the cluster. You can use this as a reference during the upgrade.
Follow the instructions on the Upgrade/Downgrade page to upgrade the configuration of your cluster based on your business requirements. For more information about the parameters on the page, see Parameters on the buy page. The following table describes only some of the parameters.Notice If the zone where your cluster resides has insufficient resources for a configuration upgrade, you can migrate the nodes in the zone to another before the upgrade. For more information, see Migrate nodes in a zone.
Parameter Description Node Storage If Disk Type is set to Cloud SSD, you can increase the value of Node Storage for data nodes. The maximum storage space supported by a single node depends on the disk type of the node. You can check specific limits in the Elasticsearch console. Dedicated Master Node You can purchase or upgrade dedicated master nodes.Notice If the specifications of your dedicated master nodes are 1 vCPU and 2 GiB of memory, you can upgrade these nodes on the Upgrade/Downgrade page. After the upgrade, the cluster is charged based on the new specifications. If your dedicated master nodes are free of charge, you are charged for these nodes after you upgrade them. Warm Node You can purchase or upgrade warm nodes. Client Node You can purchase or upgrade client nodes. Kibana Node You can upgrade your Kibana node.Notice When you purchase a cluster, Alibaba Cloud provides a Kibana node for you free of charge. This Kibana node offers 1 vCPU and 2 GiB of memory. You can upgrade the Kibana node on the Upgrade/Downgrade page. Forced Update If your cluster is abnormal (indicated by the color red or yellow) and your services are severely affected, you must immediately upgrade the cluster configuration. In this case, we recommend that you select Forced Update. The system will perform a forced update regardless of the cluster status. The update requires only a short period.Notice
- After the forced update, the system restarts your cluster. During the restart, the services running on the cluster may be unstable.
- If you do not select Forced Update, the system uses the default mode to restart your cluster to make the changes take effect. For more information, see Restart a cluster or node.
- Read and select Elasticsearch Terms of Service. Then, click Buy Now.After you complete the payment, the system restarts the cluster to make the changes take effect.