Removing nodes from clusters

Removing nodes from clusters

Nodes are removed from clusters with the POST /controller/ejectNode HTTP method and URI.

HTTP method and URI

Server nodes are typically removed from a cluster when the node is temporarily or permanently down.


POST /controller/ejectNode        
      

Syntax

HTTP request syntax:

POST /controller/ejectNode
Host: [localhost]:8091
Authorization: Basic xxxxxxxxxxxx
Accept: */*
Content-Length: xxxxxxxxxx
Content-Type: application/x-www-form-urlencoded
otpNode=[node@hostname]

Curl request syntax:

curl -u admin:password -d otpNode=[node@hostname] \
  http://[localhost]:8091/controller/ejectNode

Example

HTTP request example:

POST /controller/ejectNode
Host: 192.168.0.106:8091
Authorization: Basic xxxxxxxxxxxx
Accept: */*
Content-Length: xxxxxxxxxx
Content-Type: application/x-www-form-urlencoded
otpNode=ns_1@192.168.0.107

Curl request example:

curl -u admin:password -d otpNode=ns_1@192.168.0.107 \
  http://192.168.0.106:8091/controller/ejectNode

Response codes

200 OK - node ejected
400 Error, the node to be ejected does not exist
401 Unauthorized - Credentials were not supplied and are required
403 Forbidden - Credentials were supplied and are incorrect