wohali commented on a change in pull request #155: Fully document 
_cluster_setup endpoint for 2.1
URL: 
https://github.com/apache/couchdb-documentation/pull/155#discussion_r130248550
 
 

 ##########
 File path: src/cluster/setup.rst
 ##########
 @@ -201,7 +203,14 @@ setup the node:
 
 .. code-block:: bash
 
-     curl -X POST -H "Content-Type: application/json" 
http://admin:[email protected]:5984/_cluster_setup -d '{"action": 
"enable_cluster", "bind_address":"0.0.0.0", "username": "admin", 
"password":"password"}'
+     curl -X POST -H "Content-Type: application/json" 
http://admin:[email protected]:5984/_cluster_setup -d '{"action": 
"enable_cluster", "bind_address":"0.0.0.0", "username": "admin", 
"password":"password", "node_count":"3"}'
+
+.. warning::
+    The ``node_count`` parameter is used to set the ``[cluster]`` ``n`` value.
+    Even when joining more than 3 nodes into a cluster using this endpoint,
+    it is **strongly** recommended not to set this value higher than 3, as
+    it will directly impact the number of replicas of each document in the
+    cluster.
 
 Review comment:
   Agree :100:%. Please merge apache/couchdb-setup#14 and I'll remove the 
warning here.
 
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
[email protected]


With regards,
Apache Git Services

Reply via email to