Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 6A731200CED for ; Fri, 4 Aug 2017 07:50:53 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 67FE416D1DB; Fri, 4 Aug 2017 05:50:53 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id BDD2116D1DA for ; Fri, 4 Aug 2017 07:50:47 +0200 (CEST) Received: (qmail 87435 invoked by uid 500); 4 Aug 2017 05:50:46 -0000 Mailing-List: contact commits-help@bookkeeper.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: bookkeeper-dev@bookkeeper.apache.org Delivered-To: mailing list commits@bookkeeper.apache.org Received: (qmail 87425 invoked by uid 99); 4 Aug 2017 05:50:46 -0000 Received: from ec2-52-202-80-70.compute-1.amazonaws.com (HELO gitbox.apache.org) (52.202.80.70) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 04 Aug 2017 05:50:46 +0000 Received: by gitbox.apache.org (ASF Mail Server at gitbox.apache.org, from userid 33) id 7348D81650; Fri, 4 Aug 2017 05:50:43 +0000 (UTC) Date: Fri, 04 Aug 2017 05:50:43 +0000 To: "commits@bookkeeper.apache.org" Subject: [bookkeeper] branch asf-site updated: Updated site at revision 423fa65 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Message-ID: <150182584357.4415.1842099169847752369@gitbox.apache.org> From: git-site-role@apache.org Reply-To: "commits@bookkeeper.apache.org" X-Git-Host: gitbox.apache.org X-Git-Repo: bookkeeper X-Git-Refname: refs/heads/asf-site X-Git-Reftype: branch X-Git-Oldrev: 3607cb73bc8a2e2ed98f5f8d2b60921c69bc4bca X-Git-Newrev: c1091582a04b9cb817dfe3a17979fc9ecfb326da X-Git-Rev: c1091582a04b9cb817dfe3a17979fc9ecfb326da X-Git-NotificationType: ref_changed_plus_diff X-Git-Multimail-Version: 1.5.dev Auto-Submitted: auto-generated archived-at: Fri, 04 Aug 2017 05:50:53 -0000 This is an automated email from the ASF dual-hosted git repository. git-site-role pushed a commit to branch asf-site in repository https://gitbox.apache.org/repos/asf/bookkeeper.git The following commit(s) were added to refs/heads/asf-site by this push: new c109158 Updated site at revision 423fa65 c109158 is described below commit c1091582a04b9cb817dfe3a17979fc9ecfb326da Author: jenkins AuthorDate: Fri Aug 4 05:50:41 2017 +0000 Updated site at revision 423fa65 --- content/community/contributing/index.html | 22 +- content/community/mailing-lists/index.html | 22 +- content/community/slack/index.html | 22 +- content/docs/admin/autorecovery/index.html | 22 +- content/docs/admin/bookies/index.html | 22 +- content/docs/admin/geo-replication/index.html | 22 +- content/docs/admin/metrics/index.html | 22 +- content/docs/admin/perf/index.html | 22 +- content/docs/admin/placement/index.html | 22 +- content/docs/api/distributedlog-api/index.html | 22 +- content/docs/api/ledger-api/index.html | 22 +- content/docs/api/overview/index.html | 22 +- content/docs/deployment/dcos/index.html | 22 +- content/docs/deployment/kubernetes/index.html | 22 +- content/docs/deployment/manual/index.html | 22 +- content/docs/development/codebase/index.html | 22 +- content/docs/development/protocol/index.html | 22 +- content/docs/example/index.html | 22 +- content/docs/getting-started/concepts/index.html | 22 +- .../docs/getting-started/installation/index.html | 22 +- .../docs/getting-started/run-locally/index.html | 22 +- content/docs/reference/cli/index.html | 409 +++++++++++--- content/docs/reference/config/index.html | 367 +++++++++++- content/docs/reference/metrics/index.html | 22 +- content/index.html | 22 +- content/javadoc/allclasses-frame.html | 1 + content/javadoc/allclasses-noframe.html | 1 + content/javadoc/constant-values.html | 185 +++--- content/javadoc/index-all.html | 20 +- .../bookkeeper/conf/ServerConfiguration.html | 619 ++++++++++++--------- .../conf/class-use/ServerConfiguration.html | 160 +++--- .../bookkeeper/stats/PrometheusStatsLogger.html | 4 +- .../stats/{Stats.html => PrometheusUtil.html} | 137 ++--- .../javadoc/org/apache/bookkeeper/stats/Stats.html | 4 +- .../bookkeeper/stats/class-use/PrometheusUtil.html | 125 +++++ .../org/apache/bookkeeper/stats/package-frame.html | 1 + .../apache/bookkeeper/stats/package-summary.html | 6 + .../org/apache/bookkeeper/stats/package-tree.html | 1 + content/javadoc/overview-tree.html | 1 + content/project/bylaws/index.html | 22 +- content/project/privacy/index.html | 22 +- content/project/who/index.html | 22 +- content/releases/index.html | 22 +- 43 files changed, 1703 insertions(+), 932 deletions(-) diff --git a/content/community/contributing/index.html b/content/community/contributing/index.html index ddee820..3826292 100644 --- a/content/community/contributing/index.html +++ b/content/community/contributing/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/community/mailing-lists/index.html b/content/community/mailing-lists/index.html index 93f8778..b08c022 100644 --- a/content/community/mailing-lists/index.html +++ b/content/community/mailing-lists/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/community/slack/index.html b/content/community/slack/index.html index 3665126..2cebe7e 100644 --- a/content/community/slack/index.html +++ b/content/community/slack/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/admin/autorecovery/index.html b/content/docs/admin/autorecovery/index.html index 457ba7a..ef2a735 100644 --- a/content/docs/admin/autorecovery/index.html +++ b/content/docs/admin/autorecovery/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/admin/bookies/index.html b/content/docs/admin/bookies/index.html index 190ba76..8908ed1 100644 --- a/content/docs/admin/bookies/index.html +++ b/content/docs/admin/bookies/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/admin/geo-replication/index.html b/content/docs/admin/geo-replication/index.html index dd4509f..190db57 100644 --- a/content/docs/admin/geo-replication/index.html +++ b/content/docs/admin/geo-replication/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/admin/metrics/index.html b/content/docs/admin/metrics/index.html index aff91ef..6e19492 100644 --- a/content/docs/admin/metrics/index.html +++ b/content/docs/admin/metrics/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/admin/perf/index.html b/content/docs/admin/perf/index.html index a2d6fee..210804a 100644 --- a/content/docs/admin/perf/index.html +++ b/content/docs/admin/perf/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/admin/placement/index.html b/content/docs/admin/placement/index.html index 4a1971a..b578f64 100644 --- a/content/docs/admin/placement/index.html +++ b/content/docs/admin/placement/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/api/distributedlog-api/index.html b/content/docs/api/distributedlog-api/index.html index 0b56d73..fbf6308 100644 --- a/content/docs/api/distributedlog-api/index.html +++ b/content/docs/api/distributedlog-api/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/api/ledger-api/index.html b/content/docs/api/ledger-api/index.html index 798c365..8005d75 100644 --- a/content/docs/api/ledger-api/index.html +++ b/content/docs/api/ledger-api/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/api/overview/index.html b/content/docs/api/overview/index.html index b921450..8497266 100644 --- a/content/docs/api/overview/index.html +++ b/content/docs/api/overview/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/deployment/dcos/index.html b/content/docs/deployment/dcos/index.html index 9dea7d0..7c32c8c 100644 --- a/content/docs/deployment/dcos/index.html +++ b/content/docs/deployment/dcos/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/deployment/kubernetes/index.html b/content/docs/deployment/kubernetes/index.html index 0d497ad..4728aac 100644 --- a/content/docs/deployment/kubernetes/index.html +++ b/content/docs/deployment/kubernetes/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/deployment/manual/index.html b/content/docs/deployment/manual/index.html index 2892514..3af82ab 100644 --- a/content/docs/deployment/manual/index.html +++ b/content/docs/deployment/manual/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/development/codebase/index.html b/content/docs/development/codebase/index.html index 62cf3ca..cc047f7 100644 --- a/content/docs/development/codebase/index.html +++ b/content/docs/development/codebase/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/development/protocol/index.html b/content/docs/development/protocol/index.html index 574c9c0..e922d7c 100644 --- a/content/docs/development/protocol/index.html +++ b/content/docs/development/protocol/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/example/index.html b/content/docs/example/index.html index 7034843..da3d6cc 100644 --- a/content/docs/example/index.html +++ b/content/docs/example/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/getting-started/concepts/index.html b/content/docs/getting-started/concepts/index.html index 5bebaec..e38a535 100644 --- a/content/docs/getting-started/concepts/index.html +++ b/content/docs/getting-started/concepts/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/getting-started/installation/index.html b/content/docs/getting-started/installation/index.html index 4cada70..a04127e 100644 --- a/content/docs/getting-started/installation/index.html +++ b/content/docs/getting-started/installation/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/getting-started/run-locally/index.html b/content/docs/getting-started/run-locally/index.html index f36f7cf..0f564fb 100644 --- a/content/docs/getting-started/run-locally/index.html +++ b/content/docs/getting-started/run-locally/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 diff --git a/content/docs/reference/cli/index.html b/content/docs/reference/cli/index.html index 79e5f38..c6afbb0 100644 --- a/content/docs/reference/cli/index.html +++ b/content/docs/reference/cli/index.html @@ -73,57 +73,57 @@
- + Release 4.4.0 Stable - + Release 4.3.2 - + Release 4.3.1 - + Release 4.3.0 - + Release 4.2.4 - + Release 4.2.3 - + Release 4.2.2 - + Release 4.2.1 - + Release 4.2.0 - + Release 4.1.0 - + Release 4.0.0 @@ -503,6 +503,8 @@

