[GitHub] csantanapr closed pull request #3037: Add guide about limitation on couchdb clustering

[GitBox <gi...@apache.org>]

csantanapr closed pull request #3037: Add guide about limitation on couchdb clustering
URL: https://github.com/apache/incubator-openwhisk/pull/3037
 
 
   

This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:

As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):

diff --git a/ansible/README.md b/ansible/README.md
index 432571f016..8bb9596608 100644
--- a/ansible/README.md
+++ b/ansible/README.md
@@ -147,6 +147,15 @@ You need to run `initdb.yml` on couchdb **every time** you do a fresh deploy Cou
 The playbooks `wipe.yml` and `postdeploy.yml` should be run on a fresh deployment only, otherwise all transient
 data that include actions and activations are lost.
 
+#### Limitation
+
+You can not run multiple CouchDB nodes on a single machine.
+This limitation comes from Erlang EPMD.
+When CouchDB forms a cluster, it counts on EPMD to find other nodes.
+If we want to run multiple nodes on a single machine, we must differentiate EPMD port(`4369`) for each nodes. But if this port is different on each nodes, they cannot find each other.
+So if you want to deploy multiple CouchDB nodes, all nodes should be placed on different machines respectively.
+
+
 ### Deploying Using Cloudant
 - Make sure your `db_local.ini` file is set up for Cloudant. See [Setup](#setup)
 - Then execute


 

----------------------------------------------------------------
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:
users@infra.apache.org


With regards,
Apache Git Services