[couchdb-documentation] branch improve-limits-advice created (now 4125bac)

[wo...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

wohali pushed a change to branch improve-limits-advice
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git.


      at 4125bac  Improve advice on running out of file handles

This branch includes the following new commits:

     new 4125bac  Improve advice on running out of file handles

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.

[couchdb-documentation] 01/01: Improve advice on running out of file handles

[wo...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

wohali pushed a commit to branch improve-limits-advice
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git

commit 4125bac34da66530f4bfb0cdb001e9069fa3daf6
Author: Joan Touzet <jo...@atypical.net>
AuthorDate: Wed Jul 8 20:38:57 2020 -0400

    Improve advice on running out of file handles
---
 src/install/troubleshooting.rst | 39 +++++++++++++++++++++++++++++++--------
 1 file changed, 31 insertions(+), 8 deletions(-)

diff --git a/src/install/troubleshooting.rst b/src/install/troubleshooting.rst
index a2e9496..368d71d 100644
--- a/src/install/troubleshooting.rst
+++ b/src/install/troubleshooting.rst
@@ -190,20 +190,43 @@ present from previous releases.
 Runtime Errors
 ==============
 
+Erlang stack trace contains ``system_limit``, ``open_port``, or ``emfile``
+--------------------------------------------------------------------------
+Modern Erlang has a default limit of 65536 ports (8196 on Windows), where each
+open file handle, tcp connection, and linked-in driver uses one port. OSes have
+different soft and hard limits on the number of open handles per process, often
+as low as 1024 or 4096 files. You've probably exceeded this.
+
+There are two settings that need changing to increase this value. Consult your
+OS documentation for how to increase the limit for your process. Under Linux
+and systemd, this setting can be adjusted via ``systemctl edit couchdb`` and
+adding the lines:
+
+.. code-block:: ini
+
+    [Service]
+    LimitNOFILE=65536
+
+to the file in the editor.
+
+To increase this value higher than 65536, you must also add the Erlang ``+Q``
+parameter to your ``etc/vm.args`` file by adding the line:
+
+.. code-block:: text
+
+    +Q 102400
+
+The old ``ERL_MAX_PORTS`` environment variable is ignored by the version of
+Erlang supplied with CouchDB.
+
 Lots of memory being used on startup
 ------------------------------------
 Is your CouchDB using a lot of memory (several hundred MB) on startup? This one
 seems to especially affect Dreamhost installs. It's really an issue with the
 Erlang VM pre-allocating data structures when ulimit is very large or
 unlimited. A detailed discussion can be found on the erlang-questions list,
-but the short answer is that you should decrease ``ulimit -n`` or define
-``ERL_MAX_PORTS`` to something reasonable like 1024.
-
-erlang stack trace contains ``system_limit``, ``open_port``
------------------------------------------------------------
-Erlang has a default limit of 1024 ports, where each FD, tcp connection, and
-linked-in driver uses one port. You seem to have exceeded this. You can
-change it at runtime using the ``ERL_MAX_PORTS`` env variable.
+but the short answer is that you should decrease ``ulimit -n`` or lower the
+``vm.args`` parameter ``+Q`` to something reasonable like 1024.
 
 function raised exception (Cannot encode 'undefined' value as JSON)
 -------------------------------------------------------------------