You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@couchdb.apache.org by gi...@git.apache.org on 2017/07/27 22:15:52 UTC

[GitHub] nickva commented on a change in pull request #152: Update for ini file handling under 2.x

nickva commented on a change in pull request #152: Update for ini file handling under 2.x
URL: https://github.com/apache/couchdb-documentation/pull/152#discussion_r129972867
 
 

 ##########
 File path: src/config/intro.rst
 ##########
 @@ -70,24 +45,23 @@ For example, setting the :option:`httpd/bind_address` parameter in
     re-installation, so localised changes should be made to the ``local.ini``
     file or files within the ``local.d`` directory.
 
-The configuration files chain may be changed by specifying additional sources
-by using next command line options:
+.. highlight:: sh
 
-- ``-a``: adds configuration file to the chain
-- ``-A``: adds configuration directory to the chain
+The configuration file chain may be changed by setting the ERL_FLAGS
+environment variable::
 
-Let's add these options and see how the configuration chain changes::
+    export ERL_FLAGS="-couch_ini /path/to/my/default.ini /path/to/my/local.ini"
 
-    shell> couchdb -c -a /home/couchdb/custom.ini
-    /etc/couchdb/default.ini
-    /etc/couchdb/default.d/geocouch.ini
-    /etc/couchdb/local.ini
-    /etc/couchdb/local.d/geocouch.ini
-    /etc/couchdb/local.d/vendor.ini
-    /home/couchdb/custom.ini
+or by placing the ``-couch_ini ..`` flag directly in the ``etc/vm.args`` file.
+Passing ``-couch_ini ..`` as a command-line argument when launching ``couchdb``
+is the same as setting the ``ERL_FLAGS`` environment variable.
 
-In case when `/home/couchdb/custom.ini` exists it will be added to
-the configuration chain.
+.. warning::
+    The environment variable/command-line flag overrides any ``-couch_ini``
+    option specified in the ``etc/vm.args`` file. And, **BOTH** of these
 
 Review comment:
   Maybe just use bold for BOTH instead of bold and capitalized letters?
 
----------------------------------------------------------------
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