autorecovery

+

Enable or disable autorecovery in the cluster.

+
Usage
$ bookkeeper-server/bin/bookkeeper shell autorecovery \
@@ -523,12 +525,12 @@
     
     
       -enable
-      Enables autorecovery
+      Enable autorecovery of underreplicated ledgers
     
     
     
       -disable
-      Disables autorecovery
+      Disable autorecovery of underreplicated ledgers
     
     
   
@@ -538,6 +540,8 @@
 
 
bookieFormat

 
+
Format the current server contents.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell bookieFormat \
@@ -558,17 +562,17 @@
     
     
       -nonInteractive
-      
+      Whether to confirm if old data exists.
     
     
     
       -force
-      
+      If [nonInteractive] is specified, then whether to force delete the old data without prompt..?
     
     
     
       -deleteCookie
-      
+      Delete its cookie on zookeeper
     
     
   
@@ -576,8 +580,23 @@
 

 

 
+
bookieinfo

+
+
Retrieve bookie info such as free and total disk space.

+
+
Usage

+
+
$ bookkeeper-server/bin/bookkeeper shell bookieinfo
+

+

+
+

+

+
 
bookiesanity

 
+
Sanity test for local bookie. Create ledger and write/read entries on the local bookie.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell bookiesanity \
@@ -598,12 +617,62 @@
     
     
       -entries N
