Updated on 2023-03-15 GMT+08:00

Replacing a Specified Node

If a node in the cluster is faulty, you can create a new node with the same specifications to replace it.

Prerequisites

The target cluster is available and has no tasks in progress.

Constraints

  • Only one node can be replaced at a time.
  • The ID, IP address, specifications, and AZ of the new node will be the same as those of the original one.
  • The configurations you modified manually will not be retained after node replacement. For example, if you have manually added a return route to the original node, you need to add it to the new node again after the node replacement is complete.
  • If the node you want to replace is a data node (ess) or cold data node (ess-cold), pay attention to the following precautions:
    1. Before a data node or cold data node is replaced, its data needs to be migrated to other nodes. To properly store the data, ensure the maximum sum of replicas and primary shards of an index is smaller than the total number of data nodes (ess and ess-cold nodes) in the cluster. The node replacement duration depends heavily on the migration speed.
    2. Clusters whose version is earlier than 7.6.2 cannot have closed indexes. Otherwise, data nodes or cold data nodes cannot be replaced.
    3. The AZ of the node to be replaced must have two or more data nodes (including ess and ess-cold).
    4. If the cluster of the node to be replaced does not have a master node (ess-master), the number of available data nodes (including ess and ess-cold) in the cluster must be greater than or equal to 3.
    5. The preceding precautions do not apply if you are replacing a master node (ess-master) or client node (ess-client).
    6. The precautions 1 to 4 do not apply if you are replacing a faulty node, regardless of its type. Faulty nodes are not included in _cat/nodes.

Procedure

  1. Log in to the CSS management console.
  2. In the navigation pane on the left, choose Clusters > Elasticsearch. On the displayed Clusters page, locate the target cluster and choose More > Modify Configuration in the Operation column.
  3. On the Modify Configuration page, click the Replace Node tab.
  4. Select the target node.
    Figure 1 Replacing a specified node
  5. Click Submit.
  6. Click Back to Cluster List to switch to the Clusters page. The Task Status is Upgrading. When Cluster Status changes to Available, the node has been successfully replaced.