Improve docs of use_checkpoints and checkpoint_interval config options.
Project: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/repo Commit: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/commit/aa098a85 Tree: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/tree/aa098a85 Diff: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/diff/aa098a85 Branch: refs/heads/import-master Commit: aa098a85ab85ea25d445615c4cf7a2755e87122d Parents: b6a2d0a Author: Alexander Shorin <[email protected]> Authored: Sat Dec 14 21:55:15 2013 +0400 Committer: Alexander Shorin <[email protected]> Committed: Sat Dec 14 21:55:22 2013 +0400 ---------------------------------------------------------------------- src/config/replicator.rst | 28 ++++++++++++---------------- 1 file changed, 12 insertions(+), 16 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/couchdb-documentation/blob/aa098a85/src/config/replicator.rst ---------------------------------------------------------------------- diff --git a/src/config/replicator.rst b/src/config/replicator.rst index 515c679..388491c 100644 --- a/src/config/replicator.rst +++ b/src/config/replicator.rst @@ -116,37 +116,33 @@ Replicator Database Configuration .. versionadded:: 1.6 Defines replication checkpoint interval in milliseconds. :ref:`Replicator - <replication/replicator>` will :get:`requests </{db}>` Source database - each time after a specified amount of interval:: + <replicator>` will :get:`requests </{db}>` from the Source database at + the specified interval:: [replicator] checkpoint_interval = 5000 - Keeping this value lower raises polling rate to Source database, which - may be useful for frequently changing data, while higher value saves - traffic usage that is important for mobile clients. + Lower intervals may be useful for frequently changing data, while higher + values will lower bandwidth and make fewer requests for infrequently + updated databases. .. config:option:: use_checkpoints .. versionadded:: 1.6 - If set as ``true`` CouchDB makes intermediate checkpoints during - replication from those it may continue it in case of failure or restart:: + If ``use_checkpoints`` is set to ``true``, CouchDB will make checkpoints + during replication and at the completion of replication. CouchDB can + efficiently resume replication from any of these checkpoints:: [replicator] use_checkpoints = true - .. warning:: It's **not recommended** to switch this option off - (by setting value ``false`` to it) since without checkpoints there would - not be stored any replication history logs both on Source and Target, - forcing replication to start from the very beginning. + .. note:: Checkpoints are stored in :ref:`local documents <api/local>` + on both the source and target databases (which requires write access). - .. note:: Checkpoints (aka Replication Log) are stored as :ref:`local - documents <api/local>` both on Source and Target endpoints. In case, - when client has no write permission on Source database you may disable - them, but locally for specific replication process. - See :ref:`replication-settings` for more info. + .. warning:: Disabling checkpoints is **not recommended** as CouchDB + will scan the Source database's changes feed from the beginning. .. config:option:: cert_file