-      
+      Total entries to be added for the test (default 10)
     
     
     
       -timeout N
-      
+      Timeout for write/read operations in seconds (default 1)
+    
+    
+  
+
+

+

+
+
decommissionbookie

+
+
Force trigger the Audittask and make sure all the ledgers stored in the decommissioning bookie are replicated.

+
+
Usage

+
+
$ bookkeeper-server/bin/bookkeeper shell decommissionbookie
+

+

+
+

+

+
+
deleteledger

+
+
Delete a ledger

+
+
Usage

+
+
$ bookkeeper-server/bin/bookkeeper shell deleteledger \
+  <options>
+

+

+
+
Options

+
+
+  
+    
+      
+      
+    
+  
+  
+    
+    
+      
+      
+    
+    
+    
+      
+      
@@ -611,6 +680,19 @@
 

 
+
expandstorage

+
+
Add new empty ledger/index directories. Update the directories info in the conf file before running the command.

+
+
Usage

+
+
$ bookkeeper-server/bin/bookkeeper shell expandstorage
+

+

+
+

+

+
 
help
Displays the help message.

@@ -626,6 +708,8 @@
 
 
lastmark

 
+
Print last log marker.

+
 
Usage
$ bookkeeper-server/bin/bookkeeper shell lastmark
@@ -637,6 +721,8 @@
 
 
ledger

 
+
Dump ledger index entries into readable format.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell ledger \
@@ -657,7 +743,7 @@
     
     

-      
+      
@@ -667,6 +753,8 @@
 
 
ledgermetadata

 
+
Print the metadata for a ledger.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell ledgermetadata \
@@ -686,8 +774,8 @@
   

-      
-      
+      
+      
@@ -697,6 +785,8 @@
 
 
listbookies

 
+
List the bookies, which are running as either readwrite or readonly mode.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell listbookies \
@@ -717,17 +807,59 @@
     
     

-      
+      
-      
+      
-      
+      
+    
+    
+  
+
FlagDescription
-ledgerid NLedger ID
-forceWhether to force delete the Ledger without prompt..?
     

     
   
 
 
 
 
 

       -m LEDGER_IDPrint meta information
     

     
   
     
     
-ledgerid LEDGER_ID-ledgerid NLedger ID
     

     
   

       -readwritePrint readwrite bookies
     

     
     

       -readonlyPrint readonly bookies
     

     
     

       -hostnamesAlso print hostname of the bookie

+

+

+
+
listfilesondisc

+
+
List the files in JournalDirectory/LedgerDirectories/IndexDirectories.

+
+
Usage

+
+
$ bookkeeper-server/bin/bookkeeper shell listfilesondisc \
+  <options>
+

+

+
+
Options

+
+
+  
+    
+      
+      
+    
+  
+  
+    
+    
+      
+      
+    
+    
+    
+      
+      
+    
+    
+    
+      
+      
@@ -737,6 +869,8 @@
 
 
listledgers

 
+
List all ledgers in the cluster (this may take a long time).

+
 
Usage
$ bookkeeper-server/bin/bookkeeper shell listledgers \
@@ -757,7 +891,7 @@
     
     

-      
+      
@@ -767,17 +901,45 @@
 
 
listunderreplicated

 
+
List ledgers marked as underreplicated, with optional options to specify missing replica (BookieId) and to exclude missing replica.

+
 
Usage

 
-
$ bookkeeper-server/bin/bookkeeper shell listunderreplicated
+
$ bookkeeper-server/bin/bookkeeper shell listunderreplicated \
+  <options>
 

 

 
+
Options

