pgj commented on code in PR #6099:
URL: https://github.com/apache/couchdb/pull/6099#discussion_r3839188564


##########
src/docs/src/install/search.rst:
##########
@@ -43,52 +41,43 @@ to the server command below. If clouseau is installed in 
``/opt/clouseau`` the l
 
     -classpath '/opt/clouseau/*'
 
-The service expects to find a couple of configuration files
-conventionally called ``clouseau.ini`` and ``log4j.properties`` with the 
following
-content:
-
-**clouseau.ini**::
-
-    [clouseau]
-
-    ; the name of the Erlang node created by the service, leave this unchanged
-    [email protected]
+The service expects to find its configuration file conventionally called 
``clouseau.conf``
+with the following content:
 
-    ; set this to the same distributed Erlang cookie used by the CouchDB nodes
-    cookie=brumbrum
+**clouseau.conf**::
 
-    ; the path where you would like to store the search index files
-    dir=/path/to/index/storage
+    config: [
+      {
+        node: {
+          # the name of the Erlang node created by the service, leave this 
unchanged
+          name: clouseau
+         domain: 127.0.0.1
 
-    ; the number of search indexes that can be open simultaneously
-    max_indexes_open=500
+          # set this to the same distributed Erlang cookie used by the CouchDB 
nodes
+          cookie: brumbrum
+        }
+       clouseau: {
+          # the path where you would like to store the search index files
+          dir: /path/to/index/storage
 
-**log4j.properties**::
+          # the number of search indexes that can be open simultaneously
+          max_indexes_open: 500
+       }
+      }
+    ]
 
-    log4j.rootLogger=debug, CONSOLE
-    log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
-    log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
-    log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} %c [%p] %m%n
-
-Once these files are in place the service can be started with an invocation 
like
+Once this file is in place the service can be started with an invocation like
 the following::
 
     java -server \
          -Xmx2G \
          -Dsun.net.inetaddr.ttl=30 \
          -Dsun.net.inetaddr.negative.ttl=30 \
-         -Dlog4j.configuration=file:/path/to/log4j.properties \
          -XX:OnOutOfMemoryError="kill -9 %p" \

Review Comment:
   In theory, there is 
[`taskkill`](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/taskkill)
 for Windows.  But I have not used that personally.  I can remove that part to 
make it OS-agnostic or add a comment about this.
   
   Albeit, today I learned that since Java 8u92, there is a dedicated 
`-XX:+ExitOnOutOfMemoryError` option, which is recommended for this purpose 
and, as the name suggests, it can exit or crash the JVM internally without 
needing to call external OS utilities.



-- 
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.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to