couchdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [couchdb] branch master updated: Update advice on the use of -name (and NOT -sname)
Date Tue, 01 Aug 2017 22:38:09 GMT
This is an automated email from the ASF dual-hosted git repository.

wohali pushed a commit to branch master
in repository

The following commit(s) were added to refs/heads/master by this push:
     new f728209  Update advice on the use of -name (and NOT -sname)
f728209 is described below

commit f728209102a84d669f81431dea0bd0d60655a12f
Author: Joan Touzet <>
AuthorDate: Tue Aug 1 18:37:22 2017 -0400

    Update advice on the use of -name (and NOT -sname)
    Closes #729. See the ticket for additional information.
 rel/overlay/etc/vm.args | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/rel/overlay/etc/vm.args b/rel/overlay/etc/vm.args
index b69ad82..acb4571 100644
--- a/rel/overlay/etc/vm.args
+++ b/rel/overlay/etc/vm.args
@@ -10,10 +10,22 @@
 # License for the specific language governing permissions and limitations under
 # the License.
-# Each node in the system must have a unique name.  A name can be short
-# (specified using -sname) or it can by fully qualified (-name).  There can be
-# no communication between nodes running with the -sname flag and those running 
-# with the -name flag.
+# Each node in the system must have a unique name. These are specified through
+# the Erlang -name flag, which takes the form nodename@hostname. CouchDB
+# recommends the following values for this flag:
+# 1. If this is a single node, not in a cluster, use:
+#    -name couchdb@
+# 2. If DNS is configured for this host, use the FQDN, such as:
+#    -name
+# 3. If DNS isn't configured for this host, use IP addresses only, such as:
+#    -name couchdb@
+# Do not rely on tricks with /etc/hosts or libresolv to handle anything
+# other than the above 3 approaches correctly.
+# Multiple CouchDBs running on the same machine can use couchdb1@, couchdb2@,
+# etc.
 # All nodes must share the same magic cookie for distributed Erlang to work.

To stop receiving notification emails like this one, please contact
['"" <>'].

View raw message