+
+
FlagDescription
-journalPrint list of journal files
-entrylogPrint list of entryLog files
-indexPrint list of index files
     

     
   
 
 

       -metaPrint metadata
     

     
   

+  
+    
+      
+      
+    
+  
+  
+    
+    
+      
+      
+    
+    
+    
+      
+      
+    
+    
+  
+
FlagDescription
-missingreplica NBookie Id of missing replica
-excludingmissingreplica NBookie Id of missing replica to ignore

 

 

 
 
metaformat

 
+
Format Bookkeeper metadata in Zookeeper.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell metaformat \
@@ -798,12 +960,49 @@
     
     
       -nonInteractive
-      
+      Whether to confirm if old data exists..?
     
     
     
       -force
-      
+      If [nonInteractive] is specified, then whether to force delete the old data without prompt.
+    
+    
+  
+
+

+

+
+
lostbookierecoverydelay

+
+
Setter and Getter for LostBookieRecoveryDelay value (in seconds) in Zookeeper.

+
+
Usage

+
+
$ bookkeeper-server/bin/bookkeeper shell lostbookierecoverydelay \
+  <options>
+

+

+
+
Options

+
+
+  
+    
+      
+      
+    
+  
+  
+    
+    
+      
+      
+    
+    
+    
+      
+      
@@ -813,6 +1012,8 @@
 
 
readjournal

 
+
Scan a journal file and format the entries into readable format.

+
 
Usage
$ bookkeeper-server/bin/bookkeeper shell readjournal \
@@ -833,7 +1034,12 @@
     
     

-      
+      
+    
+    
+    
+      
+      
@@ -843,6 +1049,8 @@
 
 
readledger

 
+
Read a range of entries from a ledger.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell readledger \
@@ -855,6 +1063,8 @@
 
 
readlog

 
+
Scan an entry file and format the entries into readable format.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell readlog \
@@ -876,7 +1086,27 @@
     
     

-      
+      
+    
+    
+    
+      
+      
+    
+    
+    
+      
+      
+    
+    
+    
+      
+      
+    
+    
+    
+      
+      
@@ -886,10 +1116,12 @@
 
 
recover

 
+
Recover the ledger data for failed bookie.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell recover \
-  <bookieSrc> [bookieDest] \
+  <bookieSrc> [<bookieDest>] \
   <options>
 

 

@@ -907,7 +1139,7 @@
     
     
-      
+      
@@ -917,6 +1149,8 @@
 
 
simpletest

 
+
Simple test to create a ledger and write entries to it.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell simpletest \
@@ -937,22 +1171,22 @@
     
     

-      
+      
-      
+      
-      
+      
-      
+      
@@ -960,8 +1194,23 @@
 

 

 
+
triggeraudit

+
+
Force trigger the Audit by resetting the lostBookieRecoveryDelay.

+
+
Usage

+
+
$ bookkeeper-server/bin/bookkeeper shell triggeraudit
+

+

+
+

+

+
 
updatecookie

 
+
Update bookie id in cookie.

+
 
Usage

 
 
$ bookkeeper-server/bin/bookkeeper shell updatecookie \
@@ -982,7 +1231,7 @@
     
     

-      
+      
@@ -990,11 +1239,13 @@
 

 

 
-
updateledger

+
updateledgers

+
+
Update bookie id in ledgers (this may take a long time).

 
 
Usage

 
-
$ bookkeeper-server/bin/bookkeeper shell updateledger \
+
$ bookkeeper-server/bin/bookkeeper shell updateledgers \
   <options>
 

 

@@ -1012,27 +1263,27 @@
     
     

-      
+      
-      
+      
-      
+      
-      
+      
-      
+      
@@ -1076,50 +1327,68 @@
 
  • bookieFormat
    • 
 
  • Usage
    • 
 
  • Options
    • 
-
  • bookiesanity
    • 
+
  • bookieinfo
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • help
    • 
+
  • bookiesanity
    • 
 
  • Usage
    • 
-
  • lastmark
    • 
+
  • Options
    • 
+
  • decommissionbookie
    • 
 
  • Usage
    • 
-
  • ledger
    • 
+
  • deleteledger
    • 
 
  • Usage
    • 
 
  • Options
    • 
-
  • ledgermetadata
    • 
+
  • expandstorage
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • listbookies
    • 
+
  • help
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • listledgers
    • 
+
  • lastmark
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • listunderreplicated
    • 
+
  • ledger
    • 
 
  • Usage
    • 
-
  • metaformat
    • 
+
  • Options
    • 
+
  • ledgermetadata
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • readjournal
    • 
+
  • Options
    • 
+
  • listbookies
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • readledger
    • 
+
  • Options
    • 
+
  • listfilesondisc
    • 
 
  • Usage
    • 
-
  • readlog
    • 
+
  • Options
    • 
+
  • listledgers
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • recover
    • 
+
  • Options
    • 
+
  • listunderreplicated
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • simpletest
    • 
