RemoveNodes
You can use RemoveNodes
to remove one or more nodes that should no longer participate in the cluster.
Before removing a node, you must remove all drives the node contains using the RemoveDrives
method. You cannot remove a node until the RemoveDrives
process has completed and all data has been migrated away from the node. After you remove a node, it registers itself as a pending node. You can add the node again or shut it down (shutting the node down removes it from the pending node list).
Cluster master node removal
If you use RemoveNodes
to remove the cluster master node, the method might time out before returning a response. If the method call fails to remove the node, make the method call again. Note that if you are removing the cluster master node along with other nodes, you should use a separate call to remove the cluster master node by itself.
Parameter
This method has the following input parameter:
Name | Description | Type | Default value | Required |
---|---|---|---|---|
ignoreEnsembleToleranceChange |
Ignore changes to the ensemble's node failure tolerance when removing nodes. If the storage cluster uses data protection schemes that tolerate multiple node failures and removing the nodes would decrease the node failure tolerance of the ensemble, the node removal normally fails with an error. You can set this parameter to true to disable the ensemble tolerance check so that the node removal succeeds. |
boolean |
false |
No |
nodes |
List of NodeIDs for the nodes to be removed. |
integer array |
None |
Yes |
Return value
This method has no return value.
Request example
Requests for this method are similar to the following example:
{ "method": "RemoveNodes", "params": { "nodes" : [3,4,5] }, "id" : 1 }
Response example
This method returns a response similar to the following example:
{ "id" : 1 "result" : {}, }
New since version
9.6