You are viewing a plain text version of this content. The canonical link for it is here.

Posted to notifications@couchdb.apache.org by GitBox <gi...@apache.org> on 2020/01/08 02:37:23 UTC

[GitHub] [couchdb-documentation] kocolosk opened a new pull request #470: Document rexi config settings

kocolosk opened a new pull request #470: Document rexi config settings
URL: https://github.com/apache/couchdb-documentation/pull/470
 
 
   ## Overview
   
   Document the config flags for the RPC library
   
   ## Related Pull Requests
   
   apache/couchdb#2360 is a new config setting for 3.0
   
   ## Checklist
   
   - [x] Documentation is written and is accurate;
   - [x] `make check` passes with no errors
   - [ ] Update [rebar.config.script](https://github.com/apache/couchdb/blob/master/rebar.config.script) with the commit hash once this PR is rebased and merged
   

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to 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

[GitHub] [couchdb-documentation] kocolosk merged pull request #470: Document rexi config settings

Posted by GitBox <gi...@apache.org>.

kocolosk merged pull request #470: Document rexi config settings
URL: https://github.com/apache/couchdb-documentation/pull/470
 
 
   

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to 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

[GitHub] [couchdb-documentation] kocolosk commented on a change in pull request #470: Document rexi config settings

Posted by GitBox <gi...@apache.org>.

kocolosk commented on a change in pull request #470: Document rexi config settings
URL: https://github.com/apache/couchdb-documentation/pull/470#discussion_r364200618

##########
File path: src/config/cluster.rst
##########
@@ -85,3 +85,39 @@ Cluster Options

[cluster]
seedlist = couchdb@node1.example.com,couchdb@node2.example.com
+
+RPC Performance Tuning
+======================
+
+.. config:section:: rexi :: Internal RPC Tuning
+
+ CouchDB uses distributed Erlang to communicate between nodes in a cluster.
+ The ``rexi`` library provides an optimized RPC mechanism over this
+ communication channel. There are a few configuration knobs for this system,
+ although in general the defaults work well.
+
+ .. config:option:: buffer_count
+
+ The local RPC server will buffer messages if a remote node goes unavailable.
+ This flag determines how many messages will be buffered before the local
+ server starts dropping messages. Default value is ``2000``.
+
+ .. config:option:: server_per_node
+
+ Early versions of this RPC library used a single local Erlang process for
+ sending messages to all other nodes in a cluster. The current default is to
+ spawn a local gen_server process for each node in the cluster. It is not
+ recommended to change this setting from the default.

Review comment:
Good call. I'm sitting here telling the user why she should ignore this option, and wasting even more of her time in doing so! I took another pass with essentially your recommendation.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to 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

[GitHub] [couchdb-documentation] flimzy commented on a change in pull request #470: Document rexi config settings

Posted by GitBox <gi...@apache.org>.

flimzy commented on a change in pull request #470: Document rexi config settings
URL: https://github.com/apache/couchdb-documentation/pull/470#discussion_r364129362

##########
File path: src/config/cluster.rst
##########
@@ -85,3 +85,39 @@ Cluster Options

Review comment:
Is this history lesson helpful to CouchDB users? Could we simplify this paragraph with something like:

> By default, ``rexi`` will spawn one local ``gen_server`` process for each node in the cluster. This setting changes the number of ``gen_server`` processes per node. It is not recommended to change this setting from the default.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

With regards,
Apache Git Services