+
  • Options
    • 
+
  • metaformat
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • updatecookie
    • 
+
  • Options
    • 
+
  • lostbookierecoverydelay
    • 
 
  • Usage
    • 
-
  • Options
    • 
-
  • updateledger
    • 
+
  • Options
    • 
+
  • readjournal
    • 
 
  • Usage
    • 
+
  • Options
    • 
+
  • readledger
    • 
+
  • Usage
    • 
+
  • readlog
    • 
+
  • Usage
    • 
 
  • Options
    • 
+
  • recover
    • 
+
  • Usage
    • 
+
  • Options
    • 
+
  • simpletest
    • 
+
  • Usage
    • 
+
  • Options
    • 
+
  • triggeraudit
    • 
+
  • Usage
    • 
+
  • updatecookie
    • 
+
  • Usage
    • 
+
  • Options
    • 
+
  • updateledgers
    • 
+
  • Usage
    • 
+
  • Options
    • 
 
 
 
diff --git a/content/docs/reference/config/index.html b/content/docs/reference/config/index.html
index 3e66820..a78df3e 100644
--- a/content/docs/reference/config/index.html
+++ b/content/docs/reference/config/index.html
@@ -73,57 +73,57 @@
           
           
    
           
-          
+          
             Release 4.4.0
             Stable
           
           
-          
+          
             Release 4.3.2
             
           
           
-          
+          
             Release 4.3.1
             
           
           
-          
+          
             Release 4.3.0
             
           
           
-          
+          
             Release 4.2.4
             
           
           
-          
+          
             Release 4.2.3
             
           
           
-          
+          
             Release 4.2.2
             
           
           
-          
+          
             Release 4.2.1
             
           
           
-          
+          
             Release 4.2.0
             
           
           
-          
+          
             Release 4.1.0
             
           
           
-          
+          
             Release 4.0.0
             
           
@@ -391,6 +391,16 @@
           
     
+    
+      
+      
+      
+    
+    
     
     
+    
+      
+      
+      
+    
+    
     
     
+    
+      
+      
+      
+    
+    
     
     
+    
+      
+      
+      
+    
+    
     
     
-    
-      
-      
+      
+      
-      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
@@ -506,6 +574,134 @@ interface (the interface it uses to establish its identity). By default, loopbac
 
       
+    
+    
+      
+      
+      
+    
+     
+  
+
    FlagDescription
    -getGet LostBookieRecoveryDelay value (in seconds)
    -set NSet LostBookieRecoveryDelay value (in seconds)
     
    
     
       
 
 
    
       -msg JOURNAL_ID|JOURNAL_FILENAMEPrint message body
    -dirJournal directory (needed if more than one journal configured)
     
    
     
   
    
       -msgPrint message body
    -ledgerid NLedger ID
    -entryid NEntry ID
    -startpos NStart Position
    -endposEnd Position
     
    
     
   
    
       -deleteCookieDelete cookie node for the bookie.
     
    
     
   
    
       -ensemble NEnsemble size (default 3)
     
    
     
     
    
       -writeQuorum NWrite quorum size (default 2)
     
    
     
     
    
       ackQuorum NAck quorum size (default 2)
     
    
     
     
    
       -numEntries NEntries to write (default 1000)
     
    
     
   
    
       -bookieId <hostname|ip>Bookie Id
     
    
     
   
    
       -bookieId <hostname|ip>Bookie Id
     
    
     
     
    
       -updatespersec NNumber of ledgers updating per second (default 5 per sec)
     
    
     
     
    
       -limit NMaximum number of ledgers to update (default no limit)
     
    
     
     
    
       -verbosePrint status of the ledger updation (default false)
     
    
     
     
    
       -printprogress NPrint messages on every configured seconds if verbose turned on (default 10 secs)
     
    
     
   
    3181
     
    journalDirectories
    The directories to which Bookkeeper outputs its write-ahead log (WAL).  Could define multi directories to store write head logs, separated by ‘,’.
+For example:
+  journalDirectories=/tmp/bk-journal1,/tmp/bk-journal2
+If journalDirectories is set, bookies will skip journalDirectory and use this setting directory.
    
+    		/tmp/bk-journal
    
       journalDirectory
       
    The directory to which Bookkeeper outputs its write-ahead log (WAL).
    
@@ -398,6 +408,13 @@
           		/tmp/bk-txn
     
    allowMultipleDirsUnderSameDiskPartition
    Configure the bookie to allow/disallow multiple ledger/index/journal directories in the same filesystem disk partition
    
+
    
       indexDirectories
       
    The directories in which index files are stored. If not specified, the value of ledgerDirectories will be used.
    
@@ -405,6 +422,13 @@
           		/tmp/bk-data
     
    minUsableSizeForIndexFileCreation
    Minimum safe usable size to be available in index directory for bookie to create index file while replaying journal at the time of bookie start in readonly mode (in bytes)
    
