apache / apache/couchdb

Configuration/Cluster Set Up chapter miss information about ERL_EPMD_ADDRESS env variable

Open
#4,217 0 comments 1 reaction 0 assignees View on GitHub
documentation
Dominant language
Erlang
Stars
7k
Forks
1.1k
Avg merge
1d 16h
Merged PRs (30d)
9

Description

When setting-up couchdb cluster following documentation at https://docs.couchdb.org/en/stable/setup/cluster.html there is no indication for the need to set the ERL_EPMD_ADDRESS environment variable to expose epmd to other nodes, in particular when using the couchdb provided debian package where this variable is defined in `/etc/default/couchdb` to `127.0.0.1`

I think this should be added to the documentation to avoid loosing time when configuring a cluster.

Contributor guide

Open the contributing guide

Research direction

Read the cluster setup chapter at docs.couchdb.org/en/stable/setup/cluster.html and compare its guidance with the Debian package setting in /etc/default/couchdb. Update the documentation to explain when ERL_EPMD_ADDRESS must expose epmd beyond localhost, and verify that the cluster setup steps cover this configuration.

Written by the indexing model from the issue text.

Assessment

Tech stack
erlang
Domain
databases, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.