[jira] [Created] (CASSANDRA-16253) Fix documentation to reflect real defaults for commit logs

["Alain RODRIGUEZ (Jira)" <ji...@apache.org>]

Alain RODRIGUEZ created CASSANDRA-16253:
-------------------------------------------

             Summary: Fix documentation to reflect real defaults for commit logs
                 Key: CASSANDRA-16253
                 URL: https://issues.apache.org/jira/browse/CASSANDRA-16253
             Project: Cassandra
          Issue Type: Task
            Reporter: Alain RODRIGUEZ
            Assignee: Alain RODRIGUEZ


About the documentation on commit logs:
 * Commit logs default is every 10 sec (periodic), not batch [https://github.com/apache/cassandra/blob/cassandra-3.11.8/conf/cassandra.yaml#L385-L386] (same in 3.11.9 or trunk). It can lead to data losses but still makes sense to me because fsync-ing every write is very expensive, and (even in batches) should be reserved for the super paranoid where handling multiple power-out (or sudden disk failures) simultaneously on multiple nodes needs to be handled (as [~mck] explained to me.

  * Nonetheless, apart from the theory behind it, in a more practical perspective, *the doc is wrong* and says default is `_Default Value:_ batch` which mislead me and this could happen to more people: [https://cassandra.apache.org/doc/latest/architecture/storage_engine.html#commit-log]

 

I think this is important enough for us to quickly fix the documentation in trunk. As this information is fully missing in the 3.11 branch documentation, I suggest we add it as well on that branch (based on information about commit logs from trunk).



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org