Move Nodes or Instances From Allocators

You might need to move Elasticsearch nodes, Kibana instances, and other components of the Elastic Stack between allocators from time to time for a number of reasons:

  • To prepare for removing the allocator role from the first host on which you installed Elastic Cloud Enterprise.
  • To avoid downtime during maintenance: You can create a new allocator, move all deployments from an existing allocator to the new one, and then deal with the allocator that needs maintenance.
  • To make room on an allocator: You can move some smaller deployments to another allocator if you need additional room for a larger one on an allocator.
  • To move deployments after a failure: When host failures happen, you can move all deployments from the affected allocator to a healthy allocator quickly before spending any time on fixing the failure.
Tip

When you move all nodes from an existing allocator to the new one, ECE migrates the data to new nodes. The migration can take some time, especially when deployments contain large amounts of data and have a heavy workload. Is your deployment under a heavy workload? You might need to stop routing requests first.

Before You Begin

Before you move the nodes and instances that are part of a deployment, you need to make sure that you have sufficient capacity on another allocator. For example: If you have a deployment with a single 32 GB Elasticsearch node and a 4 GB Kibana instance, the allocator that you are moving the deployment to needs to have at least 36 GB of capacity. Note that moving nodes does not actually move the same node onto a different allocator. Under the covers, Elastic Cloud Enterprise creates a new node and then migrates the data for you.

If you followed our recommendation and tagged your allocators to indicate what allocators you want components of the Elastic Stack to run on, the spare capacity you plan to use must be available on an allocator with the same tags. If you did not tag your allocators and edit the default instance configurations, ECE will move nodes and instances to wherever there is space.

When you move all nodes from an existing allocator to the new one, ECE migrates the data to new nodes. The migration can take some time, especially when clusters contain large amounts of data and have a heavy workload. Is your cluster under a heavy workload? You might need to stop routing requests first.

To move nodes from one allocator to another one:

  1. Log into the Cloud UI.
  2. From the Platform menu, select Allocators.
  3. Review the list of all allocators that are part of this installation and look for allocators that are unhealthy or find the allocator that you want to free up.
  4. Recommended: Put the allocator into maintenance mode before continuing.
  5. Click the name of an unhealthy allocator and then select Move Nodes from the menu.
  6. Select the nodes you want and any advanced options that you need. You can move only one type of node at a time.

    Tip

    If you did not enable maintenance mode, set a target allocator under the advanced options when moving nodes to make sure the nodes do not end up on the same allocator again. By default, moving a node moves it to any allocator that has enough capacity.

  7. Repeat step 6 for each of the node types until no nodes remain on the allocator.
  8. Optionally, once the nodes have been moved, Delete Allocator.