Title
Create new category
Edit page index title
Edit category
Edit link
Evicting Data (Technology Preview)
This is a technology preview; it should not be used in production.
In certain cases, there is a need to evict a server and move data on its nodes to other servers in the cluster. This operation is user-initiated and will migrate all of a server's resources (e.g., volumes, snapshots) to other servers within the cluster. Data on volumes with RF=1 cannot be migrated at this point, and the evict process will fail. The evict functionality enables migration of the volumes associated with this server prior to a disable server maintenance operation, ensuring that the volumes remain fully protected.
The evict server process can be used when there is a need to perform planed maintenance on the server and you do not want the maintenance to impact the data availability in the cluster. It can also be used in cases where a server's nodes become unavailable and you would like to trigger an immediate eviction of data and not wait for the nodes to become permanently failed.
If a server is no longer needed after the evict was completed, make sure to delete and remove the server from the cluster (delete server API).
As this is a feature in tech preview, the feature is disabled by default and requires being enabled in order to utilize it (i.e., lbcli enable feature-flag evict-data (Technology Preview)).
Additional Considerations and Limitations
- To successfully evict a server, ensure that there are enough servers/resources/capacity available to evict the data from the server.
- A cluster should have at least four servers (evicting a cluster with three servers is not supported)
- Evicting a server that has volumes that are placed with placement affinity (PrimaryFD) will work, but the PrimaryFD rules will be ignored.
- Evicting a server with RF=1 volumes is not possible. These volumes should be deleted before evicting the server.
- Only one evict process can run at a time. Calling the evict API when an evict process is not supported could cause unexpected behavior.
- It is best to run the evict process when all other servers are healthy and nodes are available.
- Make sure to monitor the evict process and make sure it is completed before doing any other maintenance activities in the cluster (upgrade, restart, etc..).
© 2026 Lightbits Labs™