+    		1073741824
    
       listeningInterface
       
    The network interface that the bookie should listen on. If not set, the bookie will listen on all interfaces.
    
@@ -412,6 +436,15 @@
           		eth0
     
    advertisedAddress
    Configure a specific hostname or IP address that the bookie should use to advertise itself to
+clients. If not set, bookie will advertised its own IP address or hostname, depending on the
+listeningInterface and useHostNameAsBookieID settings.
    
+    		eth0
    
       allowLoopback
       
    Whether the bookie is allowed to use a loopback interface as its primary
@@ -457,11 +490,46 @@ interface (the interface it uses to establish its identity). By default, loopbac
       
    		1
     
    lostBookieRecoveryDelay
    How long to wait, in seconds, before starting autorecovery of a lost bookie.
    
+    
    allowEphemeralPorts
    Whether the bookie is allowed to use an ephemeral port (port 0) as its server port. By default, an ephemeral port is not allowed. Using an ephemeral port as the service port usually indicates a configuration error. However, in unit tests, using an ephemeral port will address port conflict problems and allow running tests in parallel.
    
     		0false
    enableLocalTransport
    Whether allow the bookie to listen for BookKeeper clients executed on the local JVM.
    
+    		false
    disableServerSocketBind
    Whether allow the bookie to disable bind on network interfaces, this bookie will be available only to BookKeeper clients executed on the local JVM.
    
+    		false
    skipListArenaChunkSize
    The number of bytes we should use as chunk allocation for org.apache.bookkeeper.bookie.SkipListArena
    
+    		4194304
    skipListArenaMaxAllocSize
    The max size we should allocate from the skiplist arena. Allocations larger than this should be allocated directly by the VM to avoid fragmentation.
    
+    		131072
    bookieAuthProviderFactoryClass
    The bookie authentication provider factory class name. If this is null, no authentication will take place.
    
+    		
     
    
      
   
    1
     
    isForceGCAllowWhenNoSpace
    Whether force compaction is allowed when the disk is full or almost full. Forcing GC may get some space back, but may also fill up disk space more quickly. This is because new log files are created before GC, while old garbage log files are deleted after GC.
    
+    		false
    
+
+
    TSL settings
    
+
+
+  
+    
+      
+      
+      
+    
+  
+  
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+     
+  
+
    ParameterDescriptionDefault
    tslProvider
    TSL Provider (JDK or OpenSSL)
    
+    		OpenSSL
    tslProviderFactoryClass
    The path to the class that provides security.
    
+    		org.apache.bookkeeper.security.SSLContextFactory
    tslClientAuthentication
    Type of security used by server.
    
+    		true
    tslKeyStoreType
    Bookie Keystore type.
    
+    		JKS
    tslKeyStore
    Bookie Keystore location (path).
    
+
    tslKeyStore
    Bookie Keystore location (path).
    
+
    tslKeyStorePasswordPath
    Bookie Keystore password path, if the keystore is protected by a password.
    
+
    tslTrustStoreType
    Bookie Truststore type.
    
+
    tslTrustStore
    Bookie Truststore location (path).
    
+
    tslTrustStorePasswordPath
    Bookie Truststore password path, if the truststore is protected by a password.
    
+
    
+
+
    Long poll request parameter settings
    
+
+
+  
+    
+      
+      
+      
+    
+  
+  
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
+    
+    
+      
+      
+      
+    
    ParameterDescriptionDefault
    numLongPollWorkerThreads
    The number of threads that should handle long poll requests.
    
+    		10
    requestTimerTickDurationMs
    The tick duration in milliseconds for long poll requests.
    
+    		10
    requestTimerNumTicks
    The number of ticks per wheel for the long poll request timer.
    
+    		1024
    
      
       
 
    
@@ -542,6 +738,20 @@ interface (the interface it uses to establish its identity). By default, loopbac
 
       30
     
+    
+    
+      autoRecoveryDaemonEnabled
+      
    Whether the bookie itself can start auto-recovery service also or not.
    
+
+      
+    
+    
+    
+      lostBookieRecoveryDelay
+      
    How long to wait, in seconds, before starting autorecovery of a lost bookie.
    
+
+      0
+    
      
   
 
@@ -566,6 +776,41 @@ interface (the interface it uses to establish its identity). By default, loopbac
 
       true
     
+    
+    
+      serverSockKeepalive
+      
    This setting is used to send keep-alive messages on connection-oriented sockets.
    
+
+      true
+    
+    
+    
+      serverTcpLinger
+      
    The socket linger timeout on close. When enabled, a close or shutdown will not return until all queued messages for the socket have been successfully sent or the linger timeout has been reached. Otherwise, the call returns immediately and the closing is done in the background.
    
+
+      0
+    
+    
+    
+      byteBufAllocatorSizeInitial
+      
    The Recv ByteBuf allocator initial buf size.
    
+
+      65536
+    
+    
+    
+      byteBufAllocatorSizeMin
+      
    The Recv ByteBuf allocator min buf size.
    
