Joining Nodes into Clusters
Nodes can be added to clusters with the POST /node/controller/doJoinCluster HTTP method and URI.
Syntax
HTTP request syntax:
POST /node/controller/doJoinCluster Host: localhost:8091 Authorization: Basic xxxxxxxxxxxx Accept: */* Content-Length: xxxxxxxxxx Content-Type: application/x-www-form-urlencoded clusterMemberHostIp=[ip-address]&clusterMemberPort=[port]&user=[admin]&password=[password]
Curl request syntax:
curl -u [admin]:[password] -d clusterMemberHostIp=[ip-address] \ -d clusterMemberPort=[port] \ -d user=[admin] -d password=[password] -d services=[data | index | n1ql] http://[localhost]:8091/node/controller/doJoinCluster
Description
This REST request adds an individual server node to a cluster.
Two clusters cannot be merged together into a single cluster, however, a single node can be added to an existing cluster.
The clusterMemberHostIp and clusterMemberPort parameters must be specified to add a node to a cluster.
HTTP method and URI
POST /node/controller/doJoinCluster
The following parameters are required:
| Argument | Description |
|---|---|
clusterMemberHostIp |
Hostname or IP address of a member of the cluster that the node receiving the POST is joining. |
clusterMemberPort |
Port number for the RESTful interface to the system. If the cluster requires credentials, provide the administrator username and password. |
Example
HTTP request example:
POST /node/controller/doJoinCluster Host: 10.5.2.54:8091 Authorization: Basic xxxxxxxxxxxx Accept: */* Content-Length: xxxxxxxxxx Content-Type: application/x-www-form-urlencoded clusterMemberHostIp=192.168.0.1&clusterMemberPort=8091&user=admin&password=admin123
Curl request example:
curl -u Administrator:password -d 'clusterMemberHostIp=192.168.0.1' \ -d 'clusterMemberPort=8091' \ -d 'user=admin' -d 'password=password' \ http://10.5.2.54:8091/node/controller/doJoinCluster