[SOLR-16855] Add a MigrateReplicas API

• Type: Sub-task
• Status: Closed
• Priority: Major
• Resolution: Implemented
• Fix Version/s: 9.3
• Assignee: Houston Putman
• Reporter: Houston Putman
• Created: 27/Jun/23 15:48
• Updated: 13/Jun/24 16:17
• Resolved: 06/Jul/23 14:56

Description

Currently the ReplaceNode API lets us migrate replicas from one node to another node. However, users might want to migrate multiple nodes at a time, or target a set of nodes instead of a single node. This new API would behave like the replaceNode API, but give users more flexibility.

The new API would use the path POST "/api/cluster/replicas/migrate" (much like the balance replicas API), and have the following body:

{
  "sourceNodes": [], # required
  "targetNodes": [],
  "waitForFinalState": false,
  "async": ""
}

"sourceNodes" would be required, and an error would be returned if an empty list was given. "targetNodes" would be optional, and default to all liveNodes that are not provided in "sourceNodes".

Eventually we could deprecate the ReplaceNode command, or at least have it be a shell on-top-of the MigrateReplicas functionality.

Issue Links

• causes: SOLR-17331 Improve OrderedNodePlacementPlugin placements
• links to: GitHub Pull Request #1730