+
+      65536
+    
+    
+    
+      byteBufAllocatorSizeMax
+      
    The Recv ByteBuf allocator max buf size.
    
+
+      1048576
+    
      
   
 
@@ -582,6 +827,22 @@ interface (the interface it uses to establish its identity). By default, loopbac
   
   
     
+    
+      journalFormatVersionToWrite
+      
    The journal format version to write.
+Available formats are 1-5:
+ 1: no header
+ 2: a header section was added
+ 3: ledger key was introduced
+ 4: fencing key was introduced
+ 5: expanding header to 512 and padding writes to align sector size configured by journalAlignmentSize
    
+
+
    By default, it is 4. If you’d like to enable padding-writes feature, you can set journal version to 5.
+You can disable padding-writes by setting journal version back to 4. This feature is available in 4.5.0 and onward versions.
    
+
+      4
+    
+    
     
       journalMaxSizeMB
       
    Max file size of journal file, in mega bytes. A new journal file will be created when the old one reaches the file size limitation.
    
@@ -651,6 +912,27 @@ interface (the interface it uses to establish its identity). By default, loopbac
 
       1
     
+    
+    
+      journalAlignmentSize
+      
    All the journal writes and commits should be aligned to given size. If not, zeros will be padded to align to given size.
    
+
+      512
+    
+    
+    
+      journalBufferedEntriesThreshold
+      
    Maximum entries to buffer to impose on a journal write to achieve grouping.
    
+
+      0
+    
+    
+    
+      journalFlushWhenQueueEmpty
+      
    If we should flush the journal when journal queue is empty.
    
+
+      false
+    
      
   
 
@@ -689,6 +971,20 @@ interface (the interface it uses to establish its identity). By default, loopbac
 
       604800
     
+    
+    
+      sortedLedgerStorageEnabled
+      
    Whether sorted-ledger storage enabled (default true)
    
+
+      true
+    
+    
+    
+      skipListSizeLimit
+      
    The skip list data size limitation (default 64MB) in EntryMemTable
    
+
+      67108864L
+    
      
   
 
@@ -750,7 +1046,7 @@ interface (the interface it uses to establish its identity). By default, loopbac
     
     
       zkLedgersRootPath
-      
    Root zookeeper path to store ledger metadata. This parameter is used by zookeeper-based ledger manager as a root znode to store all ledgers.
    
+      
    Root Zookeeper path to store ledger metadata. This parameter is used by zookeeper-based ledger manager as a root znode to store all ledgers.
    
 
       /ledgers
     
@@ -933,6 +1229,13 @@ interface (the interface it uses to establish its identity). By default, loopbac
 
       false
     
+    
+    
+      forceReadOnlyBookie
+      
    Whether the bookie is force started in read only mode or not.
    
+
+      false
+    
      
   
 
@@ -963,6 +1266,13 @@ interface (the interface it uses to establish its identity). By default, loopbac
       0.9
     
     
+    
+      diskUsageWarnThreshold
+      
    The disk free space low water mark threshold. Disk is considered full when usage threshold is exceeded. Disk returns back to non-full state when usage is below low water mark threshold. This prevents it from going back and forth between these states frequently when concurrent writes and compaction are happening. This also prevent bookie from switching frequently between read-only and read-writes states in the same cases.
    
+
+      0.95
+    
+    
     
       diskCheckInterval
       
    Disk check interval in milliseconds. Interval to check the ledger dirs usage.
    
@@ -987,7 +1297,7 @@ interface (the interface it uses to establish its identity). By default, loopbac
     
     
       zkServers
-      
    A list of one of more servers on which zookeeper is running. The server list can be comma separated values, for example zkServers=zk1:2181,zk2:2181,zk3:2181.
    
+      
    A list of one of more servers on which Zookeeper is running. The server list can be comma separated values, for example zkServers=zk1:2181,zk2:2181,zk3:2181.
    
 
       localhost:2181
     
@@ -998,6 +1308,27 @@ interface (the interface it uses to establish its identity). By default, loopbac
 
       10
     
+    
+    
+      zkRetryBackoffStartMs
+      
    The Zookeeper client backoff retry start time in millis.
    
+
+      1000
+    
+    
+    
+      zkRetryBackoffMaxMs
+      
    The Zookeeper client backoff retry max time in millis.
    
+
+      10000
+    
+    
+    
+      zkEnableSecurity
+      
    Set ACLs on every node written on ZooKeeper, this way only allowed users will be able to read and write BookKeeper metadata stored on ZooKeeper. In order to make ACLs work you need to setup ZooKeeper JAAS authentication all the bookies and Client need to share the same user, and this is usually done using Kerberos authentication. See ZooKeeper documentation
    
+
+      false
+    
      
   
 
