zookeeper-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From iv...@apache.org
Subject svn commit: r1447756 - in /zookeeper/bookkeeper/trunk: CHANGES.txt bookkeeper-server/conf/bk_server.conf bookkeeper-server/src/main/java/org/apache/bookkeeper/conf/ServerConfiguration.java doc/bookkeeperConfig.textile
Date Tue, 19 Feb 2013 15:15:48 GMT
Author: ivank
Date: Tue Feb 19 15:15:47 2013
New Revision: 1447756

URL: http://svn.apache.org/r1447756
Log:
BOOKKEEPER-548: Document about periodic ledger checker configuration (ivank)

Modified:
    zookeeper/bookkeeper/trunk/CHANGES.txt
    zookeeper/bookkeeper/trunk/bookkeeper-server/conf/bk_server.conf
    zookeeper/bookkeeper/trunk/bookkeeper-server/src/main/java/org/apache/bookkeeper/conf/ServerConfiguration.java
    zookeeper/bookkeeper/trunk/doc/bookkeeperConfig.textile

Modified: zookeeper/bookkeeper/trunk/CHANGES.txt
URL: http://svn.apache.org/viewvc/zookeeper/bookkeeper/trunk/CHANGES.txt?rev=1447756&r1=1447755&r2=1447756&view=diff
==============================================================================
--- zookeeper/bookkeeper/trunk/CHANGES.txt (original)
+++ zookeeper/bookkeeper/trunk/CHANGES.txt Tue Feb 19 15:15:47 2013
@@ -11,6 +11,8 @@ Trunk (unreleased changes)
     BUGFIXES:
       bookkeeper-server:
 
+        BOOKKEEPER-548: Document about periodic ledger checker configuration (ivank)
+
         BOOKKEEPER-561: Findbugs report errors with openjdk (ivank via umamahesh)
 
         BOOKKEEPER-554: fd leaking when move ledger index file (sijie, ivank via sijie)

Modified: zookeeper/bookkeeper/trunk/bookkeeper-server/conf/bk_server.conf
URL: http://svn.apache.org/viewvc/zookeeper/bookkeeper/trunk/bookkeeper-server/conf/bk_server.conf?rev=1447756&r1=1447755&r2=1447756&view=diff
==============================================================================
--- zookeeper/bookkeeper/trunk/bookkeeper-server/conf/bk_server.conf (original)
+++ zookeeper/bookkeeper/trunk/bookkeeper-server/conf/bk_server.conf Tue Feb 19 15:15:47 2013
@@ -177,3 +177,10 @@ zkTimeout=10000
 #Disk check interval in milli seconds, interval to check the ledger dirs usage.
 #Default is 10000
 #diskCheckInterval=10000
+
+# Interval at which the auditor will do a check of all ledgers in the cluster.
+# By default this runs once a week. The interval is set in seconds.
+# To disable the periodic check completely, set this to 0.
+# Note that periodic checking will put extra load on the cluster, so it should
+# not be run more frequently than once a day.
+#auditorPeriodicCheckInterval=604800

Modified: zookeeper/bookkeeper/trunk/bookkeeper-server/src/main/java/org/apache/bookkeeper/conf/ServerConfiguration.java
URL: http://svn.apache.org/viewvc/zookeeper/bookkeeper/trunk/bookkeeper-server/src/main/java/org/apache/bookkeeper/conf/ServerConfiguration.java?rev=1447756&r1=1447755&r2=1447756&view=diff
==============================================================================
--- zookeeper/bookkeeper/trunk/bookkeeper-server/src/main/java/org/apache/bookkeeper/conf/ServerConfiguration.java
(original)
+++ zookeeper/bookkeeper/trunk/bookkeeper-server/src/main/java/org/apache/bookkeeper/conf/ServerConfiguration.java
Tue Feb 19 15:15:47 2013
@@ -650,7 +650,8 @@ public class ServerConfiguration extends
     /**
      * Set the regularity at which the auditor will run a check
      * of all ledgers. This should not be run very often, and at most,
-     * once a day.
+     * once a day. Setting this to 0 will completely disable the periodic
+     * check.
      *
      * @param interval The interval in seconds. e.g. 86400 = 1 day, 604800 = 1 week
      */
@@ -660,10 +661,10 @@ public class ServerConfiguration extends
 
     /**
      * Get the regularity at which the auditor checks all ledgers.
-     * @return The interval in seconds
+     * @return The interval in seconds. Default is 604800 (1 week).
      */
     public long getAuditorPeriodicCheckInterval() {
-        return getLong(AUDITOR_PERIODIC_CHECK_INTERVAL, 86400);
+        return getLong(AUDITOR_PERIODIC_CHECK_INTERVAL, 604800);
     }
 
     /**

Modified: zookeeper/bookkeeper/trunk/doc/bookkeeperConfig.textile
URL: http://svn.apache.org/viewvc/zookeeper/bookkeeper/trunk/doc/bookkeeperConfig.textile?rev=1447756&r1=1447755&r2=1447756&view=diff
==============================================================================
--- zookeeper/bookkeeper/trunk/doc/bookkeeperConfig.textile (original)
+++ zookeeper/bookkeeper/trunk/doc/bookkeeperConfig.textile Tue Feb 19 15:15:47 2013
@@ -124,10 +124,13 @@ Configuration parameters for autorecover
 
 Important parameters are:
 
+* @auditorPeriodicCheckInterval@, interval at which the auditor will do a check of all ledgers
in the cluster. By default this runs once a week. The interval is set in seconds. To disable
the periodic check completely, set this to 0. Note that periodic checking will put extra load
on the cluster, so it should not be run more frequently than once a day.
+
 * @rereplicationEntryBatchSize@ specifies the number of entries which a replication will
rereplicate in parallel. The default value is 10. A larger value for this parameter will increase
the speed at which autorecovery occurs but will increate the memory requirement of the autorecovery
process, and create more load on the cluster.
 
 * @openLedgerRereplicationGracePeriod@, is the amount of time, in milliseconds, which a recovery
worker will wait before recovering a ledger segment which has no defined ended, i.e. the client
is still writing to that segment. If the client is still active, it should detect the bookie
failure, and start writing to a new ledger segment, and a new ensemble, which doesn't include
the failed bookie. Creating new ledger segment will define the end of the previous segment.
If, after the grace period, the ledger segment's end has not been defined, we assume the writing
client has crashed. The ledger is fenced and the client is blocked from writing any more entries
to the ledger. The default value is 30000ms.
 
+
 h3. Disabling Autorecovery during maintenance
 
 It is useful to disable autorecovery during maintenance, for example, to avoid a Bookie's
data being unnecessarily rereplicated when it is only being taken down for a short period
to update the software, or change the configuration.



Mime
View raw message