@@ -1017,6 +1348,8 @@ interface (the interface it uses to establish its identity). By default, loopbac
   
 
diff --git a/content/javadoc/overview-tree.html b/content/javadoc/overview-tree.html
index 8c914a9..ab74e49 100644
--- a/content/javadoc/overview-tree.html
+++ b/content/javadoc/overview-tree.html
@@ -231,6 +231,7 @@
 
  • org.apache.bookkeeper.stats.PrometheusMetricsProvider (implements org.apache.bookkeeper.stats.StatsProvider)
    • 
 
  • org.apache.bookkeeper.stats.PrometheusOpStatsLogger (implements org.apache.bookkeeper.stats.OpStatsLogger)
    • 
 
  • org.apache.bookkeeper.stats.PrometheusStatsLogger (implements org.apache.bookkeeper.stats.StatsLogger)
    • 
+
  • org.apache.bookkeeper.stats.PrometheusUtil
    • 
 
  • org.apache.bookkeeper.client.RackawareEnsemblePlacementPolicyImpl.DefaultResolver (implements org.apache.bookkeeper.net.DNSToSwitchMapping)
    • 
 
  • org.apache.bookkeeper.client.ReadLastConfirmedAndEntryOp (implements org.apache.bookkeeper.proto.BookkeeperInternalCallbacks.ReadEntryCallback, org.apache.bookkeeper.client.SpeculativeRequestExecut [...]
 
  • org.apache.bookkeeper.client.ReadLastConfirmedOp (implements org.apache.bookkeeper.proto.BookkeeperInternalCallbacks.ReadEntryCallback)
    • 
diff --git a/content/project/bylaws/index.html b/content/project/bylaws/index.html
index 134bcc5..527850d 100644
--- a/content/project/bylaws/index.html
+++ b/content/project/bylaws/index.html
@@ -73,57 +73,57 @@
           
           
    
           
-          
+          
             Release 4.4.0
             Stable
           
           
-          
+          
             Release 4.3.2
             
           
           
-          
+          
             Release 4.3.1
             
           
           
-          
+          
             Release 4.3.0
             
           
           
-          
+          
             Release 4.2.4
             
           
           
-          
+          
             Release 4.2.3
             
           
           
-          
+          
             Release 4.2.2
             
           
           
-          
+          
             Release 4.2.1
             
           
           
-          
+          
             Release 4.2.0
             
           
           
-          
+          
             Release 4.1.0
             
           
           
-          
+          
             Release 4.0.0
             
           
diff --git a/content/project/privacy/index.html b/content/project/privacy/index.html
index d0a9319..7ef1ab5 100644
--- a/content/project/privacy/index.html
+++ b/content/project/privacy/index.html
@@ -73,57 +73,57 @@
           
           
    
           
-          
+          
             Release 4.4.0
             Stable
           
           
-          
+          
             Release 4.3.2
             
           
           
-          
+          
             Release 4.3.1
             
           
           
-          
+          
             Release 4.3.0
             
           
           
-          
+          
             Release 4.2.4
             
           
           
-          
+          
             Release 4.2.3
             
           
           
-          
+          
             Release 4.2.2
             
           
           
-          
+          
             Release 4.2.1
             
           
           
-          
+          
             Release 4.2.0
             
           
           
-          
+          
             Release 4.1.0
             
           
           
-          
+          
             Release 4.0.0
             
           
diff --git a/content/project/who/index.html b/content/project/who/index.html
index caf7983..8b1b520 100644
--- a/content/project/who/index.html
+++ b/content/project/who/index.html
@@ -73,57 +73,57 @@
           
           
    
           
-          
+          
             Release 4.4.0
             Stable
           
           
-          
+          
             Release 4.3.2
             
           
           
-          
+          
             Release 4.3.1
             
           
           
-          
+          
             Release 4.3.0
             
           
           
-          
+          
             Release 4.2.4
             
           
           
-          
+          
             Release 4.2.3
             
           
           
-          
+          
             Release 4.2.2
             
           
           
-          
+          
             Release 4.2.1
             
           
           
-          
+          
             Release 4.2.0
             
           
           
-          
+          
             Release 4.1.0
             
           
           
-          
+          
             Release 4.0.0
             
           
diff --git a/content/releases/index.html b/content/releases/index.html
index da723ce..27c9372 100644
--- a/content/releases/index.html
+++ b/content/releases/index.html
@@ -73,57 +73,57 @@
           
           
    
           
-          
+          
             Release 4.4.0
             Stable
           
           
-          
+          
             Release 4.3.2
             
           
           
-          
+          
             Release 4.3.1
             
           
           
-          
+          
             Release 4.3.0
             
           
           
-          
+          
             Release 4.2.4
             
           
           
-          
+          
             Release 4.2.3
             
           
           
-          
+          
             Release 4.2.2
             
           
           
-          
+          
             Release 4.2.1
             
           
           
-          
+          
             Release 4.2.0
             
           
           
-          
+          
             Release 4.1.0
             
           
           
-          
+          
             Release 4.0.0
             
           

-- 
To stop receiving notification emails like this one, please contact
['"commits@bookkeeper.apache.org" '].