You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@bookkeeper.apache.org by gi...@apache.org on 2018/02/03 00:49:11 UTC
[bookkeeper] branch asf-site updated: Updated site at revision
908972c
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 9b29376 Updated site at revision 908972c
9b29376 is described below
commit 9b2937677c93c27c4c51bc67af4f94bfdfb7a98b
Author: jenkins <bu...@apache.org>
AuthorDate: Sat Feb 3 00:49:09 2018 +0000
Updated site at revision 908972c
---
.../index.html | 5 +-
.../BP-21-new-api-close-inconsistencies/index.html | 10 +-
.../index.html | 15 +-
content/bps/BP-27-new-bookkeeper-cli/index.html | 15 +-
content/community/bookkeeper_proposals/index.html | 5 +-
content/community/contributing/index.html | 45 ++--
content/community/licensing/index.html | 5 +-
content/community/release_guide/index.html | 145 +++++-------
content/css/style.css | 254 ++++++++++-----------
content/docs/4.5.0/admin/autorecovery/index.html | 25 +-
content/docs/4.5.0/admin/bookies/index.html | 72 +++---
content/docs/4.5.0/api/ledger-adv-api/index.html | 20 +-
content/docs/4.5.0/api/ledger-api/index.html | 140 +++++-------
content/docs/4.5.0/deployment/dcos/index.html | 60 +++--
content/docs/4.5.0/deployment/manual/index.html | 15 +-
.../docs/4.5.0/getting-started/concepts/index.html | 15 +-
.../4.5.0/getting-started/installation/index.html | 23 +-
.../4.5.0/getting-started/run-locally/index.html | 5 +-
content/docs/4.5.0/reference/cli/index.html | 155 +++++--------
content/docs/4.5.0/security/sasl/index.html | 72 +++---
content/docs/4.5.0/security/tls/index.html | 69 +++---
content/docs/4.5.1/admin/autorecovery/index.html | 25 +-
content/docs/4.5.1/admin/bookies/index.html | 72 +++---
content/docs/4.5.1/api/ledger-adv-api/index.html | 20 +-
content/docs/4.5.1/api/ledger-api/index.html | 140 +++++-------
content/docs/4.5.1/deployment/dcos/index.html | 60 +++--
content/docs/4.5.1/deployment/manual/index.html | 15 +-
.../docs/4.5.1/getting-started/concepts/index.html | 15 +-
.../4.5.1/getting-started/installation/index.html | 23 +-
.../4.5.1/getting-started/run-locally/index.html | 5 +-
content/docs/4.5.1/reference/cli/index.html | 155 +++++--------
content/docs/4.5.1/security/sasl/index.html | 72 +++---
content/docs/4.5.1/security/tls/index.html | 69 +++---
content/docs/4.6.0/admin/autorecovery/index.html | 25 +-
content/docs/4.6.0/admin/bookies/index.html | 72 +++---
content/docs/4.6.0/admin/http/index.html | 119 +++++-----
content/docs/4.6.0/api/ledger-adv-api/index.html | 20 +-
content/docs/4.6.0/api/ledger-api/index.html | 190 +++++++--------
content/docs/4.6.0/deployment/dcos/index.html | 60 +++--
.../docs/4.6.0/deployment/kubernetes/index.html | 89 +++-----
content/docs/4.6.0/deployment/manual/index.html | 15 +-
.../docs/4.6.0/getting-started/concepts/index.html | 15 +-
.../4.6.0/getting-started/installation/index.html | 23 +-
.../4.6.0/getting-started/run-locally/index.html | 5 +-
content/docs/4.6.0/reference/cli/index.html | 155 +++++--------
content/docs/4.6.0/security/sasl/index.html | 72 +++---
content/docs/4.6.0/security/tls/index.html | 69 +++---
content/docs/4.6.1/admin/autorecovery/index.html | 25 +-
content/docs/4.6.1/admin/bookies/index.html | 72 +++---
content/docs/4.6.1/admin/http/index.html | 119 +++++-----
content/docs/4.6.1/api/ledger-adv-api/index.html | 20 +-
content/docs/4.6.1/api/ledger-api/index.html | 205 +++++++----------
content/docs/4.6.1/deployment/dcos/index.html | 60 +++--
.../docs/4.6.1/deployment/kubernetes/index.html | 89 +++-----
content/docs/4.6.1/deployment/manual/index.html | 15 +-
.../docs/4.6.1/getting-started/concepts/index.html | 15 +-
.../4.6.1/getting-started/installation/index.html | 23 +-
.../4.6.1/getting-started/run-locally/index.html | 5 +-
content/docs/4.6.1/reference/cli/index.html | 155 +++++--------
content/docs/4.6.1/security/sasl/index.html | 72 +++---
content/docs/4.6.1/security/tls/index.html | 69 +++---
content/docs/latest/admin/autorecovery/index.html | 25 +-
content/docs/latest/admin/bookies/index.html | 72 +++---
content/docs/latest/admin/http/index.html | 119 +++++-----
content/docs/latest/api/javadoc/index-all.html | 8 +-
.../client/LedgerRecoveryOp.RecoveryReadOp.html | 2 +-
.../client/ListenerBasedPendingReadOp.html | 2 +-
.../client/PendingReadOp.LedgerEntryRequest.html | 8 +-
.../client/PendingReadOp.ParallelReadRequest.html | 2 +-
.../client/PendingReadOp.SequenceReadRequest.html | 2 +-
.../apache/bookkeeper/client/PendingReadOp.html | 20 +-
content/docs/latest/api/ledger-adv-api/index.html | 30 +--
content/docs/latest/api/ledger-api/index.html | 243 +++++++-------------
content/docs/latest/deployment/dcos/index.html | 60 +++--
.../docs/latest/deployment/kubernetes/index.html | 89 +++-----
content/docs/latest/deployment/manual/index.html | 15 +-
.../latest/getting-started/concepts/index.html | 15 +-
.../latest/getting-started/installation/index.html | 23 +-
.../latest/getting-started/run-locally/index.html | 5 +-
content/docs/latest/overview/overview/index.html | 47 ++--
content/docs/latest/reference/cli/index.html | 155 +++++--------
content/docs/latest/security/sasl/index.html | 72 +++---
content/docs/latest/security/tls/index.html | 69 +++---
content/releases/index.html | 132 ++++++++++-
84 files changed, 2121 insertions(+), 2808 deletions(-)
diff --git a/content/bps/BP-20-github-workflow-for-bookkeeper-proposals/index.html b/content/bps/BP-20-github-workflow-for-bookkeeper-proposals/index.html
index fae9d07..e07b98f 100644
--- a/content/bps/BP-20-github-workflow-for-bookkeeper-proposals/index.html
+++ b/content/bps/BP-20-github-workflow-for-bookkeeper-proposals/index.html
@@ -249,9 +249,8 @@ All the implementations of this BP should be listed and linked to this master is
<li>Write the proposal for this BP.
<ul>
<li>Make a copy of the <a href="https://github.com/apache/bookkeeper/tree/master/site/bps/BP-template.md">BP-Template</a>. Name the BP file as <code class="highlighter-rouge">BP-<number>-[caption-of-proposal].md</code>.
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">$ </span>cp site/bps/BP-template.md site/bps/BP-xyz-capation-of-proposal.md
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">$ </span><span class="nb">cp </span>site/bps/BP-template.md site/bps/BP-xyz-capation-of-proposal.md
+</code></pre></div> </div>
</li>
<li>Fill the sections listed in the BP template.
<ul>
diff --git a/content/bps/BP-21-new-api-close-inconsistencies/index.html b/content/bps/BP-21-new-api-close-inconsistencies/index.html
index eb3df85..7b126b1 100644
--- a/content/bps/BP-21-new-api-close-inconsistencies/index.html
+++ b/content/bps/BP-21-new-api-close-inconsistencies/index.html
@@ -252,11 +252,10 @@
<ol>
<li>Remove Handle#asyncClose</li>
<li>Add new method WriteHandle#seal.
- <div class="highlighter-rouge"><pre class="highlight"><code>class WriteHandle {
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>class WriteHandle {
CompletableFuture<Void> seal();
}
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
</ol>
@@ -266,14 +265,13 @@
<p>The proposed usage would look like:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>try (WriteHandle writer = bk.newCreateLedgerOp().withPassword("bleh".getBytes()).execute().get()) {
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>try (WriteHandle writer = bk.newCreateLedgerOp().withPassword("bleh".getBytes()).execute().get()) {
for (int i = 0; i < 100; i++) {
writer.append("foobar".getBytes());
}
writer.seal().get(); // no more entries can be added
}
-</code></pre>
-</div>
+</code></pre></div></div>
<p><em>What if the user forgets to call #seal before closing the ledger?</em></p>
diff --git a/content/bps/BP-22-separate-closing-ledgers-from-opening-ledgers/index.html b/content/bps/BP-22-separate-closing-ledgers-from-opening-ledgers/index.html
index 8361a78..0df108f 100644
--- a/content/bps/BP-22-separate-closing-ledgers-from-opening-ledgers/index.html
+++ b/content/bps/BP-22-separate-closing-ledgers-from-opening-ledgers/index.html
@@ -241,20 +241,19 @@
<p>I proposes the removal of OpenOpBuilder#withRecovery()</p>
<p>A new method on BookKeeper:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>interface BookKeeper {
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>interface BookKeeper {
...
CompletableFuture<Void> seal(ReadHandle handle);
}
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="proposed-changes">Proposed Changes</h3>
<p>With the proposed interface changes, every ReadHandle will be opened without recovery. For the tailing usecase, usage will look like.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">reader</span> <span class="o">=</span> <span class="n">bk</span><span class="o">.</span><span class="na">newOpenLedgerOp</span><span class="o">().</span><span class="na">withLedgerId</span><span class="o">(</span><span class="n">X</span><span class="o">).</span><span class="na">execute</span><span class="o">().</span><span class="na">get</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">reader</span> <span class="o">=</span> <span class="n">bk</span><span class="o">.</span><span class="na">newOpenLedgerOp</span><span class="o">().</span><span class="na">withLedgerId</span><span class="o">(</span><span class="n">X</span><span class="o">).</span><span class="na">execute</span><span class="o">().</span><span class="na">get</span [...]
<span class="kt">long</span> <span class="n">lastReadEntry</span> <span class="o">=</span> <span class="o">-</span><span class="mi">1</span><span class="o">;</span>
<span class="k">while</span> <span class="o">(!</span><span class="n">leader</span><span class="o">)</span> <span class="o">{</span>
<span class="kt">long</span> <span class="n">lac</span> <span class="o">=</span> <span class="n">reader</span><span class="o">.</span><span class="na">getLastAddConfirmed</span><span class="o">();</span>
@@ -272,12 +271,11 @@
<span class="n">doSomethingWithEntries</span><span class="o">(</span><span class="n">entries</span><span class="o">);</span>
<span class="o">}</span>
<span class="n">WriteHandle</span> <span class="n">writer</span> <span class="o">=</span> <span class="n">bk</span><span class="o">.</span><span class="na">newCreateLedgerOp</span><span class="o">().</span><span class="na">execute</span><span class="o">().</span><span class="na">get</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Constrast this with how it is with the current recovery on open mechanism.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>ReadHandle reader = bk.newOpenLedgerOp().withLedgerId(X).execute().get();
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ReadHandle reader = bk.newOpenLedgerOp().withLedgerId(X).execute().get();
long lastReadEntry = -1;
while (!leader) {
long lac = reader.getLastAddConfirmed();
@@ -296,8 +294,7 @@ if (lac > lastReadEntry) {
doSomethingWithEntries(entries);
}
WriteHandle writer = bk.newCreateLedgerOp().execute().get();
-</code></pre>
-</div>
+</code></pre></div></div>
<p>The second one is more code, you need to remember to close the previous handle, and the intent of the operation is less clear.</p>
diff --git a/content/bps/BP-27-new-bookkeeper-cli/index.html b/content/bps/BP-27-new-bookkeeper-cli/index.html
index 13eeb43..43f879b 100644
--- a/content/bps/BP-27-new-bookkeeper-cli/index.html
+++ b/content/bps/BP-27-new-bookkeeper-cli/index.html
@@ -241,9 +241,8 @@ Instead a new module <code class="highlighter-rouge">bookkeeper-tools</code> wil
<p>The new bookkeeper CLI follows the pattern that pulsar-admin is using. The CLI commandline format would be:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>$ bookkeeper-cli [general options] <command-group> <command> [options of command]
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$ bookkeeper-cli [general options] <command-group> <command> [options of command]
+</code></pre></div></div>
<h4 id="commandgroup-and-command">CommandGroup and Command</h4>
@@ -266,7 +265,7 @@ Instead a new module <code class="highlighter-rouge">bookkeeper-tools</code> wil
<li>Show all command groups: <code class="highlighter-rouge">bookkeeper-cli --help</code></li>
</ul>
-<div class="highlighter-rouge"><pre class="highlight"><code>Usage: bookkeeper-cli [options] [command] [command options]
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Usage: bookkeeper-cli [options] [command] [command options]
Options:
-c, --conf
Bookie Configuration File
@@ -285,11 +284,10 @@ Instead a new module <code class="highlighter-rouge">bookkeeper-tools</code> wil
metadata Commands that interact with metadata storage
Usage: metadata [options]
-</code></pre>
-</div>
+</code></pre></div></div>
<ul>
<li>Show commands under <code class="highlighter-rouge">cluster</code>: <code class="highlighter-rouge">bookkeeper-cli cluster --help</code>
- <div class="highlighter-rouge"><pre class="highlight"><code>Usage: bookie-shell cluster [options] [command] [command options]
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Usage: bookie-shell cluster [options] [command] [command options]
Commands:
listbookies List the bookies, which are running as either readwrite or readonly mode.
Usage: listbookies [options]
@@ -300,8 +298,7 @@ Commands:
-rw, --readwrite
Print readwrite bookies
Default: false
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
</ul>
diff --git a/content/community/bookkeeper_proposals/index.html b/content/community/bookkeeper_proposals/index.html
index 6b9a6d7..800d4f3 100644
--- a/content/community/bookkeeper_proposals/index.html
+++ b/content/community/bookkeeper_proposals/index.html
@@ -280,9 +280,8 @@ using Google Doc.
<li>Markdown
<ul>
<li>Make a copy of the <a href="https://github.com/apache/bookkeeper/tree/master/site/bps/BP-template.md">BP-Template</a>. Name the BP file as <code class="highlighter-rouge">BP-<number>-[caption-of-proposal].md</code>.
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">$ </span>cp site/bps/BP-template.md site/bps/BP-xyz-capation-of-proposal.md
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">$ </span><span class="nb">cp </span>site/bps/BP-template.md site/bps/BP-xyz-capation-of-proposal.md
+</code></pre></div> </div>
</li>
<li>Fill the sections listed in the BP template.
<ul>
diff --git a/content/community/contributing/index.html b/content/community/contributing/index.html
index dfcb718..39688c6 100644
--- a/content/community/contributing/index.html
+++ b/content/community/contributing/index.html
@@ -360,17 +360,15 @@ participate on the documentation effort.</p>
<p>Clone your personal BookKeeper’s GitHub fork.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>$ git clone https://github.com/<Github_user>/bookkeeper.git
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$ git clone https://github.com/<Github_user>/bookkeeper.git
$ cd bookkeeper
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Add Apache Repo as additional Git remotes, where you can sync the changes (for committers, you need these two remotes for pushing changes).</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>$ git remote add apache https://github.com/apache/bookkeeper
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$ git remote add apache https://github.com/apache/bookkeeper
$ git remote add apache-github https://github.com/apache/bookkeeper
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You are now ready to start developing!</p>
@@ -475,10 +473,9 @@ Start Eclipse with a fresh workspace in a separate directory from your checkout.
<p>You’ll work on your contribution in a branch in your own (forked) repository. Create a local branch, initialized with the state of the branch you expect your changes to be merged into. Keep in mind that we use several branches, including <code class="highlighter-rouge">master</code>, feature-specific, and release-specific branches. If you are unsure, initialize with the state of the <code class="highlighter-rouge">master</code> branch.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>$ git fetch apache
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$ git fetch apache
$ git checkout -b <my-branch> apache/master
-</code></pre>
-</div>
+</code></pre></div></div>
<p>At this point, you can start making and committing changes to this branch in a standard way.</p>
@@ -486,17 +483,15 @@ $ git checkout -b <my-branch> apache/master
<p>Periodically while you work, and certainly before submitting a pull request, you should update your branch with the most recent changes to the target branch.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>$ git pull --rebase
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$ git pull --rebase
+</code></pre></div></div>
<p>Remember to always use <code class="highlighter-rouge">--rebase</code> parameter to avoid extraneous merge commits.</p>
<p>Then you can push your local, committed changes to your (forked) repository on GitHub. Since rebase may change that branch’s history, you may need to force push. You’ll run:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>$ git push <GitHub_user> <my-branch> --force
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$ git push <GitHub_user> <my-branch> --force
+</code></pre></div></div>
<h3 id="testing">Testing</h3>
@@ -510,25 +505,22 @@ $ git checkout -b <my-branch> apache/master
<p>Organize your commits to make a committer’s job easier when reviewing. Committers normally prefer multiple small pull requests, instead of a single large pull request. Within a pull request, a relatively small number of commits that break the problem into logical steps is preferred. For most pull requests, you’ll squash your changes down to 1 commit. You can use the following command to re-order, squash, edit, or change description of individual commits.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>$ git rebase -i apache/master
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$ git rebase -i apache/master
+</code></pre></div></div>
<p>You’ll then push to your branch on GitHub. Note: when updating your commit after pull request feedback and use squash to get back to one commit, you will need to do a force submit to the branch on your repo.</p>
<p>Navigate to the <a href="https://github.com/apache/bookkeeper">BookKeeper GitHub Repo</a> to create a pull request. The title of the pull request should be strictly in the following format:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>Issue <Github-issue-#> <Title of the pull request>
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Issue <Github-issue-#> <Title of the pull request>
+</code></pre></div></div>
<p>Please include a descriptive pull request message to help make the comitter’s job easier when reviewing. It’s fine to refer to existing design docs or the contents of the associated JIRA as appropriate.</p>
<p>If you know a good committer to review your pull request, please make a comment like the following. If not, don’t worry – a committer will pick it up.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>Hi @<GitHub-committer-username>, can you please take a look?
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Hi @<GitHub-committer-username>, can you please take a look?
+</code></pre></div></div>
<p>When choosing a committer to review, think about who is the expert on the relevant code, who the stakeholders are for this change, and who else would benefit from becoming familiar with the code. If you’d appreciate comments from additional folks but already have a main committer, you can explicitly cc them using <code class="highlighter-rouge">@<GitHub-committer-username></code>.</p>
@@ -551,11 +543,10 @@ $ git checkout -b <my-branch> apache/master
<p>From another local branch, run:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>$ git fetch origin
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$ git fetch origin
$ git branch -d <my-branch>
$ git push origin --delete <my-branch>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="commit-committers-only">Commit (committers only)</h2>
diff --git a/content/community/licensing/index.html b/content/community/licensing/index.html
index 82100b0..8041e8a 100644
--- a/content/community/licensing/index.html
+++ b/content/community/licensing/index.html
@@ -283,7 +283,7 @@
<p>To check that licensing is correct, generate the tarball and run the script against it as follows (in this example I’ve removed references to protobuf from the LICENSE file).</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>~/src/bookkeeper <span class="nv">$ </span>mvn clean package -DskipTests
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>~/src/bookkeeper <span class="nv">$ </span>mvn clean package <span class="nt">-DskipTests</span>
...
~/src/bookkeeper <span class="nv">$ </span>dev/check-binary-license bookkeeper-dist/server/target/bookkeeper-server-4.7.0-SNAPSHOT-bin.tar.gz
@@ -291,8 +291,7 @@ com.google.protobuf-protobuf-java-3.4.0.jar unaccounted <span class="k">for in <
deps/protobuf-3.4.0/LICENSE bundled, but not linked from LICENSE
~/src/bookkeeper <span class="nv">$ </span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>The script checks the following:</p>
<ol>
diff --git a/content/community/release_guide/index.html b/content/community/release_guide/index.html
index 9c0bb89..27c9697 100644
--- a/content/community/release_guide/index.html
+++ b/content/community/release_guide/index.html
@@ -352,55 +352,50 @@ You can reach out other committers in Apache BookKeeper community for signing yo
<p><strong>First</strong>, Determine your Apache GPG Key and Key ID, as follows:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>gpg --list-keys
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gpg --list-keys
+</code></pre></div></div>
<p>This will list your GPG keys. One of these should reflect your Apache account, for example:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>--------------------------------------------------
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>--------------------------------------------------
pub 2048R/845E6689 2016-02-23
uid Nomen Nescio <anonymous@apache.org>
sub 2048R/BA4D50BE 2016-02-23
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Here, the key ID is the 8-digit hex string in the <code class="highlighter-rouge">pub</code> line: <code class="highlighter-rouge">845E6689</code>.</p>
<p><strong>Second</strong>, add your Apache GPG key to the BookKeeper’s <code class="highlighter-rouge">KEYS</code> file in <a href="https://dist.apache.org/repos/dist/release/bookkeeper/KEYS"><code class="highlighter-rouge">dist</code></a>.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
<span class="c"># checkout the svn folder that contains the KEYS file</span>
svn co https://dist.apache.org/repos/dist/release/bookkeeper bookkeeper_dist
<span class="nb">cd </span>bookkeeper_dist
<span class="c"># Export the key in ascii format and append it to the file</span>
-<span class="o">(</span> gpg --list-sigs <span class="nv">$USER</span>@apache.org
- gpg --export --armor <span class="nv">$USER</span>@apache.org <span class="o">)</span> >> KEYS
+<span class="o">(</span> gpg <span class="nt">--list-sigs</span> <span class="nv">$USER</span>@apache.org
+ gpg <span class="nt">--export</span> <span class="nt">--armor</span> <span class="nv">$USER</span>@apache.org <span class="o">)</span> <span class="o">>></span> KEYS
<span class="c"># Commit to svn</span>
-svn ci -m <span class="s2">"Added gpg key for </span><span class="nv">$USER</span><span class="s2">"</span>
+svn ci <span class="nt">-m</span> <span class="s2">"Added gpg key for </span><span class="nv">$USER</span><span class="s2">"</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Once you committed, please verify if your GPG key shows up in the BookkKeeper’s <code class="highlighter-rouge">KEYS</code> file in <a href="https://dist.apache.org/repos/dist/release/bookkeeper/KEYS"><code class="highlighter-rouge">dist</code></a>.</p>
<p><strong>Third</strong>, configure <code class="highlighter-rouge">git</code> to use this key when signing code by giving it your key ID, as follows:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>git config --global user.signingkey 845E6689
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git config --global user.signingkey 845E6689
+</code></pre></div></div>
<p>You may drop the <code class="highlighter-rouge">--global</code> option if you’d prefer to use this key for the current repository only.</p>
<p>You may wish to start <code class="highlighter-rouge">gpg-agent</code> to unlock your GPG key only once using your passphrase. Otherwise, you may need to enter this passphrase hundreds of times. The setup for <code class="highlighter-rouge">gpg-agent</code> varies based on operating system, but may be something like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>eval $(gpg-agent --daemon --no-grab --write-env-file $HOME/.gpg-agent-info)
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>eval $(gpg-agent --daemon --no-grab --write-env-file $HOME/.gpg-agent-info)
export GPG_TTY=$(tty)
export GPG_AGENT_INFO
-</code></pre>
-</div>
+</code></pre></div></div>
<h4 id="access-to-apache-nexus-repository">Access to Apache Nexus repository</h4>
@@ -414,7 +409,7 @@ export GPG_AGENT_INFO
<li>
<p>Insert this snippet twice into your global Maven <code class="highlighter-rouge">settings.xml</code> file (use command <code class="highlighter-rouge">mvn -X | grep settings</code>, and read out the global Maven setting file), typically <code class="highlighter-rouge">${HOME}/.m2/settings.xml</code>. The end result should look like this, where <code class="highlighter-rouge">TOKEN_NAME</code> and <code class="highlighter-rouge">TOKEN_PASSWORD</code> are your secret tokens:</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> <settings>
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <settings>
<servers>
<server>
<id>apache.releases.https</id>
@@ -428,8 +423,7 @@ export GPG_AGENT_INFO
</server>
</servers>
</settings>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
</ol>
@@ -510,31 +504,28 @@ We can use <a href="https://github.com/skywinder/github-changelog-generator">git
<p>Check out the version of the codebase from which you start the release. For a new minor or major release, this may be <code class="highlighter-rouge">HEAD</code> of the <code class="highlighter-rouge">master</code> branch. To build a hotfix/incremental release, instead of the <code class="highlighter-rouge">master</code> branch, use the release tag of the release being patched. (Please make sure your cloned repository is up-to-date before starting.)</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>git checkout <master branch OR release tag>
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git checkout <master branch OR release tag>
+</code></pre></div></div>
<p>Set up a few environment variables to simplify Maven commands that follow. (We use <code class="highlighter-rouge">bash</code> Unix syntax in this guide.)</p>
<p>For a major release (for instance 4.5.0):</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>MAJOR_VERSION="4.5"
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>MAJOR_VERSION="4.5"
VERSION="4.5.0"
NEXT_VERSION="4.6.0"
BRANCH_NAME="branch-${MAJOR_VERSION}"
DEVELOPMENT_VERSION="${NEXT_VERSION}-SNAPSHOT"
-</code></pre>
-</div>
+</code></pre></div></div>
<p>For a minor release (for instance 4.5.1):</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>MAJOR_VERSION="4.5"
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>MAJOR_VERSION="4.5"
VERSION="4.5.1"
NEXT_VERSION="4.5.2"
BRANCH_NAME="branch-${MAJOR_VERSION}"
DEVELOPMENT_VERSION="${NEXT_VERSION}-SNAPSHOT"
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Version represents the release currently underway, while next version specifies the anticipated next version to be released from that branch. Normally, 4.5.0 is followed by 4.6.0, while 4.5.0 is followed by 4.5.1.</p>
@@ -547,12 +538,11 @@ at the end of this command. “dry run” will generate some temporary files in
them by running “mvn release:clean”.</p>
</blockquote>
-<div class="highlighter-rouge"><pre class="highlight"><code>mvn release:branch \
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn release:branch \
-DbranchName=${BRANCH_NAME} \
-DdevelopmentVersion=${DEVELOPMENT_VERSION} \
[-DdryRun]
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>If you failed at the middle of running this command, please check if you have <code class="highlighter-rouge">push</code> permissions on <code class="highlighter-rouge">github.com</code>.
@@ -566,9 +556,8 @@ $ git branch -D ${BRANCH_NAME}</master></p>
<p>Check out the release branch.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>git checkout ${BRANCH_NAME}
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git checkout ${BRANCH_NAME}
+</code></pre></div></div>
<p>The rest of this guide assumes that commands are run in the root of a repository on <code class="highlighter-rouge">${BRANCH_NAME}</code> with the above environment variables set.</p>
@@ -599,17 +588,15 @@ $ git branch -D ${BRANCH_NAME}</master></p>
<h3 id="build-and-stage-java-artifacts-with-maven">Build and stage Java artifacts with Maven</h3>
-<div class="highlighter-rouge"><pre class="highlight"><code>TODO: Currently we have to build and stage maven artifacts manually, because it requires pushing the artifacts to apache staging. We should look for a solution to automate that.
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>TODO: Currently we have to build and stage maven artifacts manually, because it requires pushing the artifacts to apache staging. We should look for a solution to automate that.
+</code></pre></div></div>
<p>Set up a few environment variables to simplify Maven commands that follow. This identifies the release candidate being built. Start with <code class="highlighter-rouge">release candidate number</code> equal to <code class="highlighter-rouge">0</code> and increment it for each candidate.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>RC_NUM="0"
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>RC_NUM="0"
TAG="release-${VERSION}"
RC_DIR="bookkeeper-${VERSION}-rc${RC_NUM}"
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>Please make sure <code class="highlighter-rouge">gpg</code> command is in your $PATH. The maven release plugin use <code class="highlighter-rouge">gpg</code> to sign generated jars and packages.</p>
@@ -617,7 +604,7 @@ RC_DIR="bookkeeper-${VERSION}-rc${RC_NUM}"
<p>Use Maven release plugin to build the release artifacts, as follows:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>mvn release:prepare \
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn release:prepare \
-Dresume=false \
-DreleaseVersion=${VERSION} \
-Dtag=${TAG} \
@@ -625,14 +612,12 @@ RC_DIR="bookkeeper-${VERSION}-rc${RC_NUM}"
[-DdryRun] \
[-Darguments="-Dmaven.javadoc.skip=true -DskipTests=true"] \ // to skip javadoc and tests
[-Dresume=true] // resume prepare if it is interrupted in the middle
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Use Maven release plugin to stage these artifacts on the Apache Nexus repository, as follows:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>mvn release:perform [-DdryRun] [-Darguments="-Dmaven.javadoc.skip=true -DskipTests=true"] [-Dresume=true]
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn release:perform [-DdryRun] [-Darguments="-Dmaven.javadoc.skip=true -DskipTests=true"] [-Dresume=true]
+</code></pre></div></div>
<blockquote>
<p>If <code class="highlighter-rouge">release:perform</code> failed,
@@ -656,50 +641,45 @@ force push backed out local git branch to github again.</p>
<li>
<p>If you have not already, check out the BookKeeper section of the <code class="highlighter-rouge">dev</code> repository on <code class="highlighter-rouge">dist.apache.org</code> via Subversion. In a fresh directory:</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> svn co https://dist.apache.org/repos/dist/dev/bookkeeper
-</code></pre>
- </div>
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> svn co https://dist.apache.org/repos/dist/dev/bookkeeper
+</code></pre></div> </div>
</li>
<li>
<p>Make a directory for the new release:</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> mkdir bookkeeper/${RC_DIR}
-</code></pre>
- </div>
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> mkdir bookkeeper/${RC_DIR}
+</code></pre></div> </div>
</li>
<li>
<p>Copy the BookKeeper source and binary distribution, and their GPG signatures:</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> cp bookkeeper-dist/target/bookkeeper-${VERSION}-src.tar.gz bookkeeper/${RC_DIR}/bookkeeper-${VERSION}-src.tar.gz
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> cp bookkeeper-dist/target/bookkeeper-${VERSION}-src.tar.gz bookkeeper/${RC_DIR}/bookkeeper-${VERSION}-src.tar.gz
cp bookkeeper-dist/target/bookkeeper-${VERSION}-src.tar.gz.asc bookkeeper/${RC_DIR}/bookkeeper-${VERSION}-src.tar.gz.asc
cp bookkeeper-dist/server/target/bookkeeper-server-${VERSION}-bin.tar.gz bookkeeper/${RC_DIR}/bookkeeper-server-${VERSION}-bin.tar.gz
cp bookkeeper-dist/server/target/bookkeeper-server-${VERSION}-bin.tar.gz.asc bookkeeper/${RC_DIR}/bookkeeper-server-${VERSION}-bin.tar.gz.asc
cp bookkeeper-dist/all/target/bookkeeper-all-${VERSION}-bin.tar.gz bookkeeper/${RC_DIR}/bookkeeper-all-${VERSION}-bin.tar.gz
cp bookkeeper-dist/all/target/bookkeeper-all-${VERSION}-bin.tar.gz.asc bookkeeper/${RC_DIR}/bookkeeper-all-${VERSION}-bin.tar.gz.asc
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Sign the BookKeeper source and binary distribution.</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> cd bookkeeper/${RC_DIR}
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> cd bookkeeper/${RC_DIR}
md5sum bookkeeper-${VERSION}-src.tar.gz > bookkeeper-${VERSION}-src.tar.gz.md5
shasum bookkeeper-${VERSION}-src.tar.gz > bookkeeper-${VERSION}-src.tar.gz.sha1
md5sum bookkeeper-server-${VERSION}-bin.tar.gz > bookkeeper-server-${VERSION}-bin.tar.gz.md5
shasum bookkeeper-server-${VERSION}-bin.tar.gz > bookkeeper-server-${VERSION}-bin.tar.gz.sha1
md5sum bookkeeper-all-${VERSION}-bin.tar.gz > bookkeeper-all-${VERSION}-bin.tar.gz.md5
shasum bookkeeper-all-${VERSION}-bin.tar.gz > bookkeeper-all-${VERSION}-bin.tar.gz.sha1
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Go back to BookKeeper directory, add and commit all the files.</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> cd ..
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> cd ..
svn add ${RC_DIR}
svn commit
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Verify that files are <a href="https://dist.apache.org/repos/dist/dev/bookkeeper">present</a>.</p>
@@ -721,7 +701,7 @@ force push backed out local git branch to github again.</p>
<p>Start the review-and-vote thread on the dev@ mailing list. Here’s an email template; please adjust as you see fit.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>From: Release Manager
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>From: Release Manager
To: dev@bookkeeper.apache.org
Subject: [VOTE] Release 4.5.0, release candidate #0
@@ -759,14 +739,13 @@ Release Manager
[3] link
[4] link
[5] link
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If there are any issues found in the release candidate, reply on the vote thread to cancel the vote. There’s no need to wait 72 hours. Proceed to the <code class="highlighter-rouge">Fix Issues</code> step below and address the problem. However, some issues don’t require cancellation. For example, if an issue is found in the website pull request, just correct it on the spot and the vote can continue as-is.</p>
<p>If there are no issues, reply on the vote thread to close the voting. Then, tally the votes in a separate email. Here’s an email template; please adjust as you see fit. (NOTE: the approver list are binding approvers.)</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>From: Release Manager
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>From: Release Manager
To: dev@bookkeeper.apache.org
Subject: [RESULT] [VOTE] Release 0.4.0, release candidate #0
@@ -781,8 +760,7 @@ There are XXX approving votes, XXX of which are binding:
There are no disapproving votes.
Thanks everyone!
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="checklist-to-proceed-to-the-finalization-step">Checklist to proceed to the finalization step</h3>
@@ -820,10 +798,9 @@ Thanks everyone!
<p>This command will upgrade the <version> tag on every pom.xml locally to your workspace.</version></p>
</blockquote>
-<div class="highlighter-rouge"><pre class="highlight"><code>mvn release:update-versions
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn release:update-versions
-DdevelopmentVersion=${DEVELOPMENT_VERSION}
-</code></pre>
-</div>
+</code></pre></div></div>
<p>For instance if you have released 4.5.1, you have to change version to 4.5.2-SNAPSHOT.
Then you have to create a PR and submit it for review.</p>
@@ -836,9 +813,8 @@ Then you have to create a PR and submit it for review.</p>
<p>Copy the source release from the <code class="highlighter-rouge">dev</code> repository to the <code class="highlighter-rouge">release</code> repository at <code class="highlighter-rouge">dist.apache.org</code> using Subversion.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>svn move https://dist.apache.org/repos/dist/dev/bookkeeper/bookkeeper-${VERSION}-rc${RC_NUM} https://dist.apache.org/repos/dist/release/bookkeeper/bookkeeper-${VERSION}
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>svn move https://dist.apache.org/repos/dist/dev/bookkeeper/bookkeeper-${VERSION}-rc${RC_NUM} https://dist.apache.org/repos/dist/release/bookkeeper/bookkeeper-${VERSION}
+</code></pre></div></div>
<h3 id="update-website">Update Website</h3>
@@ -847,10 +823,9 @@ Then you have to create a PR and submit it for review.</p>
<p>Create the documentation for <code class="highlighter-rouge">${VERSION}</code>. Run the <code class="highlighter-rouge">release.sh</code> to generate the branch for <code class="highlighter-rouge">${VERSION}</code> and bump
the versions for website documentation.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">$ </span><span class="nb">cd </span>site
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">$ </span><span class="nb">cd </span>site
<span class="nv">$ </span>./site/release.sh
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>Once run the <code class="highlighter-rouge">release.sh</code>, please send a pull request for it and get approval from any committers, then merge it.
The CI job will automatically update the website in a few minutes. Please review the website to make sure the
@@ -874,18 +849,17 @@ Then you have to create a PR and submit it for review.</p>
<li>
<p>After this pull request is merged, you need to cherry-pick the change to the release tag.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> // create a cherry-pick branch
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> // create a cherry-pick branch
<span class="nv">$ </span>git checkout <span class="k">${</span><span class="nv">TAG</span><span class="k">}</span>
- <span class="nv">$ </span>git checkout -b <span class="k">${</span><span class="nv">TAG</span><span class="k">}</span>_cherrypick
+ <span class="nv">$ </span>git checkout <span class="nt">-b</span> <span class="k">${</span><span class="nv">TAG</span><span class="k">}</span>_cherrypick
<span class="nv">$ </span>git cherry-pick <GIT SHA>
// remove the release tag locally and remotely
- <span class="nv">$ </span>git tag -d <span class="k">${</span><span class="nv">TAG</span><span class="k">}</span>
+ <span class="nv">$ </span>git tag <span class="nt">-d</span> <span class="k">${</span><span class="nv">TAG</span><span class="k">}</span>
<span class="nv">$ </span>git push apache :<span class="k">${</span><span class="nv">TAG</span><span class="k">}</span>
// re-tag based on the cherry-pick branch
<span class="nv">$ </span>git tag <span class="k">${</span><span class="nv">TAG</span><span class="k">}</span>
<span class="nv">$ </span>git push apache <span class="k">${</span><span class="nv">TAG</span><span class="k">}</span>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Verify the <a href="https://hub.docker.com/r/apache/bookkeeper/">docker hub</a> to see if a new build for the given tag is build.</p>
@@ -930,7 +904,7 @@ Then you have to create a PR and submit it for review.</p>
<p>NOTE: Make sure sending the announce email using apache email, otherwise announce@apache.org will reject your email.</p>
</blockquote>
-<div class="highlighter-rouge"><pre class="highlight"><code>From: xxx@apache.org
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>From: xxx@apache.org
To: dev@bookkeeper.apache.org, user@bookkeeper.apache.org, announce@apache.org
Subject: [ANNOUNCE] Apache BookKeeper x.y.z released
@@ -958,8 +932,7 @@ We would like to thank the contributors that made the release possible.
Regards,
The BookKeeper Team
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="recordkeeping">Recordkeeping</h3>
diff --git a/content/css/style.css b/content/css/style.css
index 13e223b..814cdc3 100644
--- a/content/css/style.css
+++ b/content/css/style.css
@@ -22,7 +22,7 @@
/* makes the font 33% larger relative to the icon container */
.fa-lg {
- font-size: 1.33333em;
+ font-size: 1.3333333333em;
line-height: 0.75em;
vertical-align: -15%; }
@@ -39,24 +39,24 @@
font-size: 5em; }
.fa-fw {
- width: 1.28571em;
+ width: 1.2857142857em;
text-align: center; }
.fa-ul {
padding-left: 0;
- margin-left: 2.14286em;
+ margin-left: 2.1428571429em;
list-style-type: none; }
.fa-ul > li {
position: relative; }
.fa-li {
position: absolute;
- left: -2.14286em;
- width: 2.14286em;
- top: 0.14286em;
+ left: -2.1428571429em;
+ width: 2.1428571429em;
+ top: 0.1428571429em;
text-align: center; }
.fa-li.fa-lg {
- left: -1.85714em; }
+ left: -1.8571428571em; }
.fa-border {
padding: .2em .25em .15em;
@@ -6137,14 +6137,14 @@ label.panel-block {
margin-left: 25%; }
.columns.is-mobile > .column.is-1 {
flex: none;
- width: 8.33333%; }
+ width: 8.3333333333%; }
.columns.is-mobile > .column.is-offset-1 {
- margin-left: 8.33333%; }
+ margin-left: 8.3333333333%; }
.columns.is-mobile > .column.is-2 {
flex: none;
- width: 16.66667%; }
+ width: 16.6666666667%; }
.columns.is-mobile > .column.is-offset-2 {
- margin-left: 16.66667%; }
+ margin-left: 16.6666666667%; }
.columns.is-mobile > .column.is-3 {
flex: none;
width: 25%; }
@@ -6152,14 +6152,14 @@ label.panel-block {
margin-left: 25%; }
.columns.is-mobile > .column.is-4 {
flex: none;
- width: 33.33333%; }
+ width: 33.3333333333%; }
.columns.is-mobile > .column.is-offset-4 {
- margin-left: 33.33333%; }
+ margin-left: 33.3333333333%; }
.columns.is-mobile > .column.is-5 {
flex: none;
- width: 41.66667%; }
+ width: 41.6666666667%; }
.columns.is-mobile > .column.is-offset-5 {
- margin-left: 41.66667%; }
+ margin-left: 41.6666666667%; }
.columns.is-mobile > .column.is-6 {
flex: none;
width: 50%; }
@@ -6167,14 +6167,14 @@ label.panel-block {
margin-left: 50%; }
.columns.is-mobile > .column.is-7 {
flex: none;
- width: 58.33333%; }
+ width: 58.3333333333%; }
.columns.is-mobile > .column.is-offset-7 {
- margin-left: 58.33333%; }
+ margin-left: 58.3333333333%; }
.columns.is-mobile > .column.is-8 {
flex: none;
- width: 66.66667%; }
+ width: 66.6666666667%; }
.columns.is-mobile > .column.is-offset-8 {
- margin-left: 66.66667%; }
+ margin-left: 66.6666666667%; }
.columns.is-mobile > .column.is-9 {
flex: none;
width: 75%; }
@@ -6182,14 +6182,14 @@ label.panel-block {
margin-left: 75%; }
.columns.is-mobile > .column.is-10 {
flex: none;
- width: 83.33333%; }
+ width: 83.3333333333%; }
.columns.is-mobile > .column.is-offset-10 {
- margin-left: 83.33333%; }
+ margin-left: 83.3333333333%; }
.columns.is-mobile > .column.is-11 {
flex: none;
- width: 91.66667%; }
+ width: 91.6666666667%; }
.columns.is-mobile > .column.is-offset-11 {
- margin-left: 91.66667%; }
+ margin-left: 91.6666666667%; }
.columns.is-mobile > .column.is-12 {
flex: none;
width: 100%; }
@@ -6228,14 +6228,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-1-mobile {
flex: none;
- width: 8.33333%; }
+ width: 8.3333333333%; }
.column.is-offset-1-mobile {
- margin-left: 8.33333%; }
+ margin-left: 8.3333333333%; }
.column.is-2-mobile {
flex: none;
- width: 16.66667%; }
+ width: 16.6666666667%; }
.column.is-offset-2-mobile {
- margin-left: 16.66667%; }
+ margin-left: 16.6666666667%; }
.column.is-3-mobile {
flex: none;
width: 25%; }
@@ -6243,14 +6243,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-4-mobile {
flex: none;
- width: 33.33333%; }
+ width: 33.3333333333%; }
.column.is-offset-4-mobile {
- margin-left: 33.33333%; }
+ margin-left: 33.3333333333%; }
.column.is-5-mobile {
flex: none;
- width: 41.66667%; }
+ width: 41.6666666667%; }
.column.is-offset-5-mobile {
- margin-left: 41.66667%; }
+ margin-left: 41.6666666667%; }
.column.is-6-mobile {
flex: none;
width: 50%; }
@@ -6258,14 +6258,14 @@ label.panel-block {
margin-left: 50%; }
.column.is-7-mobile {
flex: none;
- width: 58.33333%; }
+ width: 58.3333333333%; }
.column.is-offset-7-mobile {
- margin-left: 58.33333%; }
+ margin-left: 58.3333333333%; }
.column.is-8-mobile {
flex: none;
- width: 66.66667%; }
+ width: 66.6666666667%; }
.column.is-offset-8-mobile {
- margin-left: 66.66667%; }
+ margin-left: 66.6666666667%; }
.column.is-9-mobile {
flex: none;
width: 75%; }
@@ -6273,14 +6273,14 @@ label.panel-block {
margin-left: 75%; }
.column.is-10-mobile {
flex: none;
- width: 83.33333%; }
+ width: 83.3333333333%; }
.column.is-offset-10-mobile {
- margin-left: 83.33333%; }
+ margin-left: 83.3333333333%; }
.column.is-11-mobile {
flex: none;
- width: 91.66667%; }
+ width: 91.6666666667%; }
.column.is-offset-11-mobile {
- margin-left: 91.66667%; }
+ margin-left: 91.6666666667%; }
.column.is-12-mobile {
flex: none;
width: 100%; }
@@ -6319,14 +6319,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-1, .column.is-1-tablet {
flex: none;
- width: 8.33333%; }
+ width: 8.3333333333%; }
.column.is-offset-1, .column.is-offset-1-tablet {
- margin-left: 8.33333%; }
+ margin-left: 8.3333333333%; }
.column.is-2, .column.is-2-tablet {
flex: none;
- width: 16.66667%; }
+ width: 16.6666666667%; }
.column.is-offset-2, .column.is-offset-2-tablet {
- margin-left: 16.66667%; }
+ margin-left: 16.6666666667%; }
.column.is-3, .column.is-3-tablet {
flex: none;
width: 25%; }
@@ -6334,14 +6334,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-4, .column.is-4-tablet {
flex: none;
- width: 33.33333%; }
+ width: 33.3333333333%; }
.column.is-offset-4, .column.is-offset-4-tablet {
- margin-left: 33.33333%; }
+ margin-left: 33.3333333333%; }
.column.is-5, .column.is-5-tablet {
flex: none;
- width: 41.66667%; }
+ width: 41.6666666667%; }
.column.is-offset-5, .column.is-offset-5-tablet {
- margin-left: 41.66667%; }
+ margin-left: 41.6666666667%; }
.column.is-6, .column.is-6-tablet {
flex: none;
width: 50%; }
@@ -6349,14 +6349,14 @@ label.panel-block {
margin-left: 50%; }
.column.is-7, .column.is-7-tablet {
flex: none;
- width: 58.33333%; }
+ width: 58.3333333333%; }
.column.is-offset-7, .column.is-offset-7-tablet {
- margin-left: 58.33333%; }
+ margin-left: 58.3333333333%; }
.column.is-8, .column.is-8-tablet {
flex: none;
- width: 66.66667%; }
+ width: 66.6666666667%; }
.column.is-offset-8, .column.is-offset-8-tablet {
- margin-left: 66.66667%; }
+ margin-left: 66.6666666667%; }
.column.is-9, .column.is-9-tablet {
flex: none;
width: 75%; }
@@ -6364,14 +6364,14 @@ label.panel-block {
margin-left: 75%; }
.column.is-10, .column.is-10-tablet {
flex: none;
- width: 83.33333%; }
+ width: 83.3333333333%; }
.column.is-offset-10, .column.is-offset-10-tablet {
- margin-left: 83.33333%; }
+ margin-left: 83.3333333333%; }
.column.is-11, .column.is-11-tablet {
flex: none;
- width: 91.66667%; }
+ width: 91.6666666667%; }
.column.is-offset-11, .column.is-offset-11-tablet {
- margin-left: 91.66667%; }
+ margin-left: 91.6666666667%; }
.column.is-12, .column.is-12-tablet {
flex: none;
width: 100%; }
@@ -6410,14 +6410,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-1-touch {
flex: none;
- width: 8.33333%; }
+ width: 8.3333333333%; }
.column.is-offset-1-touch {
- margin-left: 8.33333%; }
+ margin-left: 8.3333333333%; }
.column.is-2-touch {
flex: none;
- width: 16.66667%; }
+ width: 16.6666666667%; }
.column.is-offset-2-touch {
- margin-left: 16.66667%; }
+ margin-left: 16.6666666667%; }
.column.is-3-touch {
flex: none;
width: 25%; }
@@ -6425,14 +6425,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-4-touch {
flex: none;
- width: 33.33333%; }
+ width: 33.3333333333%; }
.column.is-offset-4-touch {
- margin-left: 33.33333%; }
+ margin-left: 33.3333333333%; }
.column.is-5-touch {
flex: none;
- width: 41.66667%; }
+ width: 41.6666666667%; }
.column.is-offset-5-touch {
- margin-left: 41.66667%; }
+ margin-left: 41.6666666667%; }
.column.is-6-touch {
flex: none;
width: 50%; }
@@ -6440,14 +6440,14 @@ label.panel-block {
margin-left: 50%; }
.column.is-7-touch {
flex: none;
- width: 58.33333%; }
+ width: 58.3333333333%; }
.column.is-offset-7-touch {
- margin-left: 58.33333%; }
+ margin-left: 58.3333333333%; }
.column.is-8-touch {
flex: none;
- width: 66.66667%; }
+ width: 66.6666666667%; }
.column.is-offset-8-touch {
- margin-left: 66.66667%; }
+ margin-left: 66.6666666667%; }
.column.is-9-touch {
flex: none;
width: 75%; }
@@ -6455,14 +6455,14 @@ label.panel-block {
margin-left: 75%; }
.column.is-10-touch {
flex: none;
- width: 83.33333%; }
+ width: 83.3333333333%; }
.column.is-offset-10-touch {
- margin-left: 83.33333%; }
+ margin-left: 83.3333333333%; }
.column.is-11-touch {
flex: none;
- width: 91.66667%; }
+ width: 91.6666666667%; }
.column.is-offset-11-touch {
- margin-left: 91.66667%; }
+ margin-left: 91.6666666667%; }
.column.is-12-touch {
flex: none;
width: 100%; }
@@ -6501,14 +6501,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-1-desktop {
flex: none;
- width: 8.33333%; }
+ width: 8.3333333333%; }
.column.is-offset-1-desktop {
- margin-left: 8.33333%; }
+ margin-left: 8.3333333333%; }
.column.is-2-desktop {
flex: none;
- width: 16.66667%; }
+ width: 16.6666666667%; }
.column.is-offset-2-desktop {
- margin-left: 16.66667%; }
+ margin-left: 16.6666666667%; }
.column.is-3-desktop {
flex: none;
width: 25%; }
@@ -6516,14 +6516,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-4-desktop {
flex: none;
- width: 33.33333%; }
+ width: 33.3333333333%; }
.column.is-offset-4-desktop {
- margin-left: 33.33333%; }
+ margin-left: 33.3333333333%; }
.column.is-5-desktop {
flex: none;
- width: 41.66667%; }
+ width: 41.6666666667%; }
.column.is-offset-5-desktop {
- margin-left: 41.66667%; }
+ margin-left: 41.6666666667%; }
.column.is-6-desktop {
flex: none;
width: 50%; }
@@ -6531,14 +6531,14 @@ label.panel-block {
margin-left: 50%; }
.column.is-7-desktop {
flex: none;
- width: 58.33333%; }
+ width: 58.3333333333%; }
.column.is-offset-7-desktop {
- margin-left: 58.33333%; }
+ margin-left: 58.3333333333%; }
.column.is-8-desktop {
flex: none;
- width: 66.66667%; }
+ width: 66.6666666667%; }
.column.is-offset-8-desktop {
- margin-left: 66.66667%; }
+ margin-left: 66.6666666667%; }
.column.is-9-desktop {
flex: none;
width: 75%; }
@@ -6546,14 +6546,14 @@ label.panel-block {
margin-left: 75%; }
.column.is-10-desktop {
flex: none;
- width: 83.33333%; }
+ width: 83.3333333333%; }
.column.is-offset-10-desktop {
- margin-left: 83.33333%; }
+ margin-left: 83.3333333333%; }
.column.is-11-desktop {
flex: none;
- width: 91.66667%; }
+ width: 91.6666666667%; }
.column.is-offset-11-desktop {
- margin-left: 91.66667%; }
+ margin-left: 91.6666666667%; }
.column.is-12-desktop {
flex: none;
width: 100%; }
@@ -6592,14 +6592,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-1-widescreen {
flex: none;
- width: 8.33333%; }
+ width: 8.3333333333%; }
.column.is-offset-1-widescreen {
- margin-left: 8.33333%; }
+ margin-left: 8.3333333333%; }
.column.is-2-widescreen {
flex: none;
- width: 16.66667%; }
+ width: 16.6666666667%; }
.column.is-offset-2-widescreen {
- margin-left: 16.66667%; }
+ margin-left: 16.6666666667%; }
.column.is-3-widescreen {
flex: none;
width: 25%; }
@@ -6607,14 +6607,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-4-widescreen {
flex: none;
- width: 33.33333%; }
+ width: 33.3333333333%; }
.column.is-offset-4-widescreen {
- margin-left: 33.33333%; }
+ margin-left: 33.3333333333%; }
.column.is-5-widescreen {
flex: none;
- width: 41.66667%; }
+ width: 41.6666666667%; }
.column.is-offset-5-widescreen {
- margin-left: 41.66667%; }
+ margin-left: 41.6666666667%; }
.column.is-6-widescreen {
flex: none;
width: 50%; }
@@ -6622,14 +6622,14 @@ label.panel-block {
margin-left: 50%; }
.column.is-7-widescreen {
flex: none;
- width: 58.33333%; }
+ width: 58.3333333333%; }
.column.is-offset-7-widescreen {
- margin-left: 58.33333%; }
+ margin-left: 58.3333333333%; }
.column.is-8-widescreen {
flex: none;
- width: 66.66667%; }
+ width: 66.6666666667%; }
.column.is-offset-8-widescreen {
- margin-left: 66.66667%; }
+ margin-left: 66.6666666667%; }
.column.is-9-widescreen {
flex: none;
width: 75%; }
@@ -6637,14 +6637,14 @@ label.panel-block {
margin-left: 75%; }
.column.is-10-widescreen {
flex: none;
- width: 83.33333%; }
+ width: 83.3333333333%; }
.column.is-offset-10-widescreen {
- margin-left: 83.33333%; }
+ margin-left: 83.3333333333%; }
.column.is-11-widescreen {
flex: none;
- width: 91.66667%; }
+ width: 91.6666666667%; }
.column.is-offset-11-widescreen {
- margin-left: 91.66667%; }
+ margin-left: 91.6666666667%; }
.column.is-12-widescreen {
flex: none;
width: 100%; }
@@ -6683,14 +6683,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-1-fullhd {
flex: none;
- width: 8.33333%; }
+ width: 8.3333333333%; }
.column.is-offset-1-fullhd {
- margin-left: 8.33333%; }
+ margin-left: 8.3333333333%; }
.column.is-2-fullhd {
flex: none;
- width: 16.66667%; }
+ width: 16.6666666667%; }
.column.is-offset-2-fullhd {
- margin-left: 16.66667%; }
+ margin-left: 16.6666666667%; }
.column.is-3-fullhd {
flex: none;
width: 25%; }
@@ -6698,14 +6698,14 @@ label.panel-block {
margin-left: 25%; }
.column.is-4-fullhd {
flex: none;
- width: 33.33333%; }
+ width: 33.3333333333%; }
.column.is-offset-4-fullhd {
- margin-left: 33.33333%; }
+ margin-left: 33.3333333333%; }
.column.is-5-fullhd {
flex: none;
- width: 41.66667%; }
+ width: 41.6666666667%; }
.column.is-offset-5-fullhd {
- margin-left: 41.66667%; }
+ margin-left: 41.6666666667%; }
.column.is-6-fullhd {
flex: none;
width: 50%; }
@@ -6713,14 +6713,14 @@ label.panel-block {
margin-left: 50%; }
.column.is-7-fullhd {
flex: none;
- width: 58.33333%; }
+ width: 58.3333333333%; }
.column.is-offset-7-fullhd {
- margin-left: 58.33333%; }
+ margin-left: 58.3333333333%; }
.column.is-8-fullhd {
flex: none;
- width: 66.66667%; }
+ width: 66.6666666667%; }
.column.is-offset-8-fullhd {
- margin-left: 66.66667%; }
+ margin-left: 66.6666666667%; }
.column.is-9-fullhd {
flex: none;
width: 75%; }
@@ -6728,14 +6728,14 @@ label.panel-block {
margin-left: 75%; }
.column.is-10-fullhd {
flex: none;
- width: 83.33333%; }
+ width: 83.3333333333%; }
.column.is-offset-10-fullhd {
- margin-left: 83.33333%; }
+ margin-left: 83.3333333333%; }
.column.is-11-fullhd {
flex: none;
- width: 91.66667%; }
+ width: 91.6666666667%; }
.column.is-offset-11-fullhd {
- margin-left: 91.66667%; }
+ margin-left: 91.6666666667%; }
.column.is-12-fullhd {
flex: none;
width: 100%; }
@@ -6813,37 +6813,37 @@ label.panel-block {
display: flex; }
.tile.is-1 {
flex: none;
- width: 8.33333%; }
+ width: 8.3333333333%; }
.tile.is-2 {
flex: none;
- width: 16.66667%; }
+ width: 16.6666666667%; }
.tile.is-3 {
flex: none;
width: 25%; }
.tile.is-4 {
flex: none;
- width: 33.33333%; }
+ width: 33.3333333333%; }
.tile.is-5 {
flex: none;
- width: 41.66667%; }
+ width: 41.6666666667%; }
.tile.is-6 {
flex: none;
width: 50%; }
.tile.is-7 {
flex: none;
- width: 58.33333%; }
+ width: 58.3333333333%; }
.tile.is-8 {
flex: none;
- width: 66.66667%; }
+ width: 66.6666666667%; }
.tile.is-9 {
flex: none;
width: 75%; }
.tile.is-10 {
flex: none;
- width: 83.33333%; }
+ width: 83.3333333333%; }
.tile.is-11 {
flex: none;
- width: 91.66667%; }
+ width: 91.6666666667%; }
.tile.is-12 {
flex: none;
width: 100%; } }
diff --git a/content/docs/4.5.0/admin/autorecovery/index.html b/content/docs/4.5.0/admin/autorecovery/index.html
index b766cae..a6ae70d 100644
--- a/content/docs/4.5.0/admin/autorecovery/index.html
+++ b/content/docs/4.5.0/admin/autorecovery/index.html
@@ -474,20 +474,18 @@
<p>Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="c"># IP and port for the failed bookie</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If you wish, you can also specify which bookie you’d like to rereplicate to. Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="se">\ </span> <span class="c"># IP and port for the failed bookie</span>
192.168.1.11:3181 <span class="c"># IP and port for the bookie to rereplicate to</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="the-manual-recovery-process">The manual recovery process</h3>
@@ -520,9 +518,8 @@
<p>You can start up AutoRecovery using the <a href="../../reference/cli#bookkeeper-autorecovery"><code class="highlighter-rouge">autorecovery</code></a> command of the <a href="../../reference/cli"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool.</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
+</code></pre></div></div>
<blockquote>
<p>The most important thing to ensure when starting up AutoRecovery is that the ZooKeeper connection string specified by the <a href="../../reference/config#zkServers"><code class="highlighter-rouge">zkServers</code></a> parameter points to the right ZooKeeper cluster.</p>
@@ -542,15 +539,13 @@
<p>You can disable AutoRecover using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -disable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-disable</span>
+</code></pre></div></div>
<p>Once disabled, you can reenable AutoRecovery using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">enable</code></a> shell command:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -enable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-enable</span>
+</code></pre></div></div>
<h2 id="autorecovery-architecture">AutoRecovery architecture</h2>
diff --git a/content/docs/4.5.0/admin/bookies/index.html b/content/docs/4.5.0/admin/bookies/index.html
index a8cef50..b6d3b4d 100644
--- a/content/docs/4.5.0/admin/bookies/index.html
+++ b/content/docs/4.5.0/admin/bookies/index.html
@@ -484,15 +484,13 @@
<p>To start a bookie in the foreground, use the <a href="../../reference/cli#bookkeeper-bookie"><code class="highlighter-rouge">bookie</code></a> command of the <a href="../../reference/cli#bookkeeper"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>To start a bookie in the background, use the <a href="../../reference/cli#bookkeeper-daemon.sh"><code class="highlighter-rouge">bookkeeper-daemon.sh</code></a> script and run <code class="highlighter-rouge">start bookie</code>:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
+</code></pre></div></div>
<h3 id="local-bookies">Local bookies</h3>
@@ -500,9 +498,8 @@
<p>This would spin up a local ensemble of 6 bookies:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
+</code></pre></div></div>
<blockquote>
<p>When you run a local bookie ensemble, all bookies run in a single JVM process.</p>
@@ -556,18 +553,16 @@
<p>To enable logging for a bookie, create a <code class="highlighter-rouge">log4j.properties</code> file and point the <code class="highlighter-rouge">BOOKIE_LOG_CONF</code> environment variable to the configuration file. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
-<span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
+<span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<h2 id="upgrading">Upgrading</h2>
<p>From time to time you may need to make changes to the filesystem layout of bookies—changes that are incompatible with previous versions of BookKeeper and require that directories used with previous versions are upgraded. If a filesystem upgrade is required when updating BookKeeper, the bookie will fail to start and return an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
+</code></pre></div></div>
<p>BookKeeper provides a utility for upgrading the filesystem. You can perform an upgrade using the <a href="../../reference/cli#bookkeeper-upgrade"><code class="highlighter-rouge">upgrade</code></a> command of the <code class="highlighter-rouge">bookkeeper</code> CLI tool. When running <code class="highlighter-rouge">bookkeeper upgrade</code> you need to specify one of three flags:</p>
@@ -598,27 +593,23 @@
<p>A standard upgrade pattern is to run an upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --upgrade
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--upgrade</span>
+</code></pre></div></div>
<p>…then check that everything is working normally, then kill the bookie. If everything is okay, finalize the upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --finalize
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--finalize</span>
+</code></pre></div></div>
<p>…and then restart the server:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>If something has gone wrong, you can always perform a rollback:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --rollback
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--rollback</span>
+</code></pre></div></div>
<h2 id="formatting">Formatting</h2>
@@ -626,15 +617,13 @@
<p>By default, formatting is done in interactive mode, which prompts you to confirm the format operation if old data exists. You can disable confirmation using the <code class="highlighter-rouge">-nonInteractive</code> flag. If old data does exist, the format operation will abort <em>unless</em> you set the <code class="highlighter-rouge">-force</code> flag. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
+</code></pre></div></div>
<p>You can format the local filesystem data on a bookie using the <a href="../../reference/cli#bookkeeper-shell-bookieformat"><code class="highlighter-rouge">bookieformat</code></a> command on each bookie. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
+</code></pre></div></div>
<blockquote>
<p>The <code class="highlighter-rouge">-force</code> and <code class="highlighter-rouge">-nonInteractive</code> flags are also available for the <code class="highlighter-rouge">bookieformat</code> command.</p>
@@ -648,13 +637,12 @@
<p>Accidentally replacing disks or removing directories can cause a bookie to fail while trying to read a ledger fragment that, according to the ledger metadata, exists on the bookie. For this reason, when a bookie is started for the first time, its disk configuration is fixed for the lifetime of that bookie. Any change to its disk configuration, such as a crashed disk or an accidental configuration change, will result in the bookie being unable to start. That will throw an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
.......at org.apache.bookkeeper.bookie.Cookie.verify(Cookie.java:82)
.......at org.apache.bookkeeper.bookie.Bookie.checkEnvironment(Bookie.java:275)
.......at org.apache.bookkeeper.bookie.Bookie.<init>(Bookie.java:351)
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If the change was the result of an accidental configuration change, the change can be reverted and the bookie can be restarted. However, if the change <em>cannot</em> be reverted, such as is the case when you want to add a new disk or replace a disk, the bookie must be wiped and then all its data re-replicated onto it.</p>
@@ -665,21 +653,19 @@ org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
<li>
<p>Run the following command to re-replicate the data:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
<zkserver> <span class="se">\</span>
<oldbookie> <span class="se">\</span>
<newbookie>
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>The ZooKeeper server, old bookie, and new bookie, are all identified by their external IP and <code class="highlighter-rouge">bookiePort</code> (3181 by default). Here’s an example:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
zk1.example.com <span class="se">\</span>
192.168.1.10:3181 <span class="se">\</span>
192.168.1.10:3181
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>See the <a href="../autorecovery">AutoRecovery</a> documentation for more info on the re-replication process.</p>
</li>
diff --git a/content/docs/4.5.0/api/ledger-adv-api/index.html b/content/docs/4.5.0/api/ledger-adv-api/index.html
index 6c7a5d8..d82d192 100644
--- a/content/docs/4.5.0/api/ledger-adv-api/index.html
+++ b/content/docs/4.5.0/api/ledger-adv-api/index.html
@@ -471,17 +471,16 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<p>Here’s an exmaple:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You can also create advanced ledgers asynchronously.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">createComplete</span><span class="o">(</span><span class="kt">int</span> <span class="n">returnCode</span><span class="o">,</span> <span class="n">LedgerHandle</span> <span class="n">handle</span><span class="o">,</span> <span class="n">Object</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Ledger successfully created"</span><span class="o">);</span>
<span class="o">}</span>
@@ -495,12 +494,11 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="k">new</span> <span class="nf">LedgerCreationCallback</span><span class="o">(),</span>
<span class="s">"some context"</span>
<span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Besides the APIs above, BookKeeper allows users providing <code class="highlighter-rouge">ledger-id</code> when creating advanced ledgers.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
@@ -508,8 +506,7 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>Please note, it is users’ responsibility to provide a unique ledger id when using the API above.
@@ -522,11 +519,10 @@ a <a href="../javadoc/org/apache/bookkeeper/client/BKException.BKLedgerExistExce
<p>The normal <a href="ledger-api/#adding-entries-to-ledgers">add entries api</a> in advanced ledgers are disabled. Instead, when users want to add entries
to advanced ledgers, an entry id is required to pass in along with the entry data when adding an entry.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
<span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="n">entryId</span><span class="o">,</span> <span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>A few notes when using this API:</p>
diff --git a/content/docs/4.5.0/api/ledger-api/index.html b/content/docs/4.5.0/api/ledger-api/index.html
index 65b3b62..98244f1 100644
--- a/content/docs/4.5.0/api/ledger-api/index.html
+++ b/content/docs/4.5.0/api/ledger-api/index.html
@@ -473,7 +473,7 @@
<p>If you’re using <a href="https://maven.apache.org/">Maven</a>, add this to your <a href="https://maven.apache.org/guides/introduction/introduction-to-the-pom.html"><code class="highlighter-rouge">pom.xml</code></a> build configuration file:</p>
-<div class="language-xml highlighter-rouge"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
<span class="nt"><bookkeeper.version></span>4.5.0<span class="nt"></bookkeeper.version></span>
<span class="c"><!-- in your <dependencies> block --></span>
@@ -482,14 +482,13 @@
<span class="nt"><artifactId></span>bookkeeper-server<span class="nt"></artifactId></span>
<span class="nt"><version></span>${bookkeeper.version}<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="gradle">Gradle</h3>
<p>If you’re using <a href="https://gradle.org/">Gradle</a>, add this to your <a href="https://spring.io/guides/gs/gradle/"><code class="highlighter-rouge">build.gradle</code></a> build configuration file:</p>
-<div class="language-groovy highlighter-rouge"><pre class="highlight"><code><span class="n">dependencies</span> <span class="o">{</span>
+<div class="language-groovy highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="nl">group:</span> <span class="s1">'org.apache.bookkeeper'</span><span class="o">,</span> <span class="nl">name:</span> <span class="s1">'bookkeeper-server'</span><span class="o">,</span> <span class="nl">version:</span> <span class="s1">'4.5.0'</span>
<span class="o">}</span>
@@ -497,8 +496,7 @@
<span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="s1">'org.apache.bookkeeper:bookkeeper-server:4.5.0'</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="connection-string">Connection string</h2>
@@ -514,14 +512,13 @@
<p>In order to create a new <a href="../javadoc/org/apache/bookkeeper/client/BookKeeper"><code class="highlighter-rouge">BookKeeper</code></a> client object, you need to pass in a <a href="#connection-string">connection string</a>. Here is an example client object using a ZooKeeper connection string:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="k">try</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">try</span> <span class="o">{</span>
<span class="n">String</span> <span class="n">connectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span> <span class="c1">// For a single-node, local ZooKeeper cluster</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">connectionString</span><span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">InterruptedException</span> <span class="o">|</span> <span class="n">IOException</span> <span class="o">|</span> <span class="n">KeeperException</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
<span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>If you’re running BookKeeper <a href="../../getting-started/run-locally">locally</a>, using the <a href="../../reference/cli#bookkeeper-localbookie"><code class="highlighter-rouge">localbookie</code></a> command, use <code class="highlighter-rouge">"127.0.0.1:2181"</code> for your connection string, as in the example above.</p>
@@ -533,29 +530,26 @@
<li>
<p>By passing in a <a href="../javadoc/org/apache/bookkeeper/conf/ClientConfiguration"><code class="highlighter-rouge">ClientConfiguration</code></a> object. Here’s an example:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">config</span><span class="o">.</span><span class="na">setZkServers</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
<span class="n">config</span><span class="o">.</span><span class="na">setAddEntryTimeout</span><span class="o">(</span><span class="mi">2000</span><span class="o">);</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">config</span><span class="o">);</span>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>By specifying a <code class="highlighter-rouge">ClientConfiguration</code> and a <a href="http://zookeeper.apache.org/doc/current/api/org/apache/zookeeper/ZooKeeper.html"><code class="highlighter-rouge">ZooKeeper</code></a> client object:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">config</span><span class="o">.</span><span class="na">setAddEntryTimeout</span><span class="o">(</span><span class="mi">5000</span><span class="o">);</span>
<span class="n">ZooKeeper</span> <span class="n">zkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ZooKeeper</span><span class="o">(</span><span class="cm">/* client args */</span><span class="o">);</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">config</span><span class="o">,</span> <span class="n">zkClient</span><span class="o">);</span>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Using the <code class="highlighter-rouge">forConfig</code> method:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="n">BookKeeper</span><span class="o">.</span><span class="na">forConfig</span><span class="o">(</span><span class="n">conf</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
- </div>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="n">BookKeeper</span><span class="o">.</span><span class="na">forConfig</span><span class="o">(</span><span class="n">conf</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
+</code></pre></div> </div>
</li>
</ul>
@@ -565,16 +559,15 @@
<p>Here’s an example:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandle</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedger</span><span class="o">(</span><span class="n">BookKeeper</span><span class="o">.</span><span class="na">DigestType</span><span class="o">.</span><span class="na">MAC</span><span class="o">,</span> <span class="n">password</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You can also create ledgers asynchronously</p>
<h3 id="create-ledgers-asynchronously">Create ledgers asynchronously</h3>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">createComplete</span><span class="o">(</span><span class="kt">int</span> <span class="n">returnCode</span><span class="o">,</span> <span class="n">LedgerHandle</span> <span class="n">handle</span><span class="o">,</span> <span class="n">Object</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Ledger successfully created"</span><span class="o">);</span>
<span class="o">}</span>
@@ -588,34 +581,30 @@
<span class="k">new</span> <span class="nf">LedgerCreationCallback</span><span class="o">(),</span>
<span class="s">"some context"</span>
<span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="adding-entries-to-ledgers">Adding entries to ledgers</h2>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
+</code></pre></div></div>
<h3 id="add-entries-asynchronously">Add entries asynchronously</h3>
<h2 id="reading-entries-from-ledgers">Reading entries from ledgers</h2>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span> <span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">1</span><span class="o">,</span> <span class="mi">99</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span> <span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">1</span><span class="o">,</span> <span class="mi">99</span><span class="o">);</span>
+</code></pre></div></div>
<p>To read all possible entries from the ledger:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
<span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">0</span><span class="o">,</span> <span class="n">handle</span><span class="o">.</span><span class="na">getLastAddConfirmed</span><span class="o">());</span>
<span class="k">while</span> <span class="o">(</span><span class="n">entries</span><span class="o">.</span><span class="na">hasNextElement</span><span class="o">())</span> <span class="o">{</span>
<span class="n">LedgerEntry</span> <span class="n">entry</span> <span class="o">=</span> <span class="n">entries</span><span class="o">.</span><span class="na">nextElement</span><span class="o">();</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Successfully read entry "</span> <span class="o">+</span> <span class="n">entry</span><span class="o">.</span><span class="na">getId</span><span class="o">());</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="reading-entries-after-the-lastaddconfirmed-range">Reading entries after the LastAddConfirmed range</h3>
@@ -625,29 +614,27 @@ For entries which are within the range 0..LastAddConfirmed BookKeeper guarantees
For entries outside that range it is possible that the writer never received the acknowledge and so there is the risk that the reader is seeing entries before the writer and this could result in a consistency issue in some cases.
With this method you can even read entries before the LastAddConfirmed and entries after it with one call, the expected consistency will be as described above.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
<span class="n">handle</span><span class="o">.</span><span class="na">readUnconfirmedEntries</span><span class="o">(</span><span class="mi">0</span><span class="o">,</span> <span class="n">lastEntryIdExpectedToRead</span><span class="o">);</span>
<span class="k">while</span> <span class="o">(</span><span class="n">entries</span><span class="o">.</span><span class="na">hasNextElement</span><span class="o">())</span> <span class="o">{</span>
<span class="n">LedgerEntry</span> <span class="n">entry</span> <span class="o">=</span> <span class="n">entries</span><span class="o">.</span><span class="na">nextElement</span><span class="o">();</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Successfully read entry "</span> <span class="o">+</span> <span class="n">entry</span><span class="o">.</span><span class="na">getId</span><span class="o">());</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="deleting-ledgers">Deleting ledgers</h2>
<p><span class="pop" id="ledger-popover">Ledgers</span> can also be deleted synchronously or asynchronously.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="mi">1234</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="mi">1234</span><span class="o">;</span>
<span class="k">try</span> <span class="o">{</span>
<span class="n">bkClient</span><span class="o">.</span><span class="na">deleteLedger</span><span class="o">(</span><span class="n">ledgerId</span><span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">Exception</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
<span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="delete-entries-asynchronously">Delete entries asynchronously</h3>
@@ -655,13 +642,12 @@ With this method you can even read entries before the LastAddConfirmed and entri
<p>*</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">DeleteEntryCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">DeleteCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">DeleteEntryCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">DeleteCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">deleteComplete</span><span class="o">()</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Delete completed"</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="simple-example">Simple example</h2>
@@ -679,7 +665,7 @@ With this method you can even read entries before the LastAddConfirmed and entri
<li>reads all available entries</li>
</ul>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="c1">// Create a client object for the local ensemble. This</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// Create a client object for the local ensemble. This</span>
<span class="c1">// operation throws multiple exceptions, so make sure to</span>
<span class="c1">// use a try/catch block when instantiating client objects.</span>
<span class="n">BookKeeper</span> <span class="n">bkc</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"localhost:2181"</span><span class="o">);</span>
@@ -721,17 +707,15 @@ With this method you can even read entries before the LastAddConfirmed and entri
<span class="c1">// Close the ledger and the client</span>
<span class="n">lh</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
<span class="n">bkc</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Running this should return this output:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>Result: 0
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Result: 0
Result: 1
Result: 2
<span class="c"># etc</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="example-application">Example application</h2>
@@ -747,9 +731,8 @@ Result: 2
<p>To start up a cluster consisting of six <span class="pop" id="bookie-popover">bookies</span> locally:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
+</code></pre></div></div>
<p>You can specify a different number of bookies if you’d like.</p>
@@ -767,15 +750,14 @@ Result: 2
<p>To begin, download the base application, compile and run it.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>git clone https://github.com/ivankelly/bookkeeper-tutorial.git
-<span class="gp">$ </span>mvn package
-<span class="gp">$ </span>mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>git clone https://github.com/ivankelly/bookkeeper-tutorial.git
+<span class="nv">$ </span>mvn package
+<span class="nv">$ </span>mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+</code></pre></div></div>
<p>That should yield output that looks something like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>[INFO] Scanning for projects...
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building tutorial 1.0-SNAPSHOT
@@ -786,14 +768,13 @@ Result: 2
Value = 4
Value = 5
Value = 3
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="the-base-application">The base application</h3>
<p>The application in this tutorial is a dice application. The <code class="highlighter-rouge">Dice</code> class below has a <code class="highlighter-rouge">playDice</code> function that generates a random number between 1 and 6 every second, prints the value of the dice roll, and runs indefinitely.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
<span class="n">Random</span> <span class="n">r</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Random</span><span class="o">();</span>
<span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
@@ -803,12 +784,11 @@ Value = 3
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>When you run the <code class="highlighter-rouge">main</code> function of this class, a new <code class="highlighter-rouge">Dice</code> object will be instantiated and then run indefinitely:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
<span class="c1">// other methods</span>
<span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
@@ -816,8 +796,7 @@ Value = 3
<span class="n">d</span><span class="o">.</span><span class="na">playDice</span><span class="o">();</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="leaders-and-followers-and-a-bit-of-background">Leaders and followers (and a bit of background)</h3>
@@ -845,7 +824,7 @@ Value = 3
<p>We’ll use zookeeper to elect a leader. A zookeeper instance will have started locally when you started the localbookie application above. To verify it’s running, run the following command.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span><span class="nb">echo </span>stat | nc localhost 2181
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">echo stat</span> | nc localhost 2181
Zookeeper version: 3.4.6-1569965, built on 02/20/2014 09:09 GMT
Clients:
/127.0.0.1:59343[1]<span class="o">(</span><span class="nv">queued</span><span class="o">=</span>0,recved<span class="o">=</span>40,sent<span class="o">=</span>41<span class="o">)</span>
@@ -863,12 +842,11 @@ Outstanding: 0
Zxid: 0x11
Mode: standalone
Node count: 16
-</code></pre>
-</div>
+</code></pre></div></div>
<p>To interact with zookeeper, we’ll use the Curator client rather than the stock zookeeper client. Getting things right with the zookeeper client can be tricky, and curator removes a lot of the pointy corners for you. In fact, curator even provides a leader election recipe, so we need to do very little work to get leader election in our application.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="kd">extends</span> <span class="n">LeaderSelectorListenerAdapter</span> <span class="kd">implements</span> <span class="n">Closeable</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="kd">extends</span> <span class="n">LeaderSelectorListenerAdapter</span> <span class="kd">implements</span> <span class="n">Closeable</span> <span class="o">{</span>
<span class="kd">final</span> <span class="kd">static</span> <span class="n">String</span> <span class="n">ZOOKEEPER_SERVER</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
<span class="kd">final</span> <span class="kd">static</span> <span class="n">String</span> <span class="n">ELECTION_PATH</span> <span class="o">=</span> <span class="s">"/dice-elect"</span><span class="o">;</span>
@@ -885,8 +863,7 @@ Node count: 16
<span class="n">leaderSelector</span><span class="o">.</span><span class="na">autoRequeue</span><span class="o">();</span>
<span class="n">leaderSelector</span><span class="o">.</span><span class="na">start</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>In the constructor for Dice, we need to create the curator client. We specify four things when creating the client, the location of the zookeeper service, the session timeout, the connect timeout and the retry policy.</p>
@@ -894,7 +871,7 @@ Node count: 16
<p>Finally, you’ll have noticed that Dice now extends LeaderSelectorListenerAdapter and implements Closeable. Closeable is there to close the resource we have initialized in the constructor, the curator client and the leaderSelector. LeaderSelectorListenerAdapter is a callback that the leaderSelector uses to notify the instance that it is now the leader. It is passed as the third argument to the LeaderSelector constructor.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="nd">@Override</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nd">@Override</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">takeLeadership</span><span class="o">(</span><span class="n">CuratorFramework</span> <span class="n">client</span><span class="o">)</span>
<span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
<span class="kd">synchronized</span> <span class="o">(</span><span class="k">this</span><span class="o">)</span> <span class="o">{</span>
@@ -909,12 +886,11 @@ Node count: 16
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>takeLeadership() is the callback called by LeaderSelector when the instance is leader. It should only return when the instance wants to give up leadership. In our case, we never do so we wait on the current object until we’re interrupted. To signal to the rest of the program that we are leader we set a volatile boolean called leader to true. This is unset after we are interrupted.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
<span class="k">while</span> <span class="o">(</span><span class="kc">true</span><span class="o">)</span> <span class="o">{</span>
<span class="k">while</span> <span class="o">(</span><span class="n">leader</span><span class="o">)</span> <span class="o">{</span>
<span class="n">Thread</span><span class="o">.</span><span class="na">sleep</span><span class="o">(</span><span class="mi">1000</span><span class="o">);</span>
@@ -923,8 +899,7 @@ Node count: 16
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Finally, we modify the <code class="highlighter-rouge">playDice</code> function to only generate random numbers when it is the leader.</p>
@@ -934,18 +909,17 @@ Node count: 16
<p>Now go back to the shell that the original leader was on and wake up the process using fg. You’ll see something like the following:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>...
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>...
...
Value <span class="o">=</span> 4, isLeader <span class="o">=</span> <span class="nb">true
</span>Value <span class="o">=</span> 4, isLeader <span class="o">=</span> <span class="nb">true</span>
^Z
-<span class="o">[</span>1]+ Stopped mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
-<span class="gp">$ </span><span class="nb">fg
-</span>mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+<span class="o">[</span>1]+ Stopped mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+<span class="nv">$ </span><span class="nb">fg
+</span>mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
Value <span class="o">=</span> 3, isLeader <span class="o">=</span> <span class="nb">true
</span>Value <span class="o">=</span> 1, isLeader <span class="o">=</span> <span class="nb">false</span>
-</code></pre>
-</div>
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.5.0/deployment/dcos/index.html b/content/docs/4.5.0/deployment/dcos/index.html
index cebde7d..f610417 100644
--- a/content/docs/4.5.0/deployment/dcos/index.html
+++ b/content/docs/4.5.0/deployment/dcos/index.html
@@ -485,9 +485,8 @@
<h2 id="installing-bookkeeper">Installing BookKeeper</h2>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper --yes
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="nt">--yes</span>
+</code></pre></div></div>
<p>This command will:</p>
@@ -499,7 +498,7 @@
<p>The bookie that is automatically started up uses the host mode of the network and by default exports the service at <code class="highlighter-rouge">agent_ip:3181</code>.</p>
<blockquote>
- <p>If you run <code class="highlighter-rouge">dcos package install bookkeeper</code> without setting the <code class="highlighter-rouge">--yes</code> flag, the install will run in interactive mode. For more information on the <code class="highlighter-rouge">package install</code> command, see the <a href="https://docs.mesosphere.com/latest/cli/command-reference/dcos-package/dcos-package-install/">DC/OS docs</a>.</p>
+ <p>If you run <code class="highlighter-rouge">dcos package install bookkeeper</code> without setting the <code class="highlighter-rouge">--yes</code> flag, the install will run in interactive mode. For more information on the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">install</span></code> command, see the <a href="https://docs.mesosphere.com/latest/cli/command-reference/dcos-package/dcos-package-install/">DC/OS docs</a>.</p>
</blockquote>
<h3 id="services">Services</h3>
@@ -532,15 +531,13 @@
<p>To connect to bookies running on DC/OS using clients running within your Mesos cluster, you need to specify the ZooKeeper connection string for DC/OS’s ZooKeeper cluster:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>master.mesos:2181
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>master.mesos:2181
+</code></pre></div></div>
<p>This is the <em>only</em> ZooKeeper host/port you need to include in your connection string. Here’s an example using the <a href="../../api/ledger-api#the-java-ledger-api-client">Java client</a>:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"master.mesos:2181"</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"master.mesos:2181"</span><span class="o">);</span>
+</code></pre></div></div>
<p>If you’re connecting using a client running outside your Mesos cluster, you need to supply the public-facing connection string for your DC/OS ZooKeeper cluster.</p>
@@ -550,17 +547,15 @@
<p>You can supply a non-default configuration when installing the package using a JSON file. Here’s an example command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper <span class="se">\</span>
- --options<span class="o">=</span>/path/to/config.json
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="se">\</span>
+ <span class="nt">--options</span><span class="o">=</span>/path/to/config.json
+</code></pre></div></div>
-<p>You can then fetch the current configuration for BookKeeper at any time using the <code class="highlighter-rouge">package describe</code> command:</p>
+<p>You can then fetch the current configuration for BookKeeper at any time using the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">describe</span></code> command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package describe bookkeeper <span class="se">\</span>
- --config
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package describe bookkeeper <span class="se">\</span>
+ <span class="nt">--config</span>
+</code></pre></div></div>
<h3 id="available-parameters">Available parameters</h3>
@@ -627,31 +622,28 @@
<p>Here’s an example JSON configuration object for BookKeeper on DC/OS:</p>
-<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
- </span><span class="nt">"instances"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
- </span><span class="nt">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
- </span><span class="nt">"mem"</span><span class="p">:</span><span class="w"> </span><span class="mf">2048.0</span><span class="p">,</span><span class="w">
- </span><span class="nt">"volume_size"</span><span class="p">:</span><span class="w"> </span><span class="mi">250</span><span class="w">
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"instances"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"mem"</span><span class="p">:</span><span class="w"> </span><span class="mf">2048.0</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"volume_size"</span><span class="p">:</span><span class="w"> </span><span class="mi">250</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
-</div>
+</span></code></pre></div></div>
<p>If that configuration were stored in a file called <code class="highlighter-rouge">bk-config.json</code>, you could apply that configuration upon installating the BookKeeper package using this command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper <span class="se">\</span>
- --options<span class="o">=</span>./bk-config.json
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="se">\</span>
+ <span class="nt">--options</span><span class="o">=</span>./bk-config.json
+</code></pre></div></div>
<h2 id="uninstalling-bookkeeper">Uninstalling BookKeeper</h2>
-<p>You can shut down and uninstall the <code class="highlighter-rouge">bookkeeper</code> from DC/OS at any time using the <code class="highlighter-rouge">package uninstall</code> command:</p>
+<p>You can shut down and uninstall the <code class="highlighter-rouge">bookkeeper</code> from DC/OS at any time using the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">uninstall</span></code> command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package uninstall bookkeeper
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package uninstall bookkeeper
Uninstalled package <span class="o">[</span>bookkeeper] version <span class="o">[</span>4.5.0]
Thank you <span class="k">for </span>using bookkeeper.
-</code></pre>
-</div>
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.5.0/deployment/manual/index.html b/content/docs/4.5.0/deployment/manual/index.html
index ac0ce6b..3202aaa 100644
--- a/content/docs/4.5.0/deployment/manual/index.html
+++ b/content/docs/4.5.0/deployment/manual/index.html
@@ -472,9 +472,8 @@
<p>On each bookie host, you need to <a href="../../getting-started/installation#download">download</a> the BookKeeper package as a tarball. Once you’ve done that, you need to configure the bookie by setting values in the <code class="highlighter-rouge">bookkeeper-server/conf/bk_server.conf</code> config file. The one parameter that you will absolutely need to change is the <a href="../../config#zkServers"><code class="highlighter-rouge">zkServers</code></a> parameter, which you will need [...]
-<div class="language-properties highlighter-rouge"><pre class="highlight"><code><span class="py">zkServers</span><span class="p">=</span><span class="s">100.0.0.1:2181,100.0.0.2:2181,100.0.0.3:2181</span>
-</code></pre>
-</div>
+<div class="language-properties highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="py">zkServers</span><span class="p">=</span><span class="s">100.0.0.1:2181,100.0.0.2:2181,100.0.0.3:2181</span>
+</code></pre></div></div>
<blockquote>
<p>A full listing of configurable parameters available in <code class="highlighter-rouge">bookkeeper-server/conf/bk_server.conf</code> can be found in the <a href="../../reference/config">Configuration</a> reference manual.</p>
@@ -482,9 +481,8 @@
<p>Once the bookie’s configuration is set, you can start it up using the <a href="../../reference/cli#bookkeeper-bookie"><code class="highlighter-rouge">bookie</code></a> command of the <a href="../../reference/cli#bookkeeper"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<blockquote>
<p>You can also build BookKeeper <a href="../../getting-started/installation#clone">by cloning it from source</a> or <a href="../../getting-started/installation#build-using-maven">using Maven</a>.</p>
@@ -519,9 +517,8 @@
<p>Once you’ve started up a cluster of bookies, you need to set up cluster metadata for the cluster by running the following command from any bookie in the cluster:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
+</code></pre></div></div>
<p>You can run in the formatting</p>
diff --git a/content/docs/4.5.0/getting-started/concepts/index.html b/content/docs/4.5.0/getting-started/concepts/index.html
index af61267..6c2c7d1 100644
--- a/content/docs/4.5.0/getting-started/concepts/index.html
+++ b/content/docs/4.5.0/getting-started/concepts/index.html
@@ -679,10 +679,9 @@
<p>BookKeeper requires a ZooKeeper installation for storing <a href="#ledger">ledger</a> metadata. Whenever you construct a <a href="../../api/javadoc/org/apache/bookkeeper/client/BookKeeper"><code class="highlighter-rouge">BookKeeper</code></a> client object, you need to pass a list of ZooKeeper servers as a parameter to the constructor, like this:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">String</span> <span class="n">zkConnectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">String</span> <span class="n">zkConnectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>For more info on using the BookKeeper Java client, see <a href="../../api/ledger-api#the-java-ledger-api-client">this guide</a>.</p>
@@ -714,15 +713,13 @@
<p>The <em>hierarchical ledger manager</em>, implemented in the <a href="../../api/javadoc/org/apache/bookkeeper/meta/HierarchicalLedgerManager"><code class="highlighter-rouge">HierarchicalLedgerManager</code></a> class, first obtains a global unique ID from ZooKeeper using an <a href="https://zookeeper.apache.org/doc/current/api/org/apache/zookeeper/CreateMode.html#EPHEMERAL_SEQUENTIAL"><code class="highlighter-rouge">EPHEMERAL_SEQUENTIAL</code></a> znode. Since ZooKeeper’s sequence cou [...]
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="o">{</span>level1 <span class="o">(</span>2 digits<span class="o">)}{</span>level2 <span class="o">(</span>4 digits<span class="o">)}{</span>level3 <span class="o">(</span>4 digits<span class="o">)}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">{</span>level1 <span class="o">(</span>2 digits<span class="o">)}{</span>level2 <span class="o">(</span>4 digits<span class="o">)}{</span>level3 <span class="o">(</span>4 digits<span class="o">)}</span>
+</code></pre></div></div>
<p>These three parts are used to form the actual ledger node path to store ledger metadata:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="o">{</span>ledgers_root_path<span class="o">}</span>/<span class="o">{</span>level1<span class="o">}</span>/<span class="o">{</span>level2<span class="o">}</span>/L<span class="o">{</span>level3<span class="o">}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">{</span>ledgers_root_path<span class="o">}</span>/<span class="o">{</span>level1<span class="o">}</span>/<span class="o">{</span>level2<span class="o">}</span>/L<span class="o">{</span>level3<span class="o">}</span>
+</code></pre></div></div>
<p>For example, ledger 0000000001 is split into three parts, 00, 0000, and 00001, and stored in znode <code class="highlighter-rouge">/{ledgers_root_path}/00/0000/L0001</code>. Each znode could have as many 10,000 ledgers, which avoids the problem of the child list being larger than the maximum ZooKeeper packet size (which is the <a href="https://issues.apache.org/jira/browse/BOOKKEEPER-39">limitation</a> that initially prompted the creation of the hierarchical ledger manager).</p>
diff --git a/content/docs/4.5.0/getting-started/installation/index.html b/content/docs/4.5.0/getting-started/installation/index.html
index 3ce8cd2..2ae505f 100644
--- a/content/docs/4.5.0/getting-started/installation/index.html
+++ b/content/docs/4.5.0/getting-started/installation/index.html
@@ -470,31 +470,28 @@
<p>You can download Apache BookKeeper releases from one of many <a href="http://www.apache.org/dyn/closer.cgi/bookkeeper">Apache mirrors</a>. Here’s an example for the <a href="http://apache.claz.org/bookkeeper">apache.claz.org</a> mirror:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>curl -O http://apache.claz.org/bookkeeper/bookkeeper-4.6.1/bookkeeper-4.6.1-src.tar.gz
-<span class="gp">$ </span>tar xvf bookkeeper-4.6.1-src.tar.gz
-<span class="gp">$ </span><span class="nb">cd </span>bookkeeper-4.6.1
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-O</span> http://apache.claz.org/bookkeeper/bookkeeper-4.6.1/bookkeeper-4.6.1-src.tar.gz
+<span class="nv">$ </span><span class="nb">tar </span>xvf bookkeeper-4.6.1-src.tar.gz
+<span class="nv">$ </span><span class="nb">cd </span>bookkeeper-4.6.1
+</code></pre></div></div>
<h2 id="clone">Clone</h2>
<p>To build BookKeeper from source, clone the repository, either from the <a href="https://github.com/apache/bookkeeper">GitHub mirror</a> or from the <a href="http://git.apache.org/bookkeeper.git/">Apache repository</a>:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="c"># From the GitHub mirror</span>
-<span class="gp">$ </span>git clone https://github.com/apache/bookkeeper
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># From the GitHub mirror</span>
+<span class="nv">$ </span>git clone https://github.com/apache/bookkeeper
<span class="c"># From Apache directly</span>
-<span class="gp">$ </span>git clone git://git.apache.org/bookkeeper.git/
-</code></pre>
-</div>
+<span class="nv">$ </span>git clone git://git.apache.org/bookkeeper.git/
+</code></pre></div></div>
<h2 id="build-using-maven">Build using Maven</h2>
<p>Once you have the BookKeeper on your local machine, either by <a href="#download">downloading</a> or <a href="#clone">cloning</a> it, you can then build BookKeeper from source using Maven:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>mvn package
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>mvn package
+</code></pre></div></div>
<blockquote>
<p>You can skip tests by adding the <code class="highlighter-rouge">-DskipTests</code> flag when running <code class="highlighter-rouge">mvn package</code>.</p>
diff --git a/content/docs/4.5.0/getting-started/run-locally/index.html b/content/docs/4.5.0/getting-started/run-locally/index.html
index f59711c..9484688 100644
--- a/content/docs/4.5.0/getting-started/run-locally/index.html
+++ b/content/docs/4.5.0/getting-started/run-locally/index.html
@@ -459,9 +459,8 @@
<p>This would start up an ensemble with 10 bookies:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookeeper-server/bin/bookeeper localbookie 10
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookeeper-server/bin/bookeeper localbookie 10
+</code></pre></div></div>
<blockquote>
<p>When you start up an ensemble using <code class="highlighter-rouge">localbookie</code>, all bookies run in a single JVM process.</p>
diff --git a/content/docs/4.5.0/reference/cli/index.html b/content/docs/4.5.0/reference/cli/index.html
index 016910d..40102c9 100644
--- a/content/docs/4.5.0/reference/cli/index.html
+++ b/content/docs/4.5.0/reference/cli/index.html
@@ -525,9 +525,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-localbookie">localbookie</h3>
@@ -536,9 +535,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie N
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie N
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-autorecovery">autorecovery</h3>
@@ -547,9 +545,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-upgrade">upgrade</h3>
@@ -558,9 +555,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-shell">shell</h3>
@@ -569,9 +565,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-help">help</h3>
@@ -580,9 +575,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper <span class="nb">help</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper <span class="nb">help</span>
+</code></pre></div></div>
<h2 id="the-bookkeeper-shell">The BookKeeper shell</h2>
@@ -592,10 +586,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -629,10 +622,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieFormat <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieFormat <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -671,9 +663,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieinfo
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieinfo
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -684,10 +675,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookiesanity <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookiesanity <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -721,9 +711,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell decommissionbookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell decommissionbookie
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -734,10 +723,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell deleteledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell deleteledger <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -771,9 +759,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell expandstorage
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell expandstorage
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -784,9 +771,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell <span class="nb">help</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell <span class="nb">help</span>
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -797,9 +783,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell lastmark
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell lastmark
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -810,10 +795,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell ledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell ledger <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -842,10 +826,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell ledgermetadata <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell ledgermetadata <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -874,10 +857,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listbookies <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listbookies <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -916,10 +898,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listfilesondisc <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listfilesondisc <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -958,10 +939,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listledgers <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listledgers <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -990,10 +970,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listunderreplicated <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listunderreplicated <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1027,10 +1006,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1064,10 +1042,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell lostbookierecoverydelay <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell lostbookierecoverydelay <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1101,10 +1078,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readjournal <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readjournal <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1138,10 +1114,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readledger <span class="se">\</span>
<ledger_id> <span class="o">[</span><start_entry_id> <span class="o">[</span><end_entry_id>]]
-</code></pre>
-</div>
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -1152,11 +1127,10 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readlog <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readlog <span class="se">\</span>
<entry_log_id | entry_log_file_name> <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1205,11 +1179,10 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
<bookieSrc> <span class="o">[</span><bookieDest>] <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1238,10 +1211,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell simpletest <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell simpletest <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1285,9 +1257,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell triggeraudit
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell triggeraudit
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -1298,10 +1269,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell updatecookie <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell updatecookie <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1330,10 +1300,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell updateledgers <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell updateledgers <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
diff --git a/content/docs/4.5.0/security/sasl/index.html b/content/docs/4.5.0/security/sasl/index.html
index ff84683..0ed0ef1 100644
--- a/content/docs/4.5.0/security/sasl/index.html
+++ b/content/docs/4.5.0/security/sasl/index.html
@@ -467,24 +467,21 @@ by mechanism-specific details and wrap up with some operational details.</p>
<li>
<p>Pass the <code class="highlighter-rouge">JAAS</code> config file location as JVM parameter to each Bookie. For example:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
+</code></pre></div> </div>
</li>
<li>
<p>Enable SASL auth plugin in bookies, by setting <code class="highlighter-rouge">bookieAuthProviderFactoryClass</code> to <code class="highlighter-rouge">org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory</code>.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
+</code></pre></div> </div>
</li>
<li>
<p>If you are running <code class="highlighter-rouge">autorecovery</code> along with bookies, then you want to enable SASL auth plugin for <code class="highlighter-rouge">autorecovery</code>, by setting
<code class="highlighter-rouge">clientAuthProviderFactoryClass</code> to <code class="highlighter-rouge">org.apache.bookkeeper.sasl.SASLClientProviderFactory</code>.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
<li>Follow the steps in <a href="#kerberos">GSSAPI (Kerberos)</a> to configure SASL.</li>
</ol>
@@ -515,16 +512,14 @@ by mechanism-specific details and wrap up with some operational details.</p>
<li>
<p>Pass the <code class="highlighter-rouge">JAAS</code> config file location as JVM parameter to each client JVM. For example:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
+</code></pre></div> </div>
</li>
<li>
<p>Configure the following properties in bookkeeper <code class="highlighter-rouge">ClientConfiguration</code>:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
</ol>
@@ -550,10 +545,9 @@ for each Bookie in your cluster and for every operating system user that will ac
<p>If you have installed your own Kerberos, you will need to create these principals yourself using the following commands:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>sudo /usr/sbin/kadmin.local -q <span class="s1">'addprinc -randkey bookkeeper/{hostname}@{REALM}'</span>
-sudo /usr/sbin/kadmin.local -q <span class="s2">"ktadd -k /etc/security/keytabs/{keytabname}.keytab bookkeeper/{hostname}@{REALM}"</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo</span> /usr/sbin/kadmin.local <span class="nt">-q</span> <span class="s1">'addprinc -randkey bookkeeper/{hostname}@{REALM}'</span>
+<span class="nb">sudo</span> /usr/sbin/kadmin.local <span class="nt">-q</span> <span class="s2">"ktadd -k /etc/security/keytabs/{keytabname}.keytab bookkeeper/{hostname}@{REALM}"</span>
+</code></pre></div></div>
<h5 id="all-hosts-must-be-reachable-using-hostnames">All hosts must be reachable using hostnames</h5>
@@ -566,7 +560,7 @@ sudo /usr/sbin/kadmin.local -q <span class="s2">"ktadd -k /etc/security/keytabs/
<p>Add a suitably modified JAAS file similar to the one below to each Bookie’s config directory, let’s call it <code class="highlighter-rouge">bookie_jaas.conf</code>
for this example (note that each bookie should have its own keytab):</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> Bookie {
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> Bookie {
com.sun.security.auth.module.Krb5LoginModule required
useKeyTab=true
storeKey=true
@@ -589,8 +583,7 @@ for this example (note that each bookie should have its own keytab):</p>
keyTab="/etc/security/keytabs/bookie.keytab"
principal="bookkeeper/bk1.hostname.com@EXAMPLE.COM";
};
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>The <code class="highlighter-rouge">Bookie</code> section in the JAAS file tells the bookie which principal to use and the location of the keytab where this principal is stored.
It allows the bookie to login using the keytab specified in this section. See <a href="#notes">notes</a> for more details on Zookeeper’s SASL configuration.</p>
@@ -598,16 +591,14 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Pass the name of the JAAS file as a JVM parameter to each Bookie:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
+</code></pre></div> </div>
<p>You may also wish to specify the path to the <code class="highlighter-rouge">krb5.conf</code> file
(see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">JDK’s Kerberos Requirements</a> for more details):</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
+</code></pre></div> </div>
</li>
<li>
<p>Make sure the keytabs configured in the JAAS file are readable by the operating system user who is starting the Bookies.</p>
@@ -615,11 +606,10 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Enable SASL authentication plugin in the bookies by setting following parameters.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
<span class="c"># if you run `autorecovery` along with bookies</span>
<span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
</ol>
@@ -634,29 +624,26 @@ for this example (note that each bookie should have its own keytab):</p>
how the clients like writers and readers can connect to the Bookies. The following is an example configuration for a client using
a keytab (recommended for long-running processes):</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> BookKeeper {
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> BookKeeper {
com.sun.security.auth.module.Krb5LoginModule required
useKeyTab=true
storeKey=true
keyTab="/etc/security/keytabs/bookkeeper.keytab"
principal="bookkeeper-client-1@EXAMPLE.COM";
};
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Pass the name of the JAAS file as a JVM parameter to the client JVM:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
+</code></pre></div> </div>
<p>You may also wish to specify the path to the <code class="highlighter-rouge">krb5.conf</code> file (see
<a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">JDK’s Kerberos Requirements</a> for more details).</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
+</code></pre></div> </div>
</li>
<li>
<p>Make sure the keytabs configured in the <code class="highlighter-rouge">bookkeeper_jaas.conf</code> are readable by the operating system user who is starting bookkeeper client.</p>
@@ -664,9 +651,8 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Enable SASL authentication plugin in the client by setting following parameters.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
</ol>
diff --git a/content/docs/4.5.0/security/tls/index.html b/content/docs/4.5.0/security/tls/index.html
index e56202a..403014d 100644
--- a/content/docs/4.5.0/security/tls/index.html
+++ b/content/docs/4.5.0/security/tls/index.html
@@ -481,9 +481,8 @@ In (2), with a CA, the bookie or client will trust any certificate that was sign
You can use Java’s <code class="highlighter-rouge">keytool</code> utility to accomplish this task. We will generate the key into a temporary keystore
initially so that we can export and sign it later with CA.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias localhost -validity <span class="o">{</span>validity<span class="o">}</span> -genkey
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-validity</span> <span class="o">{</span>validity<span class="o">}</span> <span class="nt">-genkey</span>
+</code></pre></div></div>
<p>You need to specify two parameters in the above command:</p>
@@ -510,25 +509,22 @@ to ensure the passport is authentic. Similarly, the CA signs the certificates, a
certificate is computationally difficult to forge. Thus, as long as the CA is a genuine and trusted authority, the clients have
high assurance that they are connecting to the authentic machines.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl req -new -x509 -keyout ca-key -out ca-cert -days 365
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl req <span class="nt">-new</span> <span class="nt">-x509</span> <span class="nt">-keyout</span> ca-key <span class="nt">-out</span> ca-cert <span class="nt">-days</span> 365
+</code></pre></div></div>
<p>The generated CA is simply a <em>public-private</em> key pair and certificate, and it is intended to sign other certificates.</p>
<p>The next step is to add the generated CA to the clients’ truststore so that the clients can trust this CA:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.truststore.jks -alias CARoot -import -file ca-cert
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.truststore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+</code></pre></div></div>
<p>NOTE: If you configure the bookies to require client authentication by setting <code class="highlighter-rouge">sslClientAuthentication</code> to <code class="highlighter-rouge">true</code> on the
<a href="../../reference/config">bookie config</a>, then you must also provide a truststore for the bookies and it should have all the CA
certificates that clients keys were signed by.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore client.truststore.jks -alias CARoot -import -file ca-cert
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> client.truststore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+</code></pre></div></div>
<p>In contrast to the keystore, which stores each machine’s own identity, the truststore of a client stores all the certificates
that the client should trust. Importing a certificate into one’s truststore also means trusting all certificates that are signed
@@ -541,22 +537,19 @@ That way all machines can authenticate all other machines.</p>
<p>The next step is to sign all certificates in the keystore with the CA we generated. First, you need to export the certificate from the keystore:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias localhost -certreq -file cert-file
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-certreq</span> <span class="nt">-file</span> cert-file
+</code></pre></div></div>
<p>Then sign it with the CA:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl x509 -req -CA ca-cert -CAkey ca-key -in cert-file -out cert-signed -days <span class="o">{</span>validity<span class="o">}</span> -CAcreateserial -passin pass:<span class="o">{</span>ca-password<span class="o">}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl x509 <span class="nt">-req</span> <span class="nt">-CA</span> ca-cert <span class="nt">-CAkey</span> ca-key <span class="nt">-in</span> cert-file <span class="nt">-out</span> cert-signed <span class="nt">-days</span> <span class="o">{</span>validity<span class="o">}</span> <span class="nt">-CAcreateserial</span> <span class="nt">-passin</span> pass:<span class="o">{</span>ca-password [...]
+</code></pre></div></div>
<p>Finally, you need to import both the certificate of the CA and the signed certificate into the keystore:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias CARoot -import -file ca-cert
-keytool -keystore bookie.keystore.jks -alias localhost -import -file cert-signed
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-import</span> <span class="nt">-file</span> cert-signed
+</code></pre></div></div>
<p>The definitions of the parameters are the following:</p>
@@ -585,7 +578,7 @@ netty bindings to leverage installed OpenSSL.</p>
<p>The following TLS configs are needed on the bookie side:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
<span class="c"># key store</span>
<span class="nv">tlsKeyStoreType</span><span class="o">=</span>JKS
<span class="nv">tlsKeyStore</span><span class="o">=</span>/var/private/tls/bookie.keystore.jks
@@ -594,8 +587,7 @@ netty bindings to leverage installed OpenSSL.</p>
<span class="nv">tlsTrustStoreType</span><span class="o">=</span>JKS
<span class="nv">tlsTrustStore</span><span class="o">=</span>/var/private/tls/bookie.truststore.jks
<span class="nv">tlsTrustStorePasswordPath</span><span class="o">=</span>/var/private/tls/bookie.truststore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>NOTE: it is important to restrict access to the store files and corresponding password files via filesystem permissions.</p>
@@ -614,19 +606,17 @@ netty bindings to leverage installed OpenSSL.</p>
<p>To verify the bookie’s keystore and truststore are setup correctly you can run the following command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl s_client -debug -connect localhost:3181 -tls1
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl s_client <span class="nt">-debug</span> <span class="nt">-connect</span> localhost:3181 <span class="nt">-tls1</span>
+</code></pre></div></div>
<p>NOTE: TLSv1 should be listed under <code class="highlighter-rouge">tlsEnabledProtocols</code>.</p>
<p>In the output of this command you should see the server’s certificate:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>-----BEGIN CERTIFICATE-----
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">-----BEGIN</span> CERTIFICATE-----
<span class="o">{</span>variable sized random bytes<span class="o">}</span>
------END CERTIFICATE-----
-</code></pre>
-</div>
+<span class="nt">-----END</span> CERTIFICATE-----
+</code></pre></div></div>
<p>If the certificate does not show up or if there are any other error messages then your keystore is not setup correctly.</p>
@@ -637,11 +627,10 @@ supported. The configs for TLS will be the same as bookies.</p>
<p>If client authentication is not required by the bookies, the following is a minimal configuration example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
<span class="nv">clientTrustStore</span><span class="o">=</span>/var/private/tls/client.truststore.jks
<span class="nv">clientTrustStorePasswordPath</span><span class="o">=</span>/var/private/tls/client.truststore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If client authentication is required, then a keystore must be created for each client, and the bookies’ truststores must
trust the certificate in the client’s keystore. This may be done using commands that are similar to what we used for
@@ -649,11 +638,10 @@ the <a href="#bookie-keystore">bookie keystore</a>.</p>
<p>And the following must also be configured:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsClientAuthentication</span><span class="o">=</span><span class="nb">true
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsClientAuthentication</span><span class="o">=</span><span class="nb">true
</span><span class="nv">clientKeyStore</span><span class="o">=</span>/var/private/tls/client.keystore.jks
<span class="nv">clientKeyStorePasswordPath</span><span class="o">=</span>/var/private/tls/client.keystore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>NOTE: it is important to restrict access to the store files and corresponding password files via filesystem permissions.</p>
@@ -663,9 +651,8 @@ the <a href="#bookie-keystore">bookie keystore</a>.</p>
<p>You can enable TLS debug logging at the JVM level by starting the bookies and/or clients with <code class="highlighter-rouge">javax.net.debug</code> system property. For example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>-Djavax.net.debug<span class="o">=</span>all
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">-Djavax</span>.net.debug<span class="o">=</span>all
+</code></pre></div></div>
<p>You can find more details on this in <a href="http://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/ReadDebug.html">Oracle documentation</a> on
<a href="http://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/ReadDebug.html">debugging SSL/TLS connections</a>.</p>
diff --git a/content/docs/4.5.1/admin/autorecovery/index.html b/content/docs/4.5.1/admin/autorecovery/index.html
index 47fd421..15a6bc9 100644
--- a/content/docs/4.5.1/admin/autorecovery/index.html
+++ b/content/docs/4.5.1/admin/autorecovery/index.html
@@ -474,20 +474,18 @@
<p>Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="c"># IP and port for the failed bookie</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If you wish, you can also specify which bookie you’d like to rereplicate to. Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="se">\ </span> <span class="c"># IP and port for the failed bookie</span>
192.168.1.11:3181 <span class="c"># IP and port for the bookie to rereplicate to</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="the-manual-recovery-process">The manual recovery process</h3>
@@ -520,9 +518,8 @@
<p>You can start up AutoRecovery using the <a href="../../reference/cli#bookkeeper-autorecovery"><code class="highlighter-rouge">autorecovery</code></a> command of the <a href="../../reference/cli"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool.</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
+</code></pre></div></div>
<blockquote>
<p>The most important thing to ensure when starting up AutoRecovery is that the ZooKeeper connection string specified by the <a href="../../reference/config#zkServers"><code class="highlighter-rouge">zkServers</code></a> parameter points to the right ZooKeeper cluster.</p>
@@ -542,15 +539,13 @@
<p>You can disable AutoRecover using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -disable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-disable</span>
+</code></pre></div></div>
<p>Once disabled, you can reenable AutoRecovery using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">enable</code></a> shell command:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -enable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-enable</span>
+</code></pre></div></div>
<h2 id="autorecovery-architecture">AutoRecovery architecture</h2>
diff --git a/content/docs/4.5.1/admin/bookies/index.html b/content/docs/4.5.1/admin/bookies/index.html
index 0cfa408..dda7cda 100644
--- a/content/docs/4.5.1/admin/bookies/index.html
+++ b/content/docs/4.5.1/admin/bookies/index.html
@@ -484,15 +484,13 @@
<p>To start a bookie in the foreground, use the <a href="../../reference/cli#bookkeeper-bookie"><code class="highlighter-rouge">bookie</code></a> command of the <a href="../../reference/cli#bookkeeper"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>To start a bookie in the background, use the <a href="../../reference/cli#bookkeeper-daemon.sh"><code class="highlighter-rouge">bookkeeper-daemon.sh</code></a> script and run <code class="highlighter-rouge">start bookie</code>:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
+</code></pre></div></div>
<h3 id="local-bookies">Local bookies</h3>
@@ -500,9 +498,8 @@
<p>This would spin up a local ensemble of 6 bookies:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
+</code></pre></div></div>
<blockquote>
<p>When you run a local bookie ensemble, all bookies run in a single JVM process.</p>
@@ -556,18 +553,16 @@
<p>To enable logging for a bookie, create a <code class="highlighter-rouge">log4j.properties</code> file and point the <code class="highlighter-rouge">BOOKIE_LOG_CONF</code> environment variable to the configuration file. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
-<span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
+<span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<h2 id="upgrading">Upgrading</h2>
<p>From time to time you may need to make changes to the filesystem layout of bookies—changes that are incompatible with previous versions of BookKeeper and require that directories used with previous versions are upgraded. If a filesystem upgrade is required when updating BookKeeper, the bookie will fail to start and return an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
+</code></pre></div></div>
<p>BookKeeper provides a utility for upgrading the filesystem. You can perform an upgrade using the <a href="../../reference/cli#bookkeeper-upgrade"><code class="highlighter-rouge">upgrade</code></a> command of the <code class="highlighter-rouge">bookkeeper</code> CLI tool. When running <code class="highlighter-rouge">bookkeeper upgrade</code> you need to specify one of three flags:</p>
@@ -598,27 +593,23 @@
<p>A standard upgrade pattern is to run an upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --upgrade
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--upgrade</span>
+</code></pre></div></div>
<p>…then check that everything is working normally, then kill the bookie. If everything is okay, finalize the upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --finalize
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--finalize</span>
+</code></pre></div></div>
<p>…and then restart the server:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>If something has gone wrong, you can always perform a rollback:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --rollback
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--rollback</span>
+</code></pre></div></div>
<h2 id="formatting">Formatting</h2>
@@ -626,15 +617,13 @@
<p>By default, formatting is done in interactive mode, which prompts you to confirm the format operation if old data exists. You can disable confirmation using the <code class="highlighter-rouge">-nonInteractive</code> flag. If old data does exist, the format operation will abort <em>unless</em> you set the <code class="highlighter-rouge">-force</code> flag. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
+</code></pre></div></div>
<p>You can format the local filesystem data on a bookie using the <a href="../../reference/cli#bookkeeper-shell-bookieformat"><code class="highlighter-rouge">bookieformat</code></a> command on each bookie. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
+</code></pre></div></div>
<blockquote>
<p>The <code class="highlighter-rouge">-force</code> and <code class="highlighter-rouge">-nonInteractive</code> flags are also available for the <code class="highlighter-rouge">bookieformat</code> command.</p>
@@ -648,13 +637,12 @@
<p>Accidentally replacing disks or removing directories can cause a bookie to fail while trying to read a ledger fragment that, according to the ledger metadata, exists on the bookie. For this reason, when a bookie is started for the first time, its disk configuration is fixed for the lifetime of that bookie. Any change to its disk configuration, such as a crashed disk or an accidental configuration change, will result in the bookie being unable to start. That will throw an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
.......at org.apache.bookkeeper.bookie.Cookie.verify(Cookie.java:82)
.......at org.apache.bookkeeper.bookie.Bookie.checkEnvironment(Bookie.java:275)
.......at org.apache.bookkeeper.bookie.Bookie.<init>(Bookie.java:351)
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If the change was the result of an accidental configuration change, the change can be reverted and the bookie can be restarted. However, if the change <em>cannot</em> be reverted, such as is the case when you want to add a new disk or replace a disk, the bookie must be wiped and then all its data re-replicated onto it.</p>
@@ -665,21 +653,19 @@ org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
<li>
<p>Run the following command to re-replicate the data:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
<zkserver> <span class="se">\</span>
<oldbookie> <span class="se">\</span>
<newbookie>
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>The ZooKeeper server, old bookie, and new bookie, are all identified by their external IP and <code class="highlighter-rouge">bookiePort</code> (3181 by default). Here’s an example:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bin/bookkeeper org.apache.bookkeeper.tools.BookKeeperTools <span class="se">\</span>
zk1.example.com <span class="se">\</span>
192.168.1.10:3181 <span class="se">\</span>
192.168.1.10:3181
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>See the <a href="../autorecovery">AutoRecovery</a> documentation for more info on the re-replication process.</p>
</li>
diff --git a/content/docs/4.5.1/api/ledger-adv-api/index.html b/content/docs/4.5.1/api/ledger-adv-api/index.html
index 2223dfa..1ba74ef 100644
--- a/content/docs/4.5.1/api/ledger-adv-api/index.html
+++ b/content/docs/4.5.1/api/ledger-adv-api/index.html
@@ -471,17 +471,16 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<p>Here’s an exmaple:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You can also create advanced ledgers asynchronously.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">createComplete</span><span class="o">(</span><span class="kt">int</span> <span class="n">returnCode</span><span class="o">,</span> <span class="n">LedgerHandle</span> <span class="n">handle</span><span class="o">,</span> <span class="n">Object</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Ledger successfully created"</span><span class="o">);</span>
<span class="o">}</span>
@@ -495,12 +494,11 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="k">new</span> <span class="nf">LedgerCreationCallback</span><span class="o">(),</span>
<span class="s">"some context"</span>
<span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Besides the APIs above, BookKeeper allows users providing <code class="highlighter-rouge">ledger-id</code> when creating advanced ledgers.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
@@ -508,8 +506,7 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>Please note, it is users’ responsibility to provide a unique ledger id when using the API above.
@@ -522,11 +519,10 @@ a <a href="../javadoc/org/apache/bookkeeper/client/BKException.BKLedgerExistExce
<p>The normal <a href="ledger-api/#adding-entries-to-ledgers">add entries api</a> in advanced ledgers are disabled. Instead, when users want to add entries
to advanced ledgers, an entry id is required to pass in along with the entry data when adding an entry.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
<span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="n">entryId</span><span class="o">,</span> <span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>A few notes when using this API:</p>
diff --git a/content/docs/4.5.1/api/ledger-api/index.html b/content/docs/4.5.1/api/ledger-api/index.html
index ab6e4f4..16674f8 100644
--- a/content/docs/4.5.1/api/ledger-api/index.html
+++ b/content/docs/4.5.1/api/ledger-api/index.html
@@ -473,7 +473,7 @@
<p>If you’re using <a href="https://maven.apache.org/">Maven</a>, add this to your <a href="https://maven.apache.org/guides/introduction/introduction-to-the-pom.html"><code class="highlighter-rouge">pom.xml</code></a> build configuration file:</p>
-<div class="language-xml highlighter-rouge"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
<span class="nt"><bookkeeper.version></span>4.5.1<span class="nt"></bookkeeper.version></span>
<span class="c"><!-- in your <dependencies> block --></span>
@@ -482,14 +482,13 @@
<span class="nt"><artifactId></span>bookkeeper-server<span class="nt"></artifactId></span>
<span class="nt"><version></span>${bookkeeper.version}<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="gradle">Gradle</h3>
<p>If you’re using <a href="https://gradle.org/">Gradle</a>, add this to your <a href="https://spring.io/guides/gs/gradle/"><code class="highlighter-rouge">build.gradle</code></a> build configuration file:</p>
-<div class="language-groovy highlighter-rouge"><pre class="highlight"><code><span class="n">dependencies</span> <span class="o">{</span>
+<div class="language-groovy highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="nl">group:</span> <span class="s1">'org.apache.bookkeeper'</span><span class="o">,</span> <span class="nl">name:</span> <span class="s1">'bookkeeper-server'</span><span class="o">,</span> <span class="nl">version:</span> <span class="s1">'4.5.0'</span>
<span class="o">}</span>
@@ -497,8 +496,7 @@
<span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="s1">'org.apache.bookkeeper:bookkeeper-server:4.5.0'</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="connection-string">Connection string</h2>
@@ -514,14 +512,13 @@
<p>In order to create a new <a href="../javadoc/org/apache/bookkeeper/client/BookKeeper"><code class="highlighter-rouge">BookKeeper</code></a> client object, you need to pass in a <a href="#connection-string">connection string</a>. Here is an example client object using a ZooKeeper connection string:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="k">try</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">try</span> <span class="o">{</span>
<span class="n">String</span> <span class="n">connectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span> <span class="c1">// For a single-node, local ZooKeeper cluster</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">connectionString</span><span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">InterruptedException</span> <span class="o">|</span> <span class="n">IOException</span> <span class="o">|</span> <span class="n">KeeperException</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
<span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>If you’re running BookKeeper <a href="../../getting-started/run-locally">locally</a>, using the <a href="../../reference/cli#bookkeeper-localbookie"><code class="highlighter-rouge">localbookie</code></a> command, use <code class="highlighter-rouge">"127.0.0.1:2181"</code> for your connection string, as in the example above.</p>
@@ -533,29 +530,26 @@
<li>
<p>By passing in a <a href="../javadoc/org/apache/bookkeeper/conf/ClientConfiguration"><code class="highlighter-rouge">ClientConfiguration</code></a> object. Here’s an example:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">config</span><span class="o">.</span><span class="na">setZkServers</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
<span class="n">config</span><span class="o">.</span><span class="na">setAddEntryTimeout</span><span class="o">(</span><span class="mi">2000</span><span class="o">);</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">config</span><span class="o">);</span>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>By specifying a <code class="highlighter-rouge">ClientConfiguration</code> and a <a href="http://zookeeper.apache.org/doc/current/api/org/apache/zookeeper/ZooKeeper.html"><code class="highlighter-rouge">ZooKeeper</code></a> client object:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">config</span><span class="o">.</span><span class="na">setAddEntryTimeout</span><span class="o">(</span><span class="mi">5000</span><span class="o">);</span>
<span class="n">ZooKeeper</span> <span class="n">zkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ZooKeeper</span><span class="o">(</span><span class="cm">/* client args */</span><span class="o">);</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">config</span><span class="o">,</span> <span class="n">zkClient</span><span class="o">);</span>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Using the <code class="highlighter-rouge">forConfig</code> method:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="n">BookKeeper</span><span class="o">.</span><span class="na">forConfig</span><span class="o">(</span><span class="n">conf</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
- </div>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="n">BookKeeper</span><span class="o">.</span><span class="na">forConfig</span><span class="o">(</span><span class="n">conf</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
+</code></pre></div> </div>
</li>
</ul>
@@ -565,16 +559,15 @@
<p>Here’s an example:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandle</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedger</span><span class="o">(</span><span class="n">BookKeeper</span><span class="o">.</span><span class="na">DigestType</span><span class="o">.</span><span class="na">MAC</span><span class="o">,</span> <span class="n">password</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You can also create ledgers asynchronously</p>
<h3 id="create-ledgers-asynchronously">Create ledgers asynchronously</h3>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">createComplete</span><span class="o">(</span><span class="kt">int</span> <span class="n">returnCode</span><span class="o">,</span> <span class="n">LedgerHandle</span> <span class="n">handle</span><span class="o">,</span> <span class="n">Object</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Ledger successfully created"</span><span class="o">);</span>
<span class="o">}</span>
@@ -588,34 +581,30 @@
<span class="k">new</span> <span class="nf">LedgerCreationCallback</span><span class="o">(),</span>
<span class="s">"some context"</span>
<span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="adding-entries-to-ledgers">Adding entries to ledgers</h2>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
+</code></pre></div></div>
<h3 id="add-entries-asynchronously">Add entries asynchronously</h3>
<h2 id="reading-entries-from-ledgers">Reading entries from ledgers</h2>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span> <span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">1</span><span class="o">,</span> <span class="mi">99</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span> <span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">1</span><span class="o">,</span> <span class="mi">99</span><span class="o">);</span>
+</code></pre></div></div>
<p>To read all possible entries from the ledger:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
<span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">0</span><span class="o">,</span> <span class="n">handle</span><span class="o">.</span><span class="na">getLastAddConfirmed</span><span class="o">());</span>
<span class="k">while</span> <span class="o">(</span><span class="n">entries</span><span class="o">.</span><span class="na">hasNextElement</span><span class="o">())</span> <span class="o">{</span>
<span class="n">LedgerEntry</span> <span class="n">entry</span> <span class="o">=</span> <span class="n">entries</span><span class="o">.</span><span class="na">nextElement</span><span class="o">();</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Successfully read entry "</span> <span class="o">+</span> <span class="n">entry</span><span class="o">.</span><span class="na">getId</span><span class="o">());</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="reading-entries-after-the-lastaddconfirmed-range">Reading entries after the LastAddConfirmed range</h3>
@@ -625,29 +614,27 @@ For entries which are within the range 0..LastAddConfirmed BookKeeper guarantees
For entries outside that range it is possible that the writer never received the acknowledge and so there is the risk that the reader is seeing entries before the writer and this could result in a consistency issue in some cases.
With this method you can even read entries before the LastAddConfirmed and entries after it with one call, the expected consistency will be as described above.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
<span class="n">handle</span><span class="o">.</span><span class="na">readUnconfirmedEntries</span><span class="o">(</span><span class="mi">0</span><span class="o">,</span> <span class="n">lastEntryIdExpectedToRead</span><span class="o">);</span>
<span class="k">while</span> <span class="o">(</span><span class="n">entries</span><span class="o">.</span><span class="na">hasNextElement</span><span class="o">())</span> <span class="o">{</span>
<span class="n">LedgerEntry</span> <span class="n">entry</span> <span class="o">=</span> <span class="n">entries</span><span class="o">.</span><span class="na">nextElement</span><span class="o">();</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Successfully read entry "</span> <span class="o">+</span> <span class="n">entry</span><span class="o">.</span><span class="na">getId</span><span class="o">());</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="deleting-ledgers">Deleting ledgers</h2>
<p><span class="pop" id="ledger-popover">Ledgers</span> can also be deleted synchronously or asynchronously.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="mi">1234</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="mi">1234</span><span class="o">;</span>
<span class="k">try</span> <span class="o">{</span>
<span class="n">bkClient</span><span class="o">.</span><span class="na">deleteLedger</span><span class="o">(</span><span class="n">ledgerId</span><span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">Exception</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
<span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="delete-entries-asynchronously">Delete entries asynchronously</h3>
@@ -655,13 +642,12 @@ With this method you can even read entries before the LastAddConfirmed and entri
<p>*</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">DeleteEntryCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">DeleteCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">DeleteEntryCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">DeleteCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">deleteComplete</span><span class="o">()</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Delete completed"</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="simple-example">Simple example</h2>
@@ -679,7 +665,7 @@ With this method you can even read entries before the LastAddConfirmed and entri
<li>reads all available entries</li>
</ul>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="c1">// Create a client object for the local ensemble. This</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// Create a client object for the local ensemble. This</span>
<span class="c1">// operation throws multiple exceptions, so make sure to</span>
<span class="c1">// use a try/catch block when instantiating client objects.</span>
<span class="n">BookKeeper</span> <span class="n">bkc</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"localhost:2181"</span><span class="o">);</span>
@@ -721,17 +707,15 @@ With this method you can even read entries before the LastAddConfirmed and entri
<span class="c1">// Close the ledger and the client</span>
<span class="n">lh</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
<span class="n">bkc</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Running this should return this output:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>Result: 0
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Result: 0
Result: 1
Result: 2
<span class="c"># etc</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="example-application">Example application</h2>
@@ -747,9 +731,8 @@ Result: 2
<p>To start up a cluster consisting of six <span class="pop" id="bookie-popover">bookies</span> locally:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
+</code></pre></div></div>
<p>You can specify a different number of bookies if you’d like.</p>
@@ -767,15 +750,14 @@ Result: 2
<p>To begin, download the base application, compile and run it.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>git clone https://github.com/ivankelly/bookkeeper-tutorial.git
-<span class="gp">$ </span>mvn package
-<span class="gp">$ </span>mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>git clone https://github.com/ivankelly/bookkeeper-tutorial.git
+<span class="nv">$ </span>mvn package
+<span class="nv">$ </span>mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+</code></pre></div></div>
<p>That should yield output that looks something like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>[INFO] Scanning for projects...
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building tutorial 1.0-SNAPSHOT
@@ -786,14 +768,13 @@ Result: 2
Value = 4
Value = 5
Value = 3
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="the-base-application">The base application</h3>
<p>The application in this tutorial is a dice application. The <code class="highlighter-rouge">Dice</code> class below has a <code class="highlighter-rouge">playDice</code> function that generates a random number between 1 and 6 every second, prints the value of the dice roll, and runs indefinitely.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
<span class="n">Random</span> <span class="n">r</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Random</span><span class="o">();</span>
<span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
@@ -803,12 +784,11 @@ Value = 3
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>When you run the <code class="highlighter-rouge">main</code> function of this class, a new <code class="highlighter-rouge">Dice</code> object will be instantiated and then run indefinitely:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
<span class="c1">// other methods</span>
<span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
@@ -816,8 +796,7 @@ Value = 3
<span class="n">d</span><span class="o">.</span><span class="na">playDice</span><span class="o">();</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="leaders-and-followers-and-a-bit-of-background">Leaders and followers (and a bit of background)</h3>
@@ -845,7 +824,7 @@ Value = 3
<p>We’ll use zookeeper to elect a leader. A zookeeper instance will have started locally when you started the localbookie application above. To verify it’s running, run the following command.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span><span class="nb">echo </span>stat | nc localhost 2181
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">echo stat</span> | nc localhost 2181
Zookeeper version: 3.4.6-1569965, built on 02/20/2014 09:09 GMT
Clients:
/127.0.0.1:59343[1]<span class="o">(</span><span class="nv">queued</span><span class="o">=</span>0,recved<span class="o">=</span>40,sent<span class="o">=</span>41<span class="o">)</span>
@@ -863,12 +842,11 @@ Outstanding: 0
Zxid: 0x11
Mode: standalone
Node count: 16
-</code></pre>
-</div>
+</code></pre></div></div>
<p>To interact with zookeeper, we’ll use the Curator client rather than the stock zookeeper client. Getting things right with the zookeeper client can be tricky, and curator removes a lot of the pointy corners for you. In fact, curator even provides a leader election recipe, so we need to do very little work to get leader election in our application.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="kd">extends</span> <span class="n">LeaderSelectorListenerAdapter</span> <span class="kd">implements</span> <span class="n">Closeable</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="kd">extends</span> <span class="n">LeaderSelectorListenerAdapter</span> <span class="kd">implements</span> <span class="n">Closeable</span> <span class="o">{</span>
<span class="kd">final</span> <span class="kd">static</span> <span class="n">String</span> <span class="n">ZOOKEEPER_SERVER</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
<span class="kd">final</span> <span class="kd">static</span> <span class="n">String</span> <span class="n">ELECTION_PATH</span> <span class="o">=</span> <span class="s">"/dice-elect"</span><span class="o">;</span>
@@ -885,8 +863,7 @@ Node count: 16
<span class="n">leaderSelector</span><span class="o">.</span><span class="na">autoRequeue</span><span class="o">();</span>
<span class="n">leaderSelector</span><span class="o">.</span><span class="na">start</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>In the constructor for Dice, we need to create the curator client. We specify four things when creating the client, the location of the zookeeper service, the session timeout, the connect timeout and the retry policy.</p>
@@ -894,7 +871,7 @@ Node count: 16
<p>Finally, you’ll have noticed that Dice now extends LeaderSelectorListenerAdapter and implements Closeable. Closeable is there to close the resource we have initialized in the constructor, the curator client and the leaderSelector. LeaderSelectorListenerAdapter is a callback that the leaderSelector uses to notify the instance that it is now the leader. It is passed as the third argument to the LeaderSelector constructor.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="nd">@Override</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nd">@Override</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">takeLeadership</span><span class="o">(</span><span class="n">CuratorFramework</span> <span class="n">client</span><span class="o">)</span>
<span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
<span class="kd">synchronized</span> <span class="o">(</span><span class="k">this</span><span class="o">)</span> <span class="o">{</span>
@@ -909,12 +886,11 @@ Node count: 16
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>takeLeadership() is the callback called by LeaderSelector when the instance is leader. It should only return when the instance wants to give up leadership. In our case, we never do so we wait on the current object until we’re interrupted. To signal to the rest of the program that we are leader we set a volatile boolean called leader to true. This is unset after we are interrupted.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
<span class="k">while</span> <span class="o">(</span><span class="kc">true</span><span class="o">)</span> <span class="o">{</span>
<span class="k">while</span> <span class="o">(</span><span class="n">leader</span><span class="o">)</span> <span class="o">{</span>
<span class="n">Thread</span><span class="o">.</span><span class="na">sleep</span><span class="o">(</span><span class="mi">1000</span><span class="o">);</span>
@@ -923,8 +899,7 @@ Node count: 16
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Finally, we modify the <code class="highlighter-rouge">playDice</code> function to only generate random numbers when it is the leader.</p>
@@ -934,18 +909,17 @@ Node count: 16
<p>Now go back to the shell that the original leader was on and wake up the process using fg. You’ll see something like the following:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>...
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>...
...
Value <span class="o">=</span> 4, isLeader <span class="o">=</span> <span class="nb">true
</span>Value <span class="o">=</span> 4, isLeader <span class="o">=</span> <span class="nb">true</span>
^Z
-<span class="o">[</span>1]+ Stopped mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
-<span class="gp">$ </span><span class="nb">fg
-</span>mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+<span class="o">[</span>1]+ Stopped mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+<span class="nv">$ </span><span class="nb">fg
+</span>mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
Value <span class="o">=</span> 3, isLeader <span class="o">=</span> <span class="nb">true
</span>Value <span class="o">=</span> 1, isLeader <span class="o">=</span> <span class="nb">false</span>
-</code></pre>
-</div>
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.5.1/deployment/dcos/index.html b/content/docs/4.5.1/deployment/dcos/index.html
index 35c93cb..0bba076 100644
--- a/content/docs/4.5.1/deployment/dcos/index.html
+++ b/content/docs/4.5.1/deployment/dcos/index.html
@@ -485,9 +485,8 @@
<h2 id="installing-bookkeeper">Installing BookKeeper</h2>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper --yes
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="nt">--yes</span>
+</code></pre></div></div>
<p>This command will:</p>
@@ -499,7 +498,7 @@
<p>The bookie that is automatically started up uses the host mode of the network and by default exports the service at <code class="highlighter-rouge">agent_ip:3181</code>.</p>
<blockquote>
- <p>If you run <code class="highlighter-rouge">dcos package install bookkeeper</code> without setting the <code class="highlighter-rouge">--yes</code> flag, the install will run in interactive mode. For more information on the <code class="highlighter-rouge">package install</code> command, see the <a href="https://docs.mesosphere.com/latest/cli/command-reference/dcos-package/dcos-package-install/">DC/OS docs</a>.</p>
+ <p>If you run <code class="highlighter-rouge">dcos package install bookkeeper</code> without setting the <code class="highlighter-rouge">--yes</code> flag, the install will run in interactive mode. For more information on the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">install</span></code> command, see the <a href="https://docs.mesosphere.com/latest/cli/command-reference/dcos-package/dcos-package-install/">DC/OS docs</a>.</p>
</blockquote>
<h3 id="services">Services</h3>
@@ -532,15 +531,13 @@
<p>To connect to bookies running on DC/OS using clients running within your Mesos cluster, you need to specify the ZooKeeper connection string for DC/OS’s ZooKeeper cluster:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>master.mesos:2181
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>master.mesos:2181
+</code></pre></div></div>
<p>This is the <em>only</em> ZooKeeper host/port you need to include in your connection string. Here’s an example using the <a href="../../api/ledger-api#the-java-ledger-api-client">Java client</a>:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"master.mesos:2181"</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"master.mesos:2181"</span><span class="o">);</span>
+</code></pre></div></div>
<p>If you’re connecting using a client running outside your Mesos cluster, you need to supply the public-facing connection string for your DC/OS ZooKeeper cluster.</p>
@@ -550,17 +547,15 @@
<p>You can supply a non-default configuration when installing the package using a JSON file. Here’s an example command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper <span class="se">\</span>
- --options<span class="o">=</span>/path/to/config.json
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="se">\</span>
+ <span class="nt">--options</span><span class="o">=</span>/path/to/config.json
+</code></pre></div></div>
-<p>You can then fetch the current configuration for BookKeeper at any time using the <code class="highlighter-rouge">package describe</code> command:</p>
+<p>You can then fetch the current configuration for BookKeeper at any time using the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">describe</span></code> command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package describe bookkeeper <span class="se">\</span>
- --config
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package describe bookkeeper <span class="se">\</span>
+ <span class="nt">--config</span>
+</code></pre></div></div>
<h3 id="available-parameters">Available parameters</h3>
@@ -627,31 +622,28 @@
<p>Here’s an example JSON configuration object for BookKeeper on DC/OS:</p>
-<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
- </span><span class="nt">"instances"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
- </span><span class="nt">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
- </span><span class="nt">"mem"</span><span class="p">:</span><span class="w"> </span><span class="mf">2048.0</span><span class="p">,</span><span class="w">
- </span><span class="nt">"volume_size"</span><span class="p">:</span><span class="w"> </span><span class="mi">250</span><span class="w">
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"instances"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"mem"</span><span class="p">:</span><span class="w"> </span><span class="mf">2048.0</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"volume_size"</span><span class="p">:</span><span class="w"> </span><span class="mi">250</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
-</div>
+</span></code></pre></div></div>
<p>If that configuration were stored in a file called <code class="highlighter-rouge">bk-config.json</code>, you could apply that configuration upon installating the BookKeeper package using this command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper <span class="se">\</span>
- --options<span class="o">=</span>./bk-config.json
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="se">\</span>
+ <span class="nt">--options</span><span class="o">=</span>./bk-config.json
+</code></pre></div></div>
<h2 id="uninstalling-bookkeeper">Uninstalling BookKeeper</h2>
-<p>You can shut down and uninstall the <code class="highlighter-rouge">bookkeeper</code> from DC/OS at any time using the <code class="highlighter-rouge">package uninstall</code> command:</p>
+<p>You can shut down and uninstall the <code class="highlighter-rouge">bookkeeper</code> from DC/OS at any time using the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">uninstall</span></code> command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package uninstall bookkeeper
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package uninstall bookkeeper
Uninstalled package <span class="o">[</span>bookkeeper] version <span class="o">[</span>4.5.1]
Thank you <span class="k">for </span>using bookkeeper.
-</code></pre>
-</div>
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.5.1/deployment/manual/index.html b/content/docs/4.5.1/deployment/manual/index.html
index 1fad33d..07af298 100644
--- a/content/docs/4.5.1/deployment/manual/index.html
+++ b/content/docs/4.5.1/deployment/manual/index.html
@@ -472,9 +472,8 @@
<p>On each bookie host, you need to <a href="../../getting-started/installation#download">download</a> the BookKeeper package as a tarball. Once you’ve done that, you need to configure the bookie by setting values in the <code class="highlighter-rouge">bookkeeper-server/conf/bk_server.conf</code> config file. The one parameter that you will absolutely need to change is the <a href="../../config#zkServers"><code class="highlighter-rouge">zkServers</code></a> parameter, which you will need [...]
-<div class="language-properties highlighter-rouge"><pre class="highlight"><code><span class="py">zkServers</span><span class="p">=</span><span class="s">100.0.0.1:2181,100.0.0.2:2181,100.0.0.3:2181</span>
-</code></pre>
-</div>
+<div class="language-properties highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="py">zkServers</span><span class="p">=</span><span class="s">100.0.0.1:2181,100.0.0.2:2181,100.0.0.3:2181</span>
+</code></pre></div></div>
<blockquote>
<p>A full listing of configurable parameters available in <code class="highlighter-rouge">bookkeeper-server/conf/bk_server.conf</code> can be found in the <a href="../../reference/config">Configuration</a> reference manual.</p>
@@ -482,9 +481,8 @@
<p>Once the bookie’s configuration is set, you can start it up using the <a href="../../reference/cli#bookkeeper-bookie"><code class="highlighter-rouge">bookie</code></a> command of the <a href="../../reference/cli#bookkeeper"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<blockquote>
<p>You can also build BookKeeper <a href="../../getting-started/installation#clone">by cloning it from source</a> or <a href="../../getting-started/installation#build-using-maven">using Maven</a>.</p>
@@ -519,9 +517,8 @@
<p>Once you’ve started up a cluster of bookies, you need to set up cluster metadata for the cluster by running the following command from any bookie in the cluster:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
+</code></pre></div></div>
<p>You can run in the formatting</p>
diff --git a/content/docs/4.5.1/getting-started/concepts/index.html b/content/docs/4.5.1/getting-started/concepts/index.html
index c6edf39..0bc6419 100644
--- a/content/docs/4.5.1/getting-started/concepts/index.html
+++ b/content/docs/4.5.1/getting-started/concepts/index.html
@@ -679,10 +679,9 @@
<p>BookKeeper requires a ZooKeeper installation for storing <a href="#ledger">ledger</a> metadata. Whenever you construct a <a href="../../api/javadoc/org/apache/bookkeeper/client/BookKeeper"><code class="highlighter-rouge">BookKeeper</code></a> client object, you need to pass a list of ZooKeeper servers as a parameter to the constructor, like this:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">String</span> <span class="n">zkConnectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">String</span> <span class="n">zkConnectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>For more info on using the BookKeeper Java client, see <a href="../../api/ledger-api#the-java-ledger-api-client">this guide</a>.</p>
@@ -714,15 +713,13 @@
<p>The <em>hierarchical ledger manager</em>, implemented in the <a href="../../api/javadoc/org/apache/bookkeeper/meta/HierarchicalLedgerManager"><code class="highlighter-rouge">HierarchicalLedgerManager</code></a> class, first obtains a global unique ID from ZooKeeper using an <a href="https://zookeeper.apache.org/doc/current/api/org/apache/zookeeper/CreateMode.html#EPHEMERAL_SEQUENTIAL"><code class="highlighter-rouge">EPHEMERAL_SEQUENTIAL</code></a> znode. Since ZooKeeper’s sequence cou [...]
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="o">{</span>level1 <span class="o">(</span>2 digits<span class="o">)}{</span>level2 <span class="o">(</span>4 digits<span class="o">)}{</span>level3 <span class="o">(</span>4 digits<span class="o">)}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">{</span>level1 <span class="o">(</span>2 digits<span class="o">)}{</span>level2 <span class="o">(</span>4 digits<span class="o">)}{</span>level3 <span class="o">(</span>4 digits<span class="o">)}</span>
+</code></pre></div></div>
<p>These three parts are used to form the actual ledger node path to store ledger metadata:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="o">{</span>ledgers_root_path<span class="o">}</span>/<span class="o">{</span>level1<span class="o">}</span>/<span class="o">{</span>level2<span class="o">}</span>/L<span class="o">{</span>level3<span class="o">}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">{</span>ledgers_root_path<span class="o">}</span>/<span class="o">{</span>level1<span class="o">}</span>/<span class="o">{</span>level2<span class="o">}</span>/L<span class="o">{</span>level3<span class="o">}</span>
+</code></pre></div></div>
<p>For example, ledger 0000000001 is split into three parts, 00, 0000, and 00001, and stored in znode <code class="highlighter-rouge">/{ledgers_root_path}/00/0000/L0001</code>. Each znode could have as many 10,000 ledgers, which avoids the problem of the child list being larger than the maximum ZooKeeper packet size (which is the <a href="https://issues.apache.org/jira/browse/BOOKKEEPER-39">limitation</a> that initially prompted the creation of the hierarchical ledger manager).</p>
diff --git a/content/docs/4.5.1/getting-started/installation/index.html b/content/docs/4.5.1/getting-started/installation/index.html
index e79938c..e14669c 100644
--- a/content/docs/4.5.1/getting-started/installation/index.html
+++ b/content/docs/4.5.1/getting-started/installation/index.html
@@ -470,31 +470,28 @@
<p>You can download Apache BookKeeper releases from one of many <a href="http://www.apache.org/dyn/closer.cgi/bookkeeper">Apache mirrors</a>. Here’s an example for the <a href="http://apache.claz.org/bookkeeper">apache.claz.org</a> mirror:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>curl -O http://apache.claz.org/bookkeeper/bookkeeper-4.6.1/bookkeeper-4.6.1-src.tar.gz
-<span class="gp">$ </span>tar xvf bookkeeper-4.6.1-src.tar.gz
-<span class="gp">$ </span><span class="nb">cd </span>bookkeeper-4.6.1
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-O</span> http://apache.claz.org/bookkeeper/bookkeeper-4.6.1/bookkeeper-4.6.1-src.tar.gz
+<span class="nv">$ </span><span class="nb">tar </span>xvf bookkeeper-4.6.1-src.tar.gz
+<span class="nv">$ </span><span class="nb">cd </span>bookkeeper-4.6.1
+</code></pre></div></div>
<h2 id="clone">Clone</h2>
<p>To build BookKeeper from source, clone the repository, either from the <a href="https://github.com/apache/bookkeeper">GitHub mirror</a> or from the <a href="http://git.apache.org/bookkeeper.git/">Apache repository</a>:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="c"># From the GitHub mirror</span>
-<span class="gp">$ </span>git clone https://github.com/apache/bookkeeper
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># From the GitHub mirror</span>
+<span class="nv">$ </span>git clone https://github.com/apache/bookkeeper
<span class="c"># From Apache directly</span>
-<span class="gp">$ </span>git clone git://git.apache.org/bookkeeper.git/
-</code></pre>
-</div>
+<span class="nv">$ </span>git clone git://git.apache.org/bookkeeper.git/
+</code></pre></div></div>
<h2 id="build-using-maven">Build using Maven</h2>
<p>Once you have the BookKeeper on your local machine, either by <a href="#download">downloading</a> or <a href="#clone">cloning</a> it, you can then build BookKeeper from source using Maven:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>mvn package
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>mvn package
+</code></pre></div></div>
<blockquote>
<p>You can skip tests by adding the <code class="highlighter-rouge">-DskipTests</code> flag when running <code class="highlighter-rouge">mvn package</code>.</p>
diff --git a/content/docs/4.5.1/getting-started/run-locally/index.html b/content/docs/4.5.1/getting-started/run-locally/index.html
index 82ca7c7..351e9c3 100644
--- a/content/docs/4.5.1/getting-started/run-locally/index.html
+++ b/content/docs/4.5.1/getting-started/run-locally/index.html
@@ -459,9 +459,8 @@
<p>This would start up an ensemble with 10 bookies:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookeeper-server/bin/bookeeper localbookie 10
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookeeper-server/bin/bookeeper localbookie 10
+</code></pre></div></div>
<blockquote>
<p>When you start up an ensemble using <code class="highlighter-rouge">localbookie</code>, all bookies run in a single JVM process.</p>
diff --git a/content/docs/4.5.1/reference/cli/index.html b/content/docs/4.5.1/reference/cli/index.html
index db4ae1c..da55480 100644
--- a/content/docs/4.5.1/reference/cli/index.html
+++ b/content/docs/4.5.1/reference/cli/index.html
@@ -525,9 +525,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-localbookie">localbookie</h3>
@@ -536,9 +535,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie N
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie N
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-autorecovery">autorecovery</h3>
@@ -547,9 +545,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-upgrade">upgrade</h3>
@@ -558,9 +555,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-shell">shell</h3>
@@ -569,9 +565,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-help">help</h3>
@@ -580,9 +575,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper <span class="nb">help</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper <span class="nb">help</span>
+</code></pre></div></div>
<h2 id="the-bookkeeper-shell">The BookKeeper shell</h2>
@@ -592,10 +586,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -629,10 +622,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieFormat <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieFormat <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -671,9 +663,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieinfo
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieinfo
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -684,10 +675,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookiesanity <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookiesanity <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -721,9 +711,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell decommissionbookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell decommissionbookie
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -734,10 +723,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell deleteledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell deleteledger <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -771,9 +759,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell expandstorage
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell expandstorage
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -784,9 +771,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell <span class="nb">help</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell <span class="nb">help</span>
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -797,9 +783,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell lastmark
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell lastmark
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -810,10 +795,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell ledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell ledger <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -842,10 +826,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell ledgermetadata <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell ledgermetadata <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -874,10 +857,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listbookies <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listbookies <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -916,10 +898,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listfilesondisc <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listfilesondisc <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -958,10 +939,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listledgers <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listledgers <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -990,10 +970,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listunderreplicated <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listunderreplicated <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1027,10 +1006,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1064,10 +1042,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell lostbookierecoverydelay <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell lostbookierecoverydelay <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1101,10 +1078,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readjournal <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readjournal <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1138,10 +1114,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readledger <span class="se">\</span>
<ledger_id> <span class="o">[</span><start_entry_id> <span class="o">[</span><end_entry_id>]]
-</code></pre>
-</div>
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -1152,11 +1127,10 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readlog <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readlog <span class="se">\</span>
<entry_log_id | entry_log_file_name> <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1205,11 +1179,10 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
<bookieSrc> <span class="o">[</span><bookieDest>] <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1238,10 +1211,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell simpletest <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell simpletest <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1285,9 +1257,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell triggeraudit
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell triggeraudit
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -1298,10 +1269,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell updatecookie <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell updatecookie <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1330,10 +1300,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell updateledgers <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell updateledgers <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
diff --git a/content/docs/4.5.1/security/sasl/index.html b/content/docs/4.5.1/security/sasl/index.html
index 8992715..5a40986 100644
--- a/content/docs/4.5.1/security/sasl/index.html
+++ b/content/docs/4.5.1/security/sasl/index.html
@@ -467,24 +467,21 @@ by mechanism-specific details and wrap up with some operational details.</p>
<li>
<p>Pass the <code class="highlighter-rouge">JAAS</code> config file location as JVM parameter to each Bookie. For example:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
+</code></pre></div> </div>
</li>
<li>
<p>Enable SASL auth plugin in bookies, by setting <code class="highlighter-rouge">bookieAuthProviderFactoryClass</code> to <code class="highlighter-rouge">org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory</code>.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
+</code></pre></div> </div>
</li>
<li>
<p>If you are running <code class="highlighter-rouge">autorecovery</code> along with bookies, then you want to enable SASL auth plugin for <code class="highlighter-rouge">autorecovery</code>, by setting
<code class="highlighter-rouge">clientAuthProviderFactoryClass</code> to <code class="highlighter-rouge">org.apache.bookkeeper.sasl.SASLClientProviderFactory</code>.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
<li>Follow the steps in <a href="#kerberos">GSSAPI (Kerberos)</a> to configure SASL.</li>
</ol>
@@ -515,16 +512,14 @@ by mechanism-specific details and wrap up with some operational details.</p>
<li>
<p>Pass the <code class="highlighter-rouge">JAAS</code> config file location as JVM parameter to each client JVM. For example:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
+</code></pre></div> </div>
</li>
<li>
<p>Configure the following properties in bookkeeper <code class="highlighter-rouge">ClientConfiguration</code>:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
</ol>
@@ -550,10 +545,9 @@ for each Bookie in your cluster and for every operating system user that will ac
<p>If you have installed your own Kerberos, you will need to create these principals yourself using the following commands:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>sudo /usr/sbin/kadmin.local -q <span class="s1">'addprinc -randkey bookkeeper/{hostname}@{REALM}'</span>
-sudo /usr/sbin/kadmin.local -q <span class="s2">"ktadd -k /etc/security/keytabs/{keytabname}.keytab bookkeeper/{hostname}@{REALM}"</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo</span> /usr/sbin/kadmin.local <span class="nt">-q</span> <span class="s1">'addprinc -randkey bookkeeper/{hostname}@{REALM}'</span>
+<span class="nb">sudo</span> /usr/sbin/kadmin.local <span class="nt">-q</span> <span class="s2">"ktadd -k /etc/security/keytabs/{keytabname}.keytab bookkeeper/{hostname}@{REALM}"</span>
+</code></pre></div></div>
<h5 id="all-hosts-must-be-reachable-using-hostnames">All hosts must be reachable using hostnames</h5>
@@ -566,7 +560,7 @@ sudo /usr/sbin/kadmin.local -q <span class="s2">"ktadd -k /etc/security/keytabs/
<p>Add a suitably modified JAAS file similar to the one below to each Bookie’s config directory, let’s call it <code class="highlighter-rouge">bookie_jaas.conf</code>
for this example (note that each bookie should have its own keytab):</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> Bookie {
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> Bookie {
com.sun.security.auth.module.Krb5LoginModule required
useKeyTab=true
storeKey=true
@@ -589,8 +583,7 @@ for this example (note that each bookie should have its own keytab):</p>
keyTab="/etc/security/keytabs/bookie.keytab"
principal="bookkeeper/bk1.hostname.com@EXAMPLE.COM";
};
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>The <code class="highlighter-rouge">Bookie</code> section in the JAAS file tells the bookie which principal to use and the location of the keytab where this principal is stored.
It allows the bookie to login using the keytab specified in this section. See <a href="#notes">notes</a> for more details on Zookeeper’s SASL configuration.</p>
@@ -598,16 +591,14 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Pass the name of the JAAS file as a JVM parameter to each Bookie:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
+</code></pre></div> </div>
<p>You may also wish to specify the path to the <code class="highlighter-rouge">krb5.conf</code> file
(see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">JDK’s Kerberos Requirements</a> for more details):</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
+</code></pre></div> </div>
</li>
<li>
<p>Make sure the keytabs configured in the JAAS file are readable by the operating system user who is starting the Bookies.</p>
@@ -615,11 +606,10 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Enable SASL authentication plugin in the bookies by setting following parameters.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
<span class="c"># if you run `autorecovery` along with bookies</span>
<span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
</ol>
@@ -634,29 +624,26 @@ for this example (note that each bookie should have its own keytab):</p>
how the clients like writers and readers can connect to the Bookies. The following is an example configuration for a client using
a keytab (recommended for long-running processes):</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> BookKeeper {
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> BookKeeper {
com.sun.security.auth.module.Krb5LoginModule required
useKeyTab=true
storeKey=true
keyTab="/etc/security/keytabs/bookkeeper.keytab"
principal="bookkeeper-client-1@EXAMPLE.COM";
};
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Pass the name of the JAAS file as a JVM parameter to the client JVM:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
+</code></pre></div> </div>
<p>You may also wish to specify the path to the <code class="highlighter-rouge">krb5.conf</code> file (see
<a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">JDK’s Kerberos Requirements</a> for more details).</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
+</code></pre></div> </div>
</li>
<li>
<p>Make sure the keytabs configured in the <code class="highlighter-rouge">bookkeeper_jaas.conf</code> are readable by the operating system user who is starting bookkeeper client.</p>
@@ -664,9 +651,8 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Enable SASL authentication plugin in the client by setting following parameters.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
</ol>
diff --git a/content/docs/4.5.1/security/tls/index.html b/content/docs/4.5.1/security/tls/index.html
index cb2c98d..dd2e202 100644
--- a/content/docs/4.5.1/security/tls/index.html
+++ b/content/docs/4.5.1/security/tls/index.html
@@ -481,9 +481,8 @@ In (2), with a CA, the bookie or client will trust any certificate that was sign
You can use Java’s <code class="highlighter-rouge">keytool</code> utility to accomplish this task. We will generate the key into a temporary keystore
initially so that we can export and sign it later with CA.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias localhost -validity <span class="o">{</span>validity<span class="o">}</span> -genkey
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-validity</span> <span class="o">{</span>validity<span class="o">}</span> <span class="nt">-genkey</span>
+</code></pre></div></div>
<p>You need to specify two parameters in the above command:</p>
@@ -510,25 +509,22 @@ to ensure the passport is authentic. Similarly, the CA signs the certificates, a
certificate is computationally difficult to forge. Thus, as long as the CA is a genuine and trusted authority, the clients have
high assurance that they are connecting to the authentic machines.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl req -new -x509 -keyout ca-key -out ca-cert -days 365
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl req <span class="nt">-new</span> <span class="nt">-x509</span> <span class="nt">-keyout</span> ca-key <span class="nt">-out</span> ca-cert <span class="nt">-days</span> 365
+</code></pre></div></div>
<p>The generated CA is simply a <em>public-private</em> key pair and certificate, and it is intended to sign other certificates.</p>
<p>The next step is to add the generated CA to the clients’ truststore so that the clients can trust this CA:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.truststore.jks -alias CARoot -import -file ca-cert
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.truststore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+</code></pre></div></div>
<p>NOTE: If you configure the bookies to require client authentication by setting <code class="highlighter-rouge">sslClientAuthentication</code> to <code class="highlighter-rouge">true</code> on the
<a href="../../reference/config">bookie config</a>, then you must also provide a truststore for the bookies and it should have all the CA
certificates that clients keys were signed by.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore client.truststore.jks -alias CARoot -import -file ca-cert
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> client.truststore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+</code></pre></div></div>
<p>In contrast to the keystore, which stores each machine’s own identity, the truststore of a client stores all the certificates
that the client should trust. Importing a certificate into one’s truststore also means trusting all certificates that are signed
@@ -541,22 +537,19 @@ That way all machines can authenticate all other machines.</p>
<p>The next step is to sign all certificates in the keystore with the CA we generated. First, you need to export the certificate from the keystore:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias localhost -certreq -file cert-file
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-certreq</span> <span class="nt">-file</span> cert-file
+</code></pre></div></div>
<p>Then sign it with the CA:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl x509 -req -CA ca-cert -CAkey ca-key -in cert-file -out cert-signed -days <span class="o">{</span>validity<span class="o">}</span> -CAcreateserial -passin pass:<span class="o">{</span>ca-password<span class="o">}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl x509 <span class="nt">-req</span> <span class="nt">-CA</span> ca-cert <span class="nt">-CAkey</span> ca-key <span class="nt">-in</span> cert-file <span class="nt">-out</span> cert-signed <span class="nt">-days</span> <span class="o">{</span>validity<span class="o">}</span> <span class="nt">-CAcreateserial</span> <span class="nt">-passin</span> pass:<span class="o">{</span>ca-password [...]
+</code></pre></div></div>
<p>Finally, you need to import both the certificate of the CA and the signed certificate into the keystore:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias CARoot -import -file ca-cert
-keytool -keystore bookie.keystore.jks -alias localhost -import -file cert-signed
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-import</span> <span class="nt">-file</span> cert-signed
+</code></pre></div></div>
<p>The definitions of the parameters are the following:</p>
@@ -585,7 +578,7 @@ netty bindings to leverage installed OpenSSL.</p>
<p>The following TLS configs are needed on the bookie side:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
<span class="c"># key store</span>
<span class="nv">tlsKeyStoreType</span><span class="o">=</span>JKS
<span class="nv">tlsKeyStore</span><span class="o">=</span>/var/private/tls/bookie.keystore.jks
@@ -594,8 +587,7 @@ netty bindings to leverage installed OpenSSL.</p>
<span class="nv">tlsTrustStoreType</span><span class="o">=</span>JKS
<span class="nv">tlsTrustStore</span><span class="o">=</span>/var/private/tls/bookie.truststore.jks
<span class="nv">tlsTrustStorePasswordPath</span><span class="o">=</span>/var/private/tls/bookie.truststore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>NOTE: it is important to restrict access to the store files and corresponding password files via filesystem permissions.</p>
@@ -614,19 +606,17 @@ netty bindings to leverage installed OpenSSL.</p>
<p>To verify the bookie’s keystore and truststore are setup correctly you can run the following command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl s_client -debug -connect localhost:3181 -tls1
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl s_client <span class="nt">-debug</span> <span class="nt">-connect</span> localhost:3181 <span class="nt">-tls1</span>
+</code></pre></div></div>
<p>NOTE: TLSv1 should be listed under <code class="highlighter-rouge">tlsEnabledProtocols</code>.</p>
<p>In the output of this command you should see the server’s certificate:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>-----BEGIN CERTIFICATE-----
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">-----BEGIN</span> CERTIFICATE-----
<span class="o">{</span>variable sized random bytes<span class="o">}</span>
------END CERTIFICATE-----
-</code></pre>
-</div>
+<span class="nt">-----END</span> CERTIFICATE-----
+</code></pre></div></div>
<p>If the certificate does not show up or if there are any other error messages then your keystore is not setup correctly.</p>
@@ -637,11 +627,10 @@ supported. The configs for TLS will be the same as bookies.</p>
<p>If client authentication is not required by the bookies, the following is a minimal configuration example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
<span class="nv">clientTrustStore</span><span class="o">=</span>/var/private/tls/client.truststore.jks
<span class="nv">clientTrustStorePasswordPath</span><span class="o">=</span>/var/private/tls/client.truststore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If client authentication is required, then a keystore must be created for each client, and the bookies’ truststores must
trust the certificate in the client’s keystore. This may be done using commands that are similar to what we used for
@@ -649,11 +638,10 @@ the <a href="#bookie-keystore">bookie keystore</a>.</p>
<p>And the following must also be configured:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsClientAuthentication</span><span class="o">=</span><span class="nb">true
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsClientAuthentication</span><span class="o">=</span><span class="nb">true
</span><span class="nv">clientKeyStore</span><span class="o">=</span>/var/private/tls/client.keystore.jks
<span class="nv">clientKeyStorePasswordPath</span><span class="o">=</span>/var/private/tls/client.keystore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>NOTE: it is important to restrict access to the store files and corresponding password files via filesystem permissions.</p>
@@ -663,9 +651,8 @@ the <a href="#bookie-keystore">bookie keystore</a>.</p>
<p>You can enable TLS debug logging at the JVM level by starting the bookies and/or clients with <code class="highlighter-rouge">javax.net.debug</code> system property. For example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>-Djavax.net.debug<span class="o">=</span>all
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">-Djavax</span>.net.debug<span class="o">=</span>all
+</code></pre></div></div>
<p>You can find more details on this in <a href="http://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/ReadDebug.html">Oracle documentation</a> on
<a href="http://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/ReadDebug.html">debugging SSL/TLS connections</a>.</p>
diff --git a/content/docs/4.6.0/admin/autorecovery/index.html b/content/docs/4.6.0/admin/autorecovery/index.html
index e344079..a757699 100644
--- a/content/docs/4.6.0/admin/autorecovery/index.html
+++ b/content/docs/4.6.0/admin/autorecovery/index.html
@@ -474,20 +474,18 @@
<p>Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="c"># IP and port for the failed bookie</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If you wish, you can also specify which bookie you’d like to rereplicate to. Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="se">\ </span> <span class="c"># IP and port for the failed bookie</span>
192.168.1.11:3181 <span class="c"># IP and port for the bookie to rereplicate to</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="the-manual-recovery-process">The manual recovery process</h3>
@@ -520,9 +518,8 @@
<p>You can start up AutoRecovery using the <a href="../../reference/cli#bookkeeper-autorecovery"><code class="highlighter-rouge">autorecovery</code></a> command of the <a href="../../reference/cli"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool.</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
+</code></pre></div></div>
<blockquote>
<p>The most important thing to ensure when starting up AutoRecovery is that the ZooKeeper connection string specified by the <a href="../../reference/config#zkServers"><code class="highlighter-rouge">zkServers</code></a> parameter points to the right ZooKeeper cluster.</p>
@@ -542,15 +539,13 @@
<p>You can disable AutoRecover using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -disable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-disable</span>
+</code></pre></div></div>
<p>Once disabled, you can reenable AutoRecovery using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">enable</code></a> shell command:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -enable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-enable</span>
+</code></pre></div></div>
<h2 id="autorecovery-architecture">AutoRecovery architecture</h2>
diff --git a/content/docs/4.6.0/admin/bookies/index.html b/content/docs/4.6.0/admin/bookies/index.html
index 105d01f..1650cf3 100644
--- a/content/docs/4.6.0/admin/bookies/index.html
+++ b/content/docs/4.6.0/admin/bookies/index.html
@@ -484,15 +484,13 @@
<p>To start a bookie in the foreground, use the <a href="../../reference/cli#bookkeeper-bookie"><code class="highlighter-rouge">bookie</code></a> command of the <a href="../../reference/cli#bookkeeper"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>To start a bookie in the background, use the <a href="../../reference/cli#bookkeeper-daemon.sh"><code class="highlighter-rouge">bookkeeper-daemon.sh</code></a> script and run <code class="highlighter-rouge">start bookie</code>:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
+</code></pre></div></div>
<h3 id="local-bookies">Local bookies</h3>
@@ -500,9 +498,8 @@
<p>This would spin up a local ensemble of 6 bookies:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
+</code></pre></div></div>
<blockquote>
<p>When you run a local bookie ensemble, all bookies run in a single JVM process.</p>
@@ -556,18 +553,16 @@
<p>To enable logging for a bookie, create a <code class="highlighter-rouge">log4j.properties</code> file and point the <code class="highlighter-rouge">BOOKIE_LOG_CONF</code> environment variable to the configuration file. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
-<span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
+<span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<h2 id="upgrading">Upgrading</h2>
<p>From time to time you may need to make changes to the filesystem layout of bookies—changes that are incompatible with previous versions of BookKeeper and require that directories used with previous versions are upgraded. If a filesystem upgrade is required when updating BookKeeper, the bookie will fail to start and return an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
+</code></pre></div></div>
<p>BookKeeper provides a utility for upgrading the filesystem. You can perform an upgrade using the <a href="../../reference/cli#bookkeeper-upgrade"><code class="highlighter-rouge">upgrade</code></a> command of the <code class="highlighter-rouge">bookkeeper</code> CLI tool. When running <code class="highlighter-rouge">bookkeeper upgrade</code> you need to specify one of three flags:</p>
@@ -598,27 +593,23 @@
<p>A standard upgrade pattern is to run an upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --upgrade
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--upgrade</span>
+</code></pre></div></div>
<p>…then check that everything is working normally, then kill the bookie. If everything is okay, finalize the upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --finalize
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--finalize</span>
+</code></pre></div></div>
<p>…and then restart the server:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>If something has gone wrong, you can always perform a rollback:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --rollback
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--rollback</span>
+</code></pre></div></div>
<h2 id="formatting">Formatting</h2>
@@ -626,15 +617,13 @@
<p>By default, formatting is done in interactive mode, which prompts you to confirm the format operation if old data exists. You can disable confirmation using the <code class="highlighter-rouge">-nonInteractive</code> flag. If old data does exist, the format operation will abort <em>unless</em> you set the <code class="highlighter-rouge">-force</code> flag. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
+</code></pre></div></div>
<p>You can format the local filesystem data on a bookie using the <a href="../../reference/cli#bookkeeper-shell-bookieformat"><code class="highlighter-rouge">bookieformat</code></a> command on each bookie. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
+</code></pre></div></div>
<blockquote>
<p>The <code class="highlighter-rouge">-force</code> and <code class="highlighter-rouge">-nonInteractive</code> flags are also available for the <code class="highlighter-rouge">bookieformat</code> command.</p>
@@ -648,13 +637,12 @@
<p>Accidentally replacing disks or removing directories can cause a bookie to fail while trying to read a ledger fragment that, according to the ledger metadata, exists on the bookie. For this reason, when a bookie is started for the first time, its disk configuration is fixed for the lifetime of that bookie. Any change to its disk configuration, such as a crashed disk or an accidental configuration change, will result in the bookie being unable to start. That will throw an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
.......at org.apache.bookkeeper.bookie.Cookie.verify(Cookie.java:82)
.......at org.apache.bookkeeper.bookie.Bookie.checkEnvironment(Bookie.java:275)
.......at org.apache.bookkeeper.bookie.Bookie.<init>(Bookie.java:351)
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If the change was the result of an accidental configuration change, the change can be reverted and the bookie can be restarted. However, if the change <em>cannot</em> be reverted, such as is the case when you want to add a new disk or replace a disk, the bookie must be wiped and then all its data re-replicated onto it.</p>
@@ -665,21 +653,19 @@ org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
<li>
<p>Run the following command to re-replicate the data:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
<zkserver> <span class="se">\</span>
<oldbookie> <span class="se">\</span>
<newbookie>
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>The ZooKeeper server, old bookie, and new bookie, are all identified by their external IP and <code class="highlighter-rouge">bookiePort</code> (3181 by default). Here’s an example:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
zk1.example.com <span class="se">\</span>
192.168.1.10:3181 <span class="se">\</span>
192.168.1.10:3181
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>See the <a href="../autorecovery">AutoRecovery</a> documentation for more info on the re-replication process.</p>
</li>
diff --git a/content/docs/4.6.0/admin/http/index.html b/content/docs/4.6.0/admin/http/index.html
index ac3c8b9..873c4c6 100644
--- a/content/docs/4.6.0/admin/http/index.html
+++ b/content/docs/4.6.0/admin/http/index.html
@@ -560,12 +560,11 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
</table>
</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"configName1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"configName2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue2"</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"configName1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"configName2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue2"</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Response:</p>
@@ -712,13 +711,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"ledgerId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata2"</span><span class="p">,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ledgerId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata2"</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="err">}</span><span class="w">
-</span></code></pre>
- </div>
+ </span><span class="p">}</span><span class="w">
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -780,11 +778,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -858,13 +855,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"entryId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"entryId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 2"</span><span class="p">,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"entryId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entryId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 2"</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="err">}</span><span class="w">
-</span></code></pre>
- </div>
+ </span><span class="p">}</span><span class="w">
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -934,13 +930,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookieSocketAddress1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"bookieSocketAddress2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname2"</span><span class="p">,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookieSocketAddress1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"bookieSocketAddress2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname2"</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="err">}</span><span class="w">
-</span></code></pre>
- </div>
+ </span><span class="p">}</span><span class="w">
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -980,14 +975,13 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free:</span><span class="w"> </span><span class="err">xxx,</span><span class="w"> </span><span class="err">total:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
- </span><span class="nt">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free:</span><span class="w"> </span><span class="err">xxx,</span><span class="w"> </span><span class="err">total:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">,</span><span class="w"> </span><span class="err">total</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
+ </span><span class="s2">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">,</span><span class="w"> </span><span class="err">total</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="nt">"clusterInfo"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">total_free:</span><span class="w"> </span><span class="err">xxx,</span><span class="w"> </span><span class="err">total:</span><span class="w"> </span><span class="err">xxx</span><span class="p">}</span><span class="w">
+ </span><span class="s2">"clusterInfo"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">total_free</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">,</span><span class="w"> </span><span class="err">total</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1027,13 +1021,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="err">JournalId1</span><span class="w"> </span><span class="err">:</span><span class="w"> </span><span class="err">position1,</span><span class="w">
- </span><span class="err">JournalId2</span><span class="w"> </span><span class="err">:</span><span class="w"> </span><span class="err">position2,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="err">JournalId</span><span class="mi">1</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="err">position</span><span class="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="err">JournalId</span><span class="mi">2</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="err">position</span><span class="mi">2</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1095,13 +1088,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"journal files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="p">,</span><span class="w">
- </span><span class="nt">"entrylog files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2..."</span><span class="p">,</span><span class="w">
- </span><span class="nt">"index files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"journal files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entrylog files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2..."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"index files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1150,13 +1142,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<ul>
<li>Description: Ledger data recovery for failed bookie</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_src1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_src2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
- </span><span class="nt">"bookie_dest"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_dest1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_dest2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
- </span><span class="nt">"delete_cookie"</span><span class="p">:</span><span class="w"> </span><span class="err"><bool_value></span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_src1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_src2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"bookie_dest"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_dest1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_dest2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"delete_cookie"</span><span class="p">:</span><span class="w"> </span><span class="err"><bool_value></span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Parameters:</p>
@@ -1284,11 +1275,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="err">[ledgerId1,</span><span class="w"> </span><span class="err">ledgerId2...]</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="p">[</span><span class="err">ledgerId</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="err">ledgerId</span><span class="mi">2</span><span class="err">...</span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1328,11 +1318,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"Auditor"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname/hostAddress:Port"</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"Auditor"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname/hostAddress:Port"</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1410,11 +1399,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<ul>
<li>Description: Set lostBookieRecoveryDelay value in seconds.</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"delay_seconds"</span><span class="p">:</span><span class="w"> </span><span class="err"><delay_seconds></span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"delay_seconds"</span><span class="p">:</span><span class="w"> </span><span class="err"><delay_seconds></span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Parameters:</p>
@@ -1474,11 +1462,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<ul>
<li>Description: Decommission Bookie, Force trigger Audit task and make sure all the ledgers stored in the decommissioning bookie are replicated.</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="err"><bookie_src></span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="err"><bookie_src></span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Parameters:</p>
diff --git a/content/docs/4.6.0/api/ledger-adv-api/index.html b/content/docs/4.6.0/api/ledger-adv-api/index.html
index dabd966..5b0465d 100644
--- a/content/docs/4.6.0/api/ledger-adv-api/index.html
+++ b/content/docs/4.6.0/api/ledger-adv-api/index.html
@@ -471,17 +471,16 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<p>Here’s an exmaple:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You can also create advanced ledgers asynchronously.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">createComplete</span><span class="o">(</span><span class="kt">int</span> <span class="n">returnCode</span><span class="o">,</span> <span class="n">LedgerHandle</span> <span class="n">handle</span><span class="o">,</span> <span class="n">Object</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Ledger successfully created"</span><span class="o">);</span>
<span class="o">}</span>
@@ -495,12 +494,11 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="k">new</span> <span class="nf">LedgerCreationCallback</span><span class="o">(),</span>
<span class="s">"some context"</span>
<span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Besides the APIs above, BookKeeper allows users providing <code class="highlighter-rouge">ledger-id</code> when creating advanced ledgers.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
@@ -508,8 +506,7 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>Please note, it is users’ responsibility to provide a unique ledger id when using the API above.
@@ -522,11 +519,10 @@ a <a href="../javadoc/org/apache/bookkeeper/client/BKException.BKLedgerExistExce
<p>The normal <a href="ledger-api/#adding-entries-to-ledgers">add entries api</a> in advanced ledgers are disabled. Instead, when users want to add entries
to advanced ledgers, an entry id is required to pass in along with the entry data when adding an entry.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
<span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="n">entryId</span><span class="o">,</span> <span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>A few notes when using this API:</p>
diff --git a/content/docs/4.6.0/api/ledger-api/index.html b/content/docs/4.6.0/api/ledger-api/index.html
index 3ea6814..1a51a91 100644
--- a/content/docs/4.6.0/api/ledger-api/index.html
+++ b/content/docs/4.6.0/api/ledger-api/index.html
@@ -473,7 +473,7 @@
<p>If you’re using <a href="https://maven.apache.org/">Maven</a>, add this to your <a href="https://maven.apache.org/guides/introduction/introduction-to-the-pom.html"><code class="highlighter-rouge">pom.xml</code></a> build configuration file:</p>
-<div class="language-xml highlighter-rouge"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
<span class="nt"><bookkeeper.version></span>4.6.0<span class="nt"></bookkeeper.version></span>
<span class="c"><!-- in your <dependencies> block --></span>
@@ -482,14 +482,13 @@
<span class="nt"><artifactId></span>bookkeeper-server<span class="nt"></artifactId></span>
<span class="nt"><version></span>${bookkeeper.version}<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="gradle">Gradle</h3>
<p>If you’re using <a href="https://gradle.org/">Gradle</a>, add this to your <a href="https://spring.io/guides/gs/gradle/"><code class="highlighter-rouge">build.gradle</code></a> build configuration file:</p>
-<div class="language-groovy highlighter-rouge"><pre class="highlight"><code><span class="n">dependencies</span> <span class="o">{</span>
+<div class="language-groovy highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="nl">group:</span> <span class="s1">'org.apache.bookkeeper'</span><span class="o">,</span> <span class="nl">name:</span> <span class="s1">'bookkeeper-server'</span><span class="o">,</span> <span class="nl">version:</span> <span class="s1">'4.6.0'</span>
<span class="o">}</span>
@@ -497,8 +496,7 @@
<span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="s1">'org.apache.bookkeeper:bookkeeper-server:4.6.0'</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="connection-string">Connection string</h2>
@@ -514,14 +512,13 @@
<p>In order to create a new <a href="../javadoc/org/apache/bookkeeper/client/BookKeeper"><code class="highlighter-rouge">BookKeeper</code></a> client object, you need to pass in a <a href="#connection-string">connection string</a>. Here is an example client object using a ZooKeeper connection string:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="k">try</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">try</span> <span class="o">{</span>
<span class="n">String</span> <span class="n">connectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span> <span class="c1">// For a single-node, local ZooKeeper cluster</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">connectionString</span><span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">InterruptedException</span> <span class="o">|</span> <span class="n">IOException</span> <span class="o">|</span> <span class="n">KeeperException</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
<span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>If you’re running BookKeeper <a href="../../getting-started/run-locally">locally</a>, using the <a href="../../reference/cli#bookkeeper-localbookie"><code class="highlighter-rouge">localbookie</code></a> command, use <code class="highlighter-rouge">"127.0.0.1:2181"</code> for your connection string, as in the example above.</p>
@@ -533,29 +530,26 @@
<li>
<p>By passing in a <a href="../javadoc/org/apache/bookkeeper/conf/ClientConfiguration"><code class="highlighter-rouge">ClientConfiguration</code></a> object. Here’s an example:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">config</span><span class="o">.</span><span class="na">setZkServers</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
<span class="n">config</span><span class="o">.</span><span class="na">setAddEntryTimeout</span><span class="o">(</span><span class="mi">2000</span><span class="o">);</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">config</span><span class="o">);</span>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>By specifying a <code class="highlighter-rouge">ClientConfiguration</code> and a <a href="http://zookeeper.apache.org/doc/current/api/org/apache/zookeeper/ZooKeeper.html"><code class="highlighter-rouge">ZooKeeper</code></a> client object:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">config</span><span class="o">.</span><span class="na">setAddEntryTimeout</span><span class="o">(</span><span class="mi">5000</span><span class="o">);</span>
<span class="n">ZooKeeper</span> <span class="n">zkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ZooKeeper</span><span class="o">(</span><span class="cm">/* client args */</span><span class="o">);</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">config</span><span class="o">,</span> <span class="n">zkClient</span><span class="o">);</span>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Using the <code class="highlighter-rouge">forConfig</code> method:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="n">BookKeeper</span><span class="o">.</span><span class="na">forConfig</span><span class="o">(</span><span class="n">conf</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
- </div>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="n">BookKeeper</span><span class="o">.</span><span class="na">forConfig</span><span class="o">(</span><span class="n">conf</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
+</code></pre></div> </div>
</li>
</ul>
@@ -565,16 +559,15 @@
<p>Here’s an example:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandle</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedger</span><span class="o">(</span><span class="n">BookKeeper</span><span class="o">.</span><span class="na">DigestType</span><span class="o">.</span><span class="na">MAC</span><span class="o">,</span> <span class="n">password</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You can also create ledgers asynchronously</p>
<h3 id="create-ledgers-asynchronously">Create ledgers asynchronously</h3>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">createComplete</span><span class="o">(</span><span class="kt">int</span> <span class="n">returnCode</span><span class="o">,</span> <span class="n">LedgerHandle</span> <span class="n">handle</span><span class="o">,</span> <span class="n">Object</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Ledger successfully created"</span><span class="o">);</span>
<span class="o">}</span>
@@ -588,34 +581,30 @@
<span class="k">new</span> <span class="nf">LedgerCreationCallback</span><span class="o">(),</span>
<span class="s">"some context"</span>
<span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="adding-entries-to-ledgers">Adding entries to ledgers</h2>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
+</code></pre></div></div>
<h3 id="add-entries-asynchronously">Add entries asynchronously</h3>
<h2 id="reading-entries-from-ledgers">Reading entries from ledgers</h2>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span> <span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">1</span><span class="o">,</span> <span class="mi">99</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span> <span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">1</span><span class="o">,</span> <span class="mi">99</span><span class="o">);</span>
+</code></pre></div></div>
<p>To read all possible entries from the ledger:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
<span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">0</span><span class="o">,</span> <span class="n">handle</span><span class="o">.</span><span class="na">getLastAddConfirmed</span><span class="o">());</span>
<span class="k">while</span> <span class="o">(</span><span class="n">entries</span><span class="o">.</span><span class="na">hasNextElement</span><span class="o">())</span> <span class="o">{</span>
<span class="n">LedgerEntry</span> <span class="n">entry</span> <span class="o">=</span> <span class="n">entries</span><span class="o">.</span><span class="na">nextElement</span><span class="o">();</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Successfully read entry "</span> <span class="o">+</span> <span class="n">entry</span><span class="o">.</span><span class="na">getId</span><span class="o">());</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="reading-entries-after-the-lastaddconfirmed-range">Reading entries after the LastAddConfirmed range</h3>
@@ -625,29 +614,27 @@ For entries which are within the range 0..LastAddConfirmed BookKeeper guarantees
For entries outside that range it is possible that the writer never received the acknowledge and so there is the risk that the reader is seeing entries before the writer and this could result in a consistency issue in some cases.
With this method you can even read entries before the LastAddConfirmed and entries after it with one call, the expected consistency will be as described above.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
<span class="n">handle</span><span class="o">.</span><span class="na">readUnconfirmedEntries</span><span class="o">(</span><span class="mi">0</span><span class="o">,</span> <span class="n">lastEntryIdExpectedToRead</span><span class="o">);</span>
<span class="k">while</span> <span class="o">(</span><span class="n">entries</span><span class="o">.</span><span class="na">hasNextElement</span><span class="o">())</span> <span class="o">{</span>
<span class="n">LedgerEntry</span> <span class="n">entry</span> <span class="o">=</span> <span class="n">entries</span><span class="o">.</span><span class="na">nextElement</span><span class="o">();</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Successfully read entry "</span> <span class="o">+</span> <span class="n">entry</span><span class="o">.</span><span class="na">getId</span><span class="o">());</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="deleting-ledgers">Deleting ledgers</h2>
<p><span class="pop" id="ledger-popover">Ledgers</span> can also be deleted synchronously or asynchronously.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="mi">1234</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="mi">1234</span><span class="o">;</span>
<span class="k">try</span> <span class="o">{</span>
<span class="n">bkClient</span><span class="o">.</span><span class="na">deleteLedger</span><span class="o">(</span><span class="n">ledgerId</span><span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">Exception</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
<span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="delete-entries-asynchronously">Delete entries asynchronously</h3>
@@ -655,13 +642,12 @@ With this method you can even read entries before the LastAddConfirmed and entri
<p>*</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">DeleteEntryCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">DeleteCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">DeleteEntryCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">DeleteCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">deleteComplete</span><span class="o">()</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Delete completed"</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="simple-example">Simple example</h2>
@@ -679,7 +665,7 @@ With this method you can even read entries before the LastAddConfirmed and entri
<li>reads all available entries</li>
</ul>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="c1">// Create a client object for the local ensemble. This</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// Create a client object for the local ensemble. This</span>
<span class="c1">// operation throws multiple exceptions, so make sure to</span>
<span class="c1">// use a try/catch block when instantiating client objects.</span>
<span class="n">BookKeeper</span> <span class="n">bkc</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"localhost:2181"</span><span class="o">);</span>
@@ -721,17 +707,15 @@ With this method you can even read entries before the LastAddConfirmed and entri
<span class="c1">// Close the ledger and the client</span>
<span class="n">lh</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
<span class="n">bkc</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Running this should return this output:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>Result: 0
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Result: 0
Result: 1
Result: 2
<span class="c"># etc</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="example-application">Example application</h2>
@@ -747,9 +731,8 @@ Result: 2
<p>To start up a cluster consisting of six <span class="pop" id="bookie-popover">bookies</span> locally:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
+</code></pre></div></div>
<p>You can specify a different number of bookies if you’d like.</p>
@@ -767,15 +750,14 @@ Result: 2
<p>To begin, download the base application, compile and run it.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>git clone https://github.com/ivankelly/bookkeeper-tutorial.git
-<span class="gp">$ </span>mvn package
-<span class="gp">$ </span>mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>git clone https://github.com/ivankelly/bookkeeper-tutorial.git
+<span class="nv">$ </span>mvn package
+<span class="nv">$ </span>mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+</code></pre></div></div>
<p>That should yield output that looks something like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>[INFO] Scanning for projects...
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building tutorial 1.0-SNAPSHOT
@@ -786,14 +768,13 @@ Result: 2
Value = 4
Value = 5
Value = 3
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="the-base-application">The base application</h3>
<p>The application in this tutorial is a dice application. The <code class="highlighter-rouge">Dice</code> class below has a <code class="highlighter-rouge">playDice</code> function that generates a random number between 1 and 6 every second, prints the value of the dice roll, and runs indefinitely.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
<span class="n">Random</span> <span class="n">r</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Random</span><span class="o">();</span>
<span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
@@ -803,12 +784,11 @@ Value = 3
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>When you run the <code class="highlighter-rouge">main</code> function of this class, a new <code class="highlighter-rouge">Dice</code> object will be instantiated and then run indefinitely:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
<span class="c1">// other methods</span>
<span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
@@ -816,8 +796,7 @@ Value = 3
<span class="n">d</span><span class="o">.</span><span class="na">playDice</span><span class="o">();</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="leaders-and-followers-and-a-bit-of-background">Leaders and followers (and a bit of background)</h3>
@@ -845,7 +824,7 @@ Value = 3
<p>We’ll use zookeeper to elect a leader. A zookeeper instance will have started locally when you started the localbookie application above. To verify it’s running, run the following command.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span><span class="nb">echo </span>stat | nc localhost 2181
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">echo stat</span> | nc localhost 2181
Zookeeper version: 3.4.6-1569965, built on 02/20/2014 09:09 GMT
Clients:
/127.0.0.1:59343[1]<span class="o">(</span><span class="nv">queued</span><span class="o">=</span>0,recved<span class="o">=</span>40,sent<span class="o">=</span>41<span class="o">)</span>
@@ -863,12 +842,11 @@ Outstanding: 0
Zxid: 0x11
Mode: standalone
Node count: 16
-</code></pre>
-</div>
+</code></pre></div></div>
<p>To interact with zookeeper, we’ll use the Curator client rather than the stock zookeeper client. Getting things right with the zookeeper client can be tricky, and curator removes a lot of the pointy corners for you. In fact, curator even provides a leader election recipe, so we need to do very little work to get leader election in our application.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="kd">extends</span> <span class="n">LeaderSelectorListenerAdapter</span> <span class="kd">implements</span> <span class="n">Closeable</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="kd">extends</span> <span class="n">LeaderSelectorListenerAdapter</span> <span class="kd">implements</span> <span class="n">Closeable</span> <span class="o">{</span>
<span class="kd">final</span> <span class="kd">static</span> <span class="n">String</span> <span class="n">ZOOKEEPER_SERVER</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
<span class="kd">final</span> <span class="kd">static</span> <span class="n">String</span> <span class="n">ELECTION_PATH</span> <span class="o">=</span> <span class="s">"/dice-elect"</span><span class="o">;</span>
@@ -885,8 +863,7 @@ Node count: 16
<span class="n">leaderSelector</span><span class="o">.</span><span class="na">autoRequeue</span><span class="o">();</span>
<span class="n">leaderSelector</span><span class="o">.</span><span class="na">start</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>In the constructor for Dice, we need to create the curator client. We specify four things when creating the client, the location of the zookeeper service, the session timeout, the connect timeout and the retry policy.</p>
@@ -894,7 +871,7 @@ Node count: 16
<p>Finally, you’ll have noticed that Dice now extends LeaderSelectorListenerAdapter and implements Closeable. Closeable is there to close the resource we have initialized in the constructor, the curator client and the leaderSelector. LeaderSelectorListenerAdapter is a callback that the leaderSelector uses to notify the instance that it is now the leader. It is passed as the third argument to the LeaderSelector constructor.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="nd">@Override</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nd">@Override</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">takeLeadership</span><span class="o">(</span><span class="n">CuratorFramework</span> <span class="n">client</span><span class="o">)</span>
<span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
<span class="kd">synchronized</span> <span class="o">(</span><span class="k">this</span><span class="o">)</span> <span class="o">{</span>
@@ -909,12 +886,11 @@ Node count: 16
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>takeLeadership() is the callback called by LeaderSelector when the instance is leader. It should only return when the instance wants to give up leadership. In our case, we never do so we wait on the current object until we’re interrupted. To signal to the rest of the program that we are leader we set a volatile boolean called leader to true. This is unset after we are interrupted.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
<span class="k">while</span> <span class="o">(</span><span class="kc">true</span><span class="o">)</span> <span class="o">{</span>
<span class="k">while</span> <span class="o">(</span><span class="n">leader</span><span class="o">)</span> <span class="o">{</span>
<span class="n">Thread</span><span class="o">.</span><span class="na">sleep</span><span class="o">(</span><span class="mi">1000</span><span class="o">);</span>
@@ -923,8 +899,7 @@ Node count: 16
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Finally, we modify the <code class="highlighter-rouge">playDice</code> function to only generate random numbers when it is the leader.</p>
@@ -934,18 +909,17 @@ Node count: 16
<p>Now go back to the shell that the original leader was on and wake up the process using fg. You’ll see something like the following:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>...
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>...
...
Value <span class="o">=</span> 4, isLeader <span class="o">=</span> <span class="nb">true
</span>Value <span class="o">=</span> 4, isLeader <span class="o">=</span> <span class="nb">true</span>
^Z
-<span class="o">[</span>1]+ Stopped mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
-<span class="gp">$ </span><span class="nb">fg
-</span>mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+<span class="o">[</span>1]+ Stopped mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+<span class="nv">$ </span><span class="nb">fg
+</span>mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
Value <span class="o">=</span> 3, isLeader <span class="o">=</span> <span class="nb">true
</span>Value <span class="o">=</span> 1, isLeader <span class="o">=</span> <span class="nb">false</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="new-api">New API</h2>
@@ -964,7 +938,7 @@ Value <span class="o">=</span> 3, isLeader <span class="o">=</span> <span class=
<p>Here is an example building the bookkeeper client.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="c1">// construct a client configuration instance</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// construct a client configuration instance</span>
<span class="n">ClientConfiguration</span> <span class="n">conf</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">conf</span><span class="o">.</span><span class="na">setZkServers</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
<span class="n">conf</span><span class="o">.</span><span class="na">setZkLedgersRootPath</span><span class="o">(</span><span class="s">"/path/to/ledgers/root"</span><span class="o">);</span>
@@ -975,8 +949,7 @@ Value <span class="o">=</span> 3, isLeader <span class="o">=</span> <span class=
<span class="o">...</span>
<span class="o">.</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="create-ledgers">Create ledgers</h3>
@@ -985,7 +958,7 @@ a <a href="../javadoc/org/apache/bookkeeper/client/api/digesttype"><code class="
<p>here’s an example:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
@@ -997,8 +970,7 @@ a <a href="../javadoc/org/apache/bookkeeper/client/api/digesttype"><code class="
<span class="o">.</span><span class="na">withAckQuorumSize</span><span class="o">(</span><span class="mi">2</span><span class="o">)</span>
<span class="o">.</span><span class="na">execute</span><span class="o">()</span> <span class="c1">// execute the creation op</span>
<span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// wait for the execution to complete</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>A <a href="../javadoc/org/apache/bookkeeper/client/api/WriteHandle"><code class="highlighter-rouge">WriteHandle</code></a> is returned for applications to write and read entries to and from the ledger.</p>
@@ -1006,7 +978,7 @@ a <a href="../javadoc/org/apache/bookkeeper/client/api/digesttype"><code class="
<p>The <a href="../javadoc/org/apache/bookkeeper/client/api/WriteHandle"><code class="highlighter-rouge">WriteHandle</code></a> can be used for applications to append entries to the ledgers.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">WriteHandle</span> <span class="n">wh</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">WriteHandle</span> <span class="n">wh</span> <span class="o">=</span> <span class="o">...;</span>
<span class="n">CompletableFuture</span><span class="o"><</span><span class="n">Long</span><span class="o">></span> <span class="n">addFuture</span> <span class="o">=</span> <span class="n">wh</span><span class="o">.</span><span class="na">append</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
@@ -1037,8 +1009,7 @@ a <a href="../javadoc/org/apache/bookkeeper/client/api/digesttype"><code class="
<span class="c1">// handle the exception</span>
<span class="o">}</span>
<span class="o">});</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>The append method supports three representations of a bytes array: the native java <code class="highlighter-rouge">byte[]</code>, java nio <code class="highlighter-rouge">ByteBuffer</code> and netty <code class="highlighter-rouge">ByteBuf</code>.
It is recommended to use <code class="highlighter-rouge">ByteBuf</code> as it is more gc friendly.</p>
@@ -1050,7 +1021,7 @@ in order to open the ledgers.</p>
<p>here’s an example:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
@@ -1060,8 +1031,7 @@ in order to open the ledgers.</p>
<span class="o">.</span><span class="na">withPassword</span><span class="o">(</span><span class="n">password</span><span class="o">)</span>
<span class="o">.</span><span class="na">execute</span><span class="o">()</span> <span class="c1">// execute the open op</span>
<span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// wait for the execution to complete</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>A <a href="../javadoc/org/apache/bookkeeper/client/api/ReadHandle"><code class="highlighter-rouge">ReadHandle</code></a> is returned for applications to read entries to and from the ledger.</p>
@@ -1070,7 +1040,7 @@ in order to open the ledgers.</p>
<p>By default, the <a href="../javadoc/org/apache/bookkeeper/client/api/openBuilder"><code class="highlighter-rouge">openBuilder</code></a> opens the ledger in a <code class="highlighter-rouge">NoRecovery</code> mode. You can open the ledger in <code class="highlighter-rouge">Recovery</code> mode by specifying
<code class="highlighter-rouge">withRecovery(true)</code> in the open builder.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
@@ -1082,8 +1052,7 @@ in order to open the ledgers.</p>
<span class="o">.</span><span class="na">execute</span><span class="o">()</span>
<span class="o">.</span><span class="na">get</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p><strong>What is the difference between “Recovery” and “NoRecovery”?</strong></p>
@@ -1096,7 +1065,7 @@ to be appended to it. The writer which is currently appending entries to the led
<p>The <a href="../javadoc/org/apache/bookkeeper/client/api/ReadHandle"><code class="highlighter-rouge">ReadHandle</code></a> returned from the open builder can be used for applications to read entries from the ledgers.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">startEntryId</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">endEntryId</span> <span class="o">=</span> <span class="o">...;</span>
@@ -1129,8 +1098,7 @@ to be appended to it. The writer which is currently appending entries to the led
<span class="c1">// handle the exception</span>
<span class="o">}</span>
<span class="o">});</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Once you are done with processing the <a href="../javadoc/org/apache/bookkeeper/client/api/LedgerEntries"><code class="highlighter-rouge">LedgerEntries</code></a>, you can call <code class="highlighter-rouge">#close()</code> on the <code class="highlighter-rouge">LedgerEntries</code> instance to
release the buffers held by it.</p>
@@ -1143,9 +1111,8 @@ attempts to read entries beyond <code class="highlighter-rouge">LastAddConfirmed
<p><code class="highlighter-rouge">readUnconfirmed</code> is provided the mechanism for applications to read entries beyond <code class="highlighter-rouge">LastAddConfirmed</code>. Applications should be aware of <code class="highlighter-rouge">readUnconfirmed</code> doesn’t provide any
repeatable read consistency.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">CompletableFuture</span><span class="o"><</span><span class="n">LedgerEntries</span><span class="o">></span> <span class="n">readFuture</span> <span class="o">=</span> <span class="n">rh</span><span class="o">.</span><span class="na">readUnconfirmed</span><span class="o">(</span><span class="n">startEntryId</span><span class="o">,</span> <span class="n">endEntryId</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">CompletableFuture</span><span class="o"><</span><span class="n">LedgerEntries</span><span class="o">></span> <span class="n">readFuture</span> <span class="o">=</span> <span class="n">rh</span><span class="o">.</span><span class="na">readUnconfirmed</span><span class="o">(</span><span class="n">startEntryId</span><span class="o">,</span> <span class="n">endEntryId</span> [...]
+</code></pre></div></div>
<h3 id="tailing-reads">Tailing Reads</h3>
@@ -1155,7 +1122,7 @@ repeatable read consistency.</p>
<p>You can do this in synchronous way:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">startEntryId</span> <span class="o">=</span> <span class="mi">0L</span><span class="o">;</span>
<span class="kt">long</span> <span class="n">nextEntryId</span> <span class="o">=</span> <span class="n">startEntryId</span><span class="o">;</span>
@@ -1177,12 +1144,11 @@ repeatable read consistency.</p>
<span class="n">nextEntryId</span> <span class="o">=</span> <span class="n">endEntryId</span> <span class="o">+</span> <span class="mi">1</span><span class="o">;</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h4 id="long-polling">Long Polling</h4>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">startEntryId</span> <span class="o">=</span> <span class="mi">0L</span><span class="o">;</span>
<span class="kt">long</span> <span class="n">nextEntryId</span> <span class="o">=</span> <span class="n">startEntryId</span><span class="o">;</span>
@@ -1206,22 +1172,20 @@ repeatable read consistency.</p>
<span class="n">nextEntryId</span> <span class="o">=</span> <span class="n">endEntryId</span> <span class="o">+</span> <span class="mi">1</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="delete-ledgers">Delete ledgers</h3>
<p><span class="pop" id="ledger-popover">Ledgers</span> can be deleted by using <a href="../javadoc/org/apache/bookkeeper/client/api/DeleteBuilder"><code class="highlighter-rouge">DeleteBuilder</code></a>.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span>
<span class="n">bk</span><span class="o">.</span><span class="na">newDeleteLedgerOp</span><span class="o">()</span>
<span class="o">.</span><span class="na">withLedgerId</span><span class="o">(</span><span class="n">ledgerId</span><span class="o">)</span>
<span class="o">.</span><span class="na">execute</span><span class="o">()</span>
<span class="o">.</span><span class="na">get</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.6.0/deployment/dcos/index.html b/content/docs/4.6.0/deployment/dcos/index.html
index 7ad9dc1..afc64cc 100644
--- a/content/docs/4.6.0/deployment/dcos/index.html
+++ b/content/docs/4.6.0/deployment/dcos/index.html
@@ -485,9 +485,8 @@
<h2 id="installing-bookkeeper">Installing BookKeeper</h2>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper --yes
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="nt">--yes</span>
+</code></pre></div></div>
<p>This command will:</p>
@@ -499,7 +498,7 @@
<p>The bookie that is automatically started up uses the host mode of the network and by default exports the service at <code class="highlighter-rouge">agent_ip:3181</code>.</p>
<blockquote>
- <p>If you run <code class="highlighter-rouge">dcos package install bookkeeper</code> without setting the <code class="highlighter-rouge">--yes</code> flag, the install will run in interactive mode. For more information on the <code class="highlighter-rouge">package install</code> command, see the <a href="https://docs.mesosphere.com/latest/cli/command-reference/dcos-package/dcos-package-install/">DC/OS docs</a>.</p>
+ <p>If you run <code class="highlighter-rouge">dcos package install bookkeeper</code> without setting the <code class="highlighter-rouge">--yes</code> flag, the install will run in interactive mode. For more information on the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">install</span></code> command, see the <a href="https://docs.mesosphere.com/latest/cli/command-reference/dcos-package/dcos-package-install/">DC/OS docs</a>.</p>
</blockquote>
<h3 id="services">Services</h3>
@@ -532,15 +531,13 @@
<p>To connect to bookies running on DC/OS using clients running within your Mesos cluster, you need to specify the ZooKeeper connection string for DC/OS’s ZooKeeper cluster:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>master.mesos:2181
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>master.mesos:2181
+</code></pre></div></div>
<p>This is the <em>only</em> ZooKeeper host/port you need to include in your connection string. Here’s an example using the <a href="../../api/ledger-api#the-java-ledger-api-client">Java client</a>:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"master.mesos:2181"</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"master.mesos:2181"</span><span class="o">);</span>
+</code></pre></div></div>
<p>If you’re connecting using a client running outside your Mesos cluster, you need to supply the public-facing connection string for your DC/OS ZooKeeper cluster.</p>
@@ -550,17 +547,15 @@
<p>You can supply a non-default configuration when installing the package using a JSON file. Here’s an example command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper <span class="se">\</span>
- --options<span class="o">=</span>/path/to/config.json
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="se">\</span>
+ <span class="nt">--options</span><span class="o">=</span>/path/to/config.json
+</code></pre></div></div>
-<p>You can then fetch the current configuration for BookKeeper at any time using the <code class="highlighter-rouge">package describe</code> command:</p>
+<p>You can then fetch the current configuration for BookKeeper at any time using the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">describe</span></code> command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package describe bookkeeper <span class="se">\</span>
- --config
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package describe bookkeeper <span class="se">\</span>
+ <span class="nt">--config</span>
+</code></pre></div></div>
<h3 id="available-parameters">Available parameters</h3>
@@ -627,31 +622,28 @@
<p>Here’s an example JSON configuration object for BookKeeper on DC/OS:</p>
-<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
- </span><span class="nt">"instances"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
- </span><span class="nt">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
- </span><span class="nt">"mem"</span><span class="p">:</span><span class="w"> </span><span class="mf">2048.0</span><span class="p">,</span><span class="w">
- </span><span class="nt">"volume_size"</span><span class="p">:</span><span class="w"> </span><span class="mi">250</span><span class="w">
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"instances"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"mem"</span><span class="p">:</span><span class="w"> </span><span class="mf">2048.0</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"volume_size"</span><span class="p">:</span><span class="w"> </span><span class="mi">250</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
-</div>
+</span></code></pre></div></div>
<p>If that configuration were stored in a file called <code class="highlighter-rouge">bk-config.json</code>, you could apply that configuration upon installating the BookKeeper package using this command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper <span class="se">\</span>
- --options<span class="o">=</span>./bk-config.json
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="se">\</span>
+ <span class="nt">--options</span><span class="o">=</span>./bk-config.json
+</code></pre></div></div>
<h2 id="uninstalling-bookkeeper">Uninstalling BookKeeper</h2>
-<p>You can shut down and uninstall the <code class="highlighter-rouge">bookkeeper</code> from DC/OS at any time using the <code class="highlighter-rouge">package uninstall</code> command:</p>
+<p>You can shut down and uninstall the <code class="highlighter-rouge">bookkeeper</code> from DC/OS at any time using the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">uninstall</span></code> command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package uninstall bookkeeper
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package uninstall bookkeeper
Uninstalled package <span class="o">[</span>bookkeeper] version <span class="o">[</span>4.6.0]
Thank you <span class="k">for </span>using bookkeeper.
-</code></pre>
-</div>
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.6.0/deployment/kubernetes/index.html b/content/docs/4.6.0/deployment/kubernetes/index.html
index cc374f2..db403c5 100644
--- a/content/docs/4.6.0/deployment/kubernetes/index.html
+++ b/content/docs/4.6.0/deployment/kubernetes/index.html
@@ -494,15 +494,14 @@
<p>As an example, we’ll create a new GKE cluster for Kubernetes version <a href="https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG.md#v164">1.6.4</a> in the <a href="https://cloud.google.com/compute/docs/regions-zones/regions-zones#available">us-central1-a</a> zone. The cluster will be named <code class="highlighter-rouge">bookkeeper-gke-cluster</code> and will consist of three VMs, each using two locally attached SSDs and running on <a href="https://cloud.google.com/compute [...]
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>gcloud config <span class="nb">set </span>compute/zone us-central1-a
-<span class="gp">$ </span>gcloud config <span class="nb">set </span>project your-project-name
-<span class="gp">$ </span>gcloud container clusters create bookkeeper-gke-cluster <span class="se">\</span>
- --machine-type<span class="o">=</span>n1-standard-8 <span class="se">\</span>
- --num-nodes<span class="o">=</span>3 <span class="se">\</span>
- --local-ssd-count<span class="o">=</span>2 <span class="se">\</span>
- --enable-kubernetes-alpha
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>gcloud config <span class="nb">set </span>compute/zone us-central1-a
+<span class="nv">$ </span>gcloud config <span class="nb">set </span>project your-project-name
+<span class="nv">$ </span>gcloud container clusters create bookkeeper-gke-cluster <span class="se">\</span>
+ <span class="nt">--machine-type</span><span class="o">=</span>n1-standard-8 <span class="se">\</span>
+ <span class="nt">--num-nodes</span><span class="o">=</span>3 <span class="se">\</span>
+ <span class="nt">--local-ssd-count</span><span class="o">=</span>2 <span class="se">\</span>
+ <span class="nt">--enable-kubernetes-alpha</span>
+</code></pre></div></div>
<p>By default, bookies will run on all the machines that have locally attached SSD disks. In this example, all of those machines will have two SSDs, but you can add different types of machines to the cluster later. You can control which machines host bookie servers using <a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels">labels</a>.</p>
@@ -510,20 +509,18 @@
<p>You can observe your cluster in the <a href="https://kubernetes.io/docs/tasks/access-application-cluster/web-ui-dashboard/">Kubernetes Dashboard</a> by downloading the credentials for your Kubernetes cluster and opening up a proxy to the cluster:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>gcloud container clusters get-credentials bookkeeper-gke-cluster <span class="se">\</span>
- --zone<span class="o">=</span>us-central1-a <span class="se">\</span>
- --project<span class="o">=</span>your-project-name
-<span class="gp">$ </span>kubectl proxy
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>gcloud container clusters get-credentials bookkeeper-gke-cluster <span class="se">\</span>
+ <span class="nt">--zone</span><span class="o">=</span>us-central1-a <span class="se">\</span>
+ <span class="nt">--project</span><span class="o">=</span>your-project-name
+<span class="nv">$ </span>kubectl proxy
+</code></pre></div></div>
<p>By default, the proxy will be opened on port 8001. Now you can navigate to <a href="http://localhost:8001/ui">localhost:8001/ui</a> in your browser to access the dashboard. At first your GKE cluster will be empty, but that will change as you begin deploying.</p>
<p>When you create a cluster, your <code class="highlighter-rouge">kubectl</code> config in <code class="highlighter-rouge">~/.kube/config</code> (on MacOS and Linux) will be updated for you, so you probably won’t need to change your configuration. Nonetheless, you can ensure that <code class="highlighter-rouge">kubectl</code> can interact with your cluster by listing the nodes in the cluster:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl get nodes
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl get nodes
+</code></pre></div></div>
<p>If <code class="highlighter-rouge">kubectl</code> is working with your cluster, you can proceed to deploy ZooKeeper and Bookies.</p>
@@ -531,29 +528,26 @@
<p>You <em>must</em> deploy ZooKeeper as the first component, as it is a dependency for the others.</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl apply -f zookeeper.yaml
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl apply <span class="nt">-f</span> zookeeper.yaml
+</code></pre></div></div>
<p>Wait until all three ZooKeeper server pods are up and have the status <code class="highlighter-rouge">Running</code>. You can check on the status of the ZooKeeper pods at any time:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl get pods -l <span class="nv">component</span><span class="o">=</span>zookeeper
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl get pods <span class="nt">-l</span> <span class="nv">component</span><span class="o">=</span>zookeeper
NAME READY STATUS RESTARTS AGE
zk-0 1/1 Running 0 18m
zk-1 1/1 Running 0 17m
zk-2 0/1 Running 6 15m
-</code></pre>
-</div>
+</code></pre></div></div>
<p>This step may take several minutes, as Kubernetes needs to download the Docker image on the VMs.</p>
<p>If you want to connect to one of the remote zookeeper server, you can use<a href="https://github.com/rgs1/zk_shell">zk-shell</a>, you need to forward a local port to the
remote zookeeper server:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl port-forward zk-0 2181:2181
-<span class="gp">$ </span>zk-shell localhost 2181
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl port-forward zk-0 2181:2181
+<span class="nv">$ </span>zk-shell localhost 2181
+</code></pre></div></div>
<h3 id="deploy-bookies">Deploy Bookies</h3>
@@ -575,27 +569,24 @@ the data replication. It maintains the best latency property. However, it uses <
can be potentially higher when using persistent volumes, because there is usually built-in replication in the persistent volumes.</p>
</blockquote>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="c"># deploy bookies in a daemon set</span>
-<span class="gp">$ </span>kubectl apply -f bookkeeper.yaml
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># deploy bookies in a daemon set</span>
+<span class="nv">$ </span>kubectl apply <span class="nt">-f</span> bookkeeper.yaml
<span class="c"># deploy bookies in a stateful set</span>
-<span class="gp">$ </span>kubectl apply -f bookkeeper.stateful.yaml
-</code></pre>
-</div>
+<span class="nv">$ </span>kubectl apply <span class="nt">-f</span> bookkeeper.stateful.yaml
+</code></pre></div></div>
<p>You can check on the status of the Bookie pods for these components either in the Kubernetes Dashboard or using <code class="highlighter-rouge">kubectl</code>:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl get pods
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl get pods
+</code></pre></div></div>
<p>While all BookKeeper pods is Running, by zk-shell you could find all available bookies under /ledgers/</p>
<p>You could also run a <a href="https://github.com/ivankelly/bookkeeper-tutorial/">bookkeeper tutorial</a> instance, which named as ‘dice’ here, in this bookkeeper cluster.</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="nv">$</span>kubectl run -i --tty --attach dice --image<span class="o">=</span>caiok/bookkeeper-tutorial --env <span class="nv">ZOOKEEPER_SERVERS</span><span class="o">=</span><span class="s2">"zk-0.zookeeper"</span>
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$</span>kubectl run <span class="nt">-i</span> <span class="nt">--tty</span> <span class="nt">--attach</span> dice <span class="nt">--image</span><span class="o">=</span>caiok/bookkeeper-tutorial <span class="nt">--env</span> <span class="nv">ZOOKEEPER_SERVERS</span><span class="o">=</span><span class="s2">"zk-0.zookeeper"</span>
+</code></pre></div></div>
<p>An example output of Dice instance is like this:</p>
<pre><code class="language-aidl">➜ $ kubectl run -i --tty --attach dice --image=caiok/bookkeeper-tutorial --env ZOOKEEPER_SERVERS="zk-0.zookeeper"
@@ -619,24 +610,20 @@ Value = 2, epoch = 5, leading
<p>Delete Demo dice instance</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="nv">$</span>kubectl delete deployment dice
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$</span>kubectl delete deployment dice
+</code></pre></div></div>
<p>Delete BookKeeper</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl delete -f bookkeeper.yaml
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl delete <span class="nt">-f</span> bookkeeper.yaml
+</code></pre></div></div>
<p>Delete ZooKeeper</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl delete -f zookeeper.yaml
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl delete <span class="nt">-f</span> zookeeper.yaml
+</code></pre></div></div>
<p>Delete cluster</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>gcloud container clusters delete bookkeeper-gke-cluster
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>gcloud container clusters delete bookkeeper-gke-cluster
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.6.0/deployment/manual/index.html b/content/docs/4.6.0/deployment/manual/index.html
index 8e8bc3d..0d80ee5 100644
--- a/content/docs/4.6.0/deployment/manual/index.html
+++ b/content/docs/4.6.0/deployment/manual/index.html
@@ -472,9 +472,8 @@
<p>On each bookie host, you need to <a href="../../getting-started/installation#download">download</a> the BookKeeper package as a tarball. Once you’ve done that, you need to configure the bookie by setting values in the <code class="highlighter-rouge">bookkeeper-server/conf/bk_server.conf</code> config file. The one parameter that you will absolutely need to change is the <a href="../../config#zkServers"><code class="highlighter-rouge">zkServers</code></a> parameter, which you will need [...]
-<div class="language-properties highlighter-rouge"><pre class="highlight"><code><span class="py">zkServers</span><span class="p">=</span><span class="s">100.0.0.1:2181,100.0.0.2:2181,100.0.0.3:2181</span>
-</code></pre>
-</div>
+<div class="language-properties highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="py">zkServers</span><span class="p">=</span><span class="s">100.0.0.1:2181,100.0.0.2:2181,100.0.0.3:2181</span>
+</code></pre></div></div>
<blockquote>
<p>A full listing of configurable parameters available in <code class="highlighter-rouge">bookkeeper-server/conf/bk_server.conf</code> can be found in the <a href="../../reference/config">Configuration</a> reference manual.</p>
@@ -482,9 +481,8 @@
<p>Once the bookie’s configuration is set, you can start it up using the <a href="../../reference/cli#bookkeeper-bookie"><code class="highlighter-rouge">bookie</code></a> command of the <a href="../../reference/cli#bookkeeper"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<blockquote>
<p>You can also build BookKeeper <a href="../../getting-started/installation#clone">by cloning it from source</a> or <a href="../../getting-started/installation#build-using-maven">using Maven</a>.</p>
@@ -519,9 +517,8 @@
<p>Once you’ve started up a cluster of bookies, you need to set up cluster metadata for the cluster by running the following command from any bookie in the cluster:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
+</code></pre></div></div>
<p>You can run in the formatting</p>
diff --git a/content/docs/4.6.0/getting-started/concepts/index.html b/content/docs/4.6.0/getting-started/concepts/index.html
index 3cd39e1..932311e 100644
--- a/content/docs/4.6.0/getting-started/concepts/index.html
+++ b/content/docs/4.6.0/getting-started/concepts/index.html
@@ -679,10 +679,9 @@
<p>BookKeeper requires a ZooKeeper installation for storing <a href="#ledger">ledger</a> metadata. Whenever you construct a <a href="../../api/javadoc/org/apache/bookkeeper/client/BookKeeper"><code class="highlighter-rouge">BookKeeper</code></a> client object, you need to pass a list of ZooKeeper servers as a parameter to the constructor, like this:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">String</span> <span class="n">zkConnectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">String</span> <span class="n">zkConnectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>For more info on using the BookKeeper Java client, see <a href="../../api/ledger-api#the-java-ledger-api-client">this guide</a>.</p>
@@ -714,15 +713,13 @@
<p>The <em>hierarchical ledger manager</em>, implemented in the <a href="../../api/javadoc/org/apache/bookkeeper/meta/HierarchicalLedgerManager"><code class="highlighter-rouge">HierarchicalLedgerManager</code></a> class, first obtains a global unique ID from ZooKeeper using an <a href="https://zookeeper.apache.org/doc/current/api/org/apache/zookeeper/CreateMode.html#EPHEMERAL_SEQUENTIAL"><code class="highlighter-rouge">EPHEMERAL_SEQUENTIAL</code></a> znode. Since ZooKeeper’s sequence cou [...]
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="o">{</span>level1 <span class="o">(</span>2 digits<span class="o">)}{</span>level2 <span class="o">(</span>4 digits<span class="o">)}{</span>level3 <span class="o">(</span>4 digits<span class="o">)}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">{</span>level1 <span class="o">(</span>2 digits<span class="o">)}{</span>level2 <span class="o">(</span>4 digits<span class="o">)}{</span>level3 <span class="o">(</span>4 digits<span class="o">)}</span>
+</code></pre></div></div>
<p>These three parts are used to form the actual ledger node path to store ledger metadata:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="o">{</span>ledgers_root_path<span class="o">}</span>/<span class="o">{</span>level1<span class="o">}</span>/<span class="o">{</span>level2<span class="o">}</span>/L<span class="o">{</span>level3<span class="o">}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">{</span>ledgers_root_path<span class="o">}</span>/<span class="o">{</span>level1<span class="o">}</span>/<span class="o">{</span>level2<span class="o">}</span>/L<span class="o">{</span>level3<span class="o">}</span>
+</code></pre></div></div>
<p>For example, ledger 0000000001 is split into three parts, 00, 0000, and 00001, and stored in znode <code class="highlighter-rouge">/{ledgers_root_path}/00/0000/L0001</code>. Each znode could have as many 10,000 ledgers, which avoids the problem of the child list being larger than the maximum ZooKeeper packet size (which is the <a href="https://issues.apache.org/jira/browse/BOOKKEEPER-39">limitation</a> that initially prompted the creation of the hierarchical ledger manager).</p>
diff --git a/content/docs/4.6.0/getting-started/installation/index.html b/content/docs/4.6.0/getting-started/installation/index.html
index 7c15c38..af30e9f 100644
--- a/content/docs/4.6.0/getting-started/installation/index.html
+++ b/content/docs/4.6.0/getting-started/installation/index.html
@@ -470,31 +470,28 @@
<p>You can download Apache BookKeeper releases from one of many <a href="http://www.apache.org/dyn/closer.cgi/bookkeeper">Apache mirrors</a>. Here’s an example for the <a href="http://apache.claz.org/bookkeeper">apache.claz.org</a> mirror:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>curl -O http://apache.claz.org/bookkeeper/bookkeeper-4.6.1/bookkeeper-4.6.1-src.tar.gz
-<span class="gp">$ </span>tar xvf bookkeeper-4.6.1-src.tar.gz
-<span class="gp">$ </span><span class="nb">cd </span>bookkeeper-4.6.1
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-O</span> http://apache.claz.org/bookkeeper/bookkeeper-4.6.1/bookkeeper-4.6.1-src.tar.gz
+<span class="nv">$ </span><span class="nb">tar </span>xvf bookkeeper-4.6.1-src.tar.gz
+<span class="nv">$ </span><span class="nb">cd </span>bookkeeper-4.6.1
+</code></pre></div></div>
<h2 id="clone">Clone</h2>
<p>To build BookKeeper from source, clone the repository, either from the <a href="https://github.com/apache/bookkeeper">GitHub mirror</a> or from the <a href="http://git.apache.org/bookkeeper.git/">Apache repository</a>:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="c"># From the GitHub mirror</span>
-<span class="gp">$ </span>git clone https://github.com/apache/bookkeeper
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># From the GitHub mirror</span>
+<span class="nv">$ </span>git clone https://github.com/apache/bookkeeper
<span class="c"># From Apache directly</span>
-<span class="gp">$ </span>git clone git://git.apache.org/bookkeeper.git/
-</code></pre>
-</div>
+<span class="nv">$ </span>git clone git://git.apache.org/bookkeeper.git/
+</code></pre></div></div>
<h2 id="build-using-maven">Build using Maven</h2>
<p>Once you have the BookKeeper on your local machine, either by <a href="#download">downloading</a> or <a href="#clone">cloning</a> it, you can then build BookKeeper from source using Maven:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>mvn package
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>mvn package
+</code></pre></div></div>
<blockquote>
<p>You can skip tests by adding the <code class="highlighter-rouge">-DskipTests</code> flag when running <code class="highlighter-rouge">mvn package</code>.</p>
diff --git a/content/docs/4.6.0/getting-started/run-locally/index.html b/content/docs/4.6.0/getting-started/run-locally/index.html
index 37feaf9..a490250 100644
--- a/content/docs/4.6.0/getting-started/run-locally/index.html
+++ b/content/docs/4.6.0/getting-started/run-locally/index.html
@@ -459,9 +459,8 @@
<p>This would start up an ensemble with 10 bookies:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 10
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 10
+</code></pre></div></div>
<blockquote>
<p>When you start up an ensemble using <code class="highlighter-rouge">localbookie</code>, all bookies run in a single JVM process.</p>
diff --git a/content/docs/4.6.0/reference/cli/index.html b/content/docs/4.6.0/reference/cli/index.html
index aff18b1..9687d50 100644
--- a/content/docs/4.6.0/reference/cli/index.html
+++ b/content/docs/4.6.0/reference/cli/index.html
@@ -525,9 +525,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-localbookie">localbookie</h3>
@@ -536,9 +535,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie N
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie N
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-autorecovery">autorecovery</h3>
@@ -547,9 +545,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-upgrade">upgrade</h3>
@@ -558,9 +555,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-shell">shell</h3>
@@ -569,9 +565,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-help">help</h3>
@@ -580,9 +575,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper <span class="nb">help</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper <span class="nb">help</span>
+</code></pre></div></div>
<h2 id="the-bookkeeper-shell">The BookKeeper shell</h2>
@@ -592,10 +586,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -629,10 +622,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieFormat <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieFormat <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -671,9 +663,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieinfo
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieinfo
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -684,10 +675,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookiesanity <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookiesanity <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -721,9 +711,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell decommissionbookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell decommissionbookie
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -734,10 +723,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell deleteledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell deleteledger <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -771,9 +759,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell expandstorage
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell expandstorage
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -784,9 +771,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell <span class="nb">help</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell <span class="nb">help</span>
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -797,9 +783,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell lastmark
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell lastmark
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -810,10 +795,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell ledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell ledger <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -842,10 +826,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell ledgermetadata <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell ledgermetadata <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -874,10 +857,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listbookies <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listbookies <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -916,10 +898,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listfilesondisc <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listfilesondisc <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -958,10 +939,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listledgers <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listledgers <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -990,10 +970,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listunderreplicated <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listunderreplicated <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1027,10 +1006,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1064,10 +1042,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell lostbookierecoverydelay <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell lostbookierecoverydelay <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1101,10 +1078,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readjournal <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readjournal <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1138,10 +1114,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readledger <span class="se">\</span>
<ledger_id> <span class="o">[</span><start_entry_id> <span class="o">[</span><end_entry_id>]]
-</code></pre>
-</div>
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -1152,11 +1127,10 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readlog <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readlog <span class="se">\</span>
<entry_log_id | entry_log_file_name> <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1205,11 +1179,10 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
<bookieSrc> <span class="o">[</span><bookieDest>] <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1238,10 +1211,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell simpletest <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell simpletest <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1285,9 +1257,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell triggeraudit
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell triggeraudit
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -1298,10 +1269,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell updatecookie <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell updatecookie <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1330,10 +1300,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell updateledgers <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell updateledgers <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
diff --git a/content/docs/4.6.0/security/sasl/index.html b/content/docs/4.6.0/security/sasl/index.html
index 66afc49..fea2dde 100644
--- a/content/docs/4.6.0/security/sasl/index.html
+++ b/content/docs/4.6.0/security/sasl/index.html
@@ -467,24 +467,21 @@ by mechanism-specific details and wrap up with some operational details.</p>
<li>
<p>Pass the <code class="highlighter-rouge">JAAS</code> config file location as JVM parameter to each Bookie. For example:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
+</code></pre></div> </div>
</li>
<li>
<p>Enable SASL auth plugin in bookies, by setting <code class="highlighter-rouge">bookieAuthProviderFactoryClass</code> to <code class="highlighter-rouge">org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory</code>.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
+</code></pre></div> </div>
</li>
<li>
<p>If you are running <code class="highlighter-rouge">autorecovery</code> along with bookies, then you want to enable SASL auth plugin for <code class="highlighter-rouge">autorecovery</code>, by setting
<code class="highlighter-rouge">clientAuthProviderFactoryClass</code> to <code class="highlighter-rouge">org.apache.bookkeeper.sasl.SASLClientProviderFactory</code>.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
<li>Follow the steps in <a href="#kerberos">GSSAPI (Kerberos)</a> to configure SASL.</li>
</ol>
@@ -515,16 +512,14 @@ by mechanism-specific details and wrap up with some operational details.</p>
<li>
<p>Pass the <code class="highlighter-rouge">JAAS</code> config file location as JVM parameter to each client JVM. For example:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
+</code></pre></div> </div>
</li>
<li>
<p>Configure the following properties in bookkeeper <code class="highlighter-rouge">ClientConfiguration</code>:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
</ol>
@@ -550,10 +545,9 @@ for each Bookie in your cluster and for every operating system user that will ac
<p>If you have installed your own Kerberos, you will need to create these principals yourself using the following commands:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>sudo /usr/sbin/kadmin.local -q <span class="s1">'addprinc -randkey bookkeeper/{hostname}@{REALM}'</span>
-sudo /usr/sbin/kadmin.local -q <span class="s2">"ktadd -k /etc/security/keytabs/{keytabname}.keytab bookkeeper/{hostname}@{REALM}"</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo</span> /usr/sbin/kadmin.local <span class="nt">-q</span> <span class="s1">'addprinc -randkey bookkeeper/{hostname}@{REALM}'</span>
+<span class="nb">sudo</span> /usr/sbin/kadmin.local <span class="nt">-q</span> <span class="s2">"ktadd -k /etc/security/keytabs/{keytabname}.keytab bookkeeper/{hostname}@{REALM}"</span>
+</code></pre></div></div>
<h5 id="all-hosts-must-be-reachable-using-hostnames">All hosts must be reachable using hostnames</h5>
@@ -566,7 +560,7 @@ sudo /usr/sbin/kadmin.local -q <span class="s2">"ktadd -k /etc/security/keytabs/
<p>Add a suitably modified JAAS file similar to the one below to each Bookie’s config directory, let’s call it <code class="highlighter-rouge">bookie_jaas.conf</code>
for this example (note that each bookie should have its own keytab):</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> Bookie {
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> Bookie {
com.sun.security.auth.module.Krb5LoginModule required
useKeyTab=true
storeKey=true
@@ -589,8 +583,7 @@ for this example (note that each bookie should have its own keytab):</p>
keyTab="/etc/security/keytabs/bookie.keytab"
principal="bookkeeper/bk1.hostname.com@EXAMPLE.COM";
};
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>The <code class="highlighter-rouge">Bookie</code> section in the JAAS file tells the bookie which principal to use and the location of the keytab where this principal is stored.
It allows the bookie to login using the keytab specified in this section. See <a href="#notes">notes</a> for more details on Zookeeper’s SASL configuration.</p>
@@ -598,16 +591,14 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Pass the name of the JAAS file as a JVM parameter to each Bookie:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
+</code></pre></div> </div>
<p>You may also wish to specify the path to the <code class="highlighter-rouge">krb5.conf</code> file
(see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">JDK’s Kerberos Requirements</a> for more details):</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
+</code></pre></div> </div>
</li>
<li>
<p>Make sure the keytabs configured in the JAAS file are readable by the operating system user who is starting the Bookies.</p>
@@ -615,11 +606,10 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Enable SASL authentication plugin in the bookies by setting following parameters.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
<span class="c"># if you run `autorecovery` along with bookies</span>
<span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
</ol>
@@ -634,29 +624,26 @@ for this example (note that each bookie should have its own keytab):</p>
how the clients like writers and readers can connect to the Bookies. The following is an example configuration for a client using
a keytab (recommended for long-running processes):</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> BookKeeper {
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> BookKeeper {
com.sun.security.auth.module.Krb5LoginModule required
useKeyTab=true
storeKey=true
keyTab="/etc/security/keytabs/bookkeeper.keytab"
principal="bookkeeper-client-1@EXAMPLE.COM";
};
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Pass the name of the JAAS file as a JVM parameter to the client JVM:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
+</code></pre></div> </div>
<p>You may also wish to specify the path to the <code class="highlighter-rouge">krb5.conf</code> file (see
<a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">JDK’s Kerberos Requirements</a> for more details).</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
+</code></pre></div> </div>
</li>
<li>
<p>Make sure the keytabs configured in the <code class="highlighter-rouge">bookkeeper_jaas.conf</code> are readable by the operating system user who is starting bookkeeper client.</p>
@@ -664,9 +651,8 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Enable SASL authentication plugin in the client by setting following parameters.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
</ol>
diff --git a/content/docs/4.6.0/security/tls/index.html b/content/docs/4.6.0/security/tls/index.html
index c1d5a3c..5dbbc8c 100644
--- a/content/docs/4.6.0/security/tls/index.html
+++ b/content/docs/4.6.0/security/tls/index.html
@@ -481,9 +481,8 @@ In (2), with a CA, the bookie or client will trust any certificate that was sign
You can use Java’s <code class="highlighter-rouge">keytool</code> utility to accomplish this task. We will generate the key into a temporary keystore
initially so that we can export and sign it later with CA.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias localhost -validity <span class="o">{</span>validity<span class="o">}</span> -genkey
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-validity</span> <span class="o">{</span>validity<span class="o">}</span> <span class="nt">-genkey</span>
+</code></pre></div></div>
<p>You need to specify two parameters in the above command:</p>
@@ -510,25 +509,22 @@ to ensure the passport is authentic. Similarly, the CA signs the certificates, a
certificate is computationally difficult to forge. Thus, as long as the CA is a genuine and trusted authority, the clients have
high assurance that they are connecting to the authentic machines.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl req -new -x509 -keyout ca-key -out ca-cert -days 365
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl req <span class="nt">-new</span> <span class="nt">-x509</span> <span class="nt">-keyout</span> ca-key <span class="nt">-out</span> ca-cert <span class="nt">-days</span> 365
+</code></pre></div></div>
<p>The generated CA is simply a <em>public-private</em> key pair and certificate, and it is intended to sign other certificates.</p>
<p>The next step is to add the generated CA to the clients’ truststore so that the clients can trust this CA:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.truststore.jks -alias CARoot -import -file ca-cert
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.truststore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+</code></pre></div></div>
<p>NOTE: If you configure the bookies to require client authentication by setting <code class="highlighter-rouge">sslClientAuthentication</code> to <code class="highlighter-rouge">true</code> on the
<a href="../../reference/config">bookie config</a>, then you must also provide a truststore for the bookies and it should have all the CA
certificates that clients keys were signed by.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore client.truststore.jks -alias CARoot -import -file ca-cert
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> client.truststore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+</code></pre></div></div>
<p>In contrast to the keystore, which stores each machine’s own identity, the truststore of a client stores all the certificates
that the client should trust. Importing a certificate into one’s truststore also means trusting all certificates that are signed
@@ -541,22 +537,19 @@ That way all machines can authenticate all other machines.</p>
<p>The next step is to sign all certificates in the keystore with the CA we generated. First, you need to export the certificate from the keystore:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias localhost -certreq -file cert-file
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-certreq</span> <span class="nt">-file</span> cert-file
+</code></pre></div></div>
<p>Then sign it with the CA:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl x509 -req -CA ca-cert -CAkey ca-key -in cert-file -out cert-signed -days <span class="o">{</span>validity<span class="o">}</span> -CAcreateserial -passin pass:<span class="o">{</span>ca-password<span class="o">}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl x509 <span class="nt">-req</span> <span class="nt">-CA</span> ca-cert <span class="nt">-CAkey</span> ca-key <span class="nt">-in</span> cert-file <span class="nt">-out</span> cert-signed <span class="nt">-days</span> <span class="o">{</span>validity<span class="o">}</span> <span class="nt">-CAcreateserial</span> <span class="nt">-passin</span> pass:<span class="o">{</span>ca-password [...]
+</code></pre></div></div>
<p>Finally, you need to import both the certificate of the CA and the signed certificate into the keystore:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias CARoot -import -file ca-cert
-keytool -keystore bookie.keystore.jks -alias localhost -import -file cert-signed
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-import</span> <span class="nt">-file</span> cert-signed
+</code></pre></div></div>
<p>The definitions of the parameters are the following:</p>
@@ -585,7 +578,7 @@ netty bindings to leverage installed OpenSSL.</p>
<p>The following TLS configs are needed on the bookie side:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
<span class="c"># key store</span>
<span class="nv">tlsKeyStoreType</span><span class="o">=</span>JKS
<span class="nv">tlsKeyStore</span><span class="o">=</span>/var/private/tls/bookie.keystore.jks
@@ -594,8 +587,7 @@ netty bindings to leverage installed OpenSSL.</p>
<span class="nv">tlsTrustStoreType</span><span class="o">=</span>JKS
<span class="nv">tlsTrustStore</span><span class="o">=</span>/var/private/tls/bookie.truststore.jks
<span class="nv">tlsTrustStorePasswordPath</span><span class="o">=</span>/var/private/tls/bookie.truststore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>NOTE: it is important to restrict access to the store files and corresponding password files via filesystem permissions.</p>
@@ -614,19 +606,17 @@ netty bindings to leverage installed OpenSSL.</p>
<p>To verify the bookie’s keystore and truststore are setup correctly you can run the following command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl s_client -debug -connect localhost:3181 -tls1
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl s_client <span class="nt">-debug</span> <span class="nt">-connect</span> localhost:3181 <span class="nt">-tls1</span>
+</code></pre></div></div>
<p>NOTE: TLSv1 should be listed under <code class="highlighter-rouge">tlsEnabledProtocols</code>.</p>
<p>In the output of this command you should see the server’s certificate:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>-----BEGIN CERTIFICATE-----
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">-----BEGIN</span> CERTIFICATE-----
<span class="o">{</span>variable sized random bytes<span class="o">}</span>
------END CERTIFICATE-----
-</code></pre>
-</div>
+<span class="nt">-----END</span> CERTIFICATE-----
+</code></pre></div></div>
<p>If the certificate does not show up or if there are any other error messages then your keystore is not setup correctly.</p>
@@ -637,11 +627,10 @@ supported. The configs for TLS will be the same as bookies.</p>
<p>If client authentication is not required by the bookies, the following is a minimal configuration example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
<span class="nv">clientTrustStore</span><span class="o">=</span>/var/private/tls/client.truststore.jks
<span class="nv">clientTrustStorePasswordPath</span><span class="o">=</span>/var/private/tls/client.truststore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If client authentication is required, then a keystore must be created for each client, and the bookies’ truststores must
trust the certificate in the client’s keystore. This may be done using commands that are similar to what we used for
@@ -649,11 +638,10 @@ the <a href="#bookie-keystore">bookie keystore</a>.</p>
<p>And the following must also be configured:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsClientAuthentication</span><span class="o">=</span><span class="nb">true
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsClientAuthentication</span><span class="o">=</span><span class="nb">true
</span><span class="nv">clientKeyStore</span><span class="o">=</span>/var/private/tls/client.keystore.jks
<span class="nv">clientKeyStorePasswordPath</span><span class="o">=</span>/var/private/tls/client.keystore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>NOTE: it is important to restrict access to the store files and corresponding password files via filesystem permissions.</p>
@@ -663,9 +651,8 @@ the <a href="#bookie-keystore">bookie keystore</a>.</p>
<p>You can enable TLS debug logging at the JVM level by starting the bookies and/or clients with <code class="highlighter-rouge">javax.net.debug</code> system property. For example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>-Djavax.net.debug<span class="o">=</span>all
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">-Djavax</span>.net.debug<span class="o">=</span>all
+</code></pre></div></div>
<p>You can find more details on this in <a href="http://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/ReadDebug.html">Oracle documentation</a> on
<a href="http://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/ReadDebug.html">debugging SSL/TLS connections</a>.</p>
diff --git a/content/docs/4.6.1/admin/autorecovery/index.html b/content/docs/4.6.1/admin/autorecovery/index.html
index 1d0c1b0..c298b9a 100644
--- a/content/docs/4.6.1/admin/autorecovery/index.html
+++ b/content/docs/4.6.1/admin/autorecovery/index.html
@@ -474,20 +474,18 @@
<p>Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="c"># IP and port for the failed bookie</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If you wish, you can also specify which bookie you’d like to rereplicate to. Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="se">\ </span> <span class="c"># IP and port for the failed bookie</span>
192.168.1.11:3181 <span class="c"># IP and port for the bookie to rereplicate to</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="the-manual-recovery-process">The manual recovery process</h3>
@@ -520,9 +518,8 @@
<p>You can start up AutoRecovery using the <a href="../../reference/cli#bookkeeper-autorecovery"><code class="highlighter-rouge">autorecovery</code></a> command of the <a href="../../reference/cli"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool.</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
+</code></pre></div></div>
<blockquote>
<p>The most important thing to ensure when starting up AutoRecovery is that the ZooKeeper connection string specified by the <a href="../../reference/config#zkServers"><code class="highlighter-rouge">zkServers</code></a> parameter points to the right ZooKeeper cluster.</p>
@@ -542,15 +539,13 @@
<p>You can disable AutoRecover using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -disable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-disable</span>
+</code></pre></div></div>
<p>Once disabled, you can reenable AutoRecovery using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">enable</code></a> shell command:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -enable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-enable</span>
+</code></pre></div></div>
<h2 id="autorecovery-architecture">AutoRecovery architecture</h2>
diff --git a/content/docs/4.6.1/admin/bookies/index.html b/content/docs/4.6.1/admin/bookies/index.html
index 2bdc6ee..500e93d 100644
--- a/content/docs/4.6.1/admin/bookies/index.html
+++ b/content/docs/4.6.1/admin/bookies/index.html
@@ -484,15 +484,13 @@
<p>To start a bookie in the foreground, use the <a href="../../reference/cli#bookkeeper-bookie"><code class="highlighter-rouge">bookie</code></a> command of the <a href="../../reference/cli#bookkeeper"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>To start a bookie in the background, use the <a href="../../reference/cli#bookkeeper-daemon.sh"><code class="highlighter-rouge">bookkeeper-daemon.sh</code></a> script and run <code class="highlighter-rouge">start bookie</code>:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
+</code></pre></div></div>
<h3 id="local-bookies">Local bookies</h3>
@@ -500,9 +498,8 @@
<p>This would spin up a local ensemble of 6 bookies:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
+</code></pre></div></div>
<blockquote>
<p>When you run a local bookie ensemble, all bookies run in a single JVM process.</p>
@@ -556,18 +553,16 @@
<p>To enable logging for a bookie, create a <code class="highlighter-rouge">log4j.properties</code> file and point the <code class="highlighter-rouge">BOOKIE_LOG_CONF</code> environment variable to the configuration file. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
-<span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
+<span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<h2 id="upgrading">Upgrading</h2>
<p>From time to time you may need to make changes to the filesystem layout of bookies—changes that are incompatible with previous versions of BookKeeper and require that directories used with previous versions are upgraded. If a filesystem upgrade is required when updating BookKeeper, the bookie will fail to start and return an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
+</code></pre></div></div>
<p>BookKeeper provides a utility for upgrading the filesystem. You can perform an upgrade using the <a href="../../reference/cli#bookkeeper-upgrade"><code class="highlighter-rouge">upgrade</code></a> command of the <code class="highlighter-rouge">bookkeeper</code> CLI tool. When running <code class="highlighter-rouge">bookkeeper upgrade</code> you need to specify one of three flags:</p>
@@ -598,27 +593,23 @@
<p>A standard upgrade pattern is to run an upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --upgrade
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--upgrade</span>
+</code></pre></div></div>
<p>…then check that everything is working normally, then kill the bookie. If everything is okay, finalize the upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --finalize
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--finalize</span>
+</code></pre></div></div>
<p>…and then restart the server:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>If something has gone wrong, you can always perform a rollback:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --rollback
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--rollback</span>
+</code></pre></div></div>
<h2 id="formatting">Formatting</h2>
@@ -626,15 +617,13 @@
<p>By default, formatting is done in interactive mode, which prompts you to confirm the format operation if old data exists. You can disable confirmation using the <code class="highlighter-rouge">-nonInteractive</code> flag. If old data does exist, the format operation will abort <em>unless</em> you set the <code class="highlighter-rouge">-force</code> flag. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
+</code></pre></div></div>
<p>You can format the local filesystem data on a bookie using the <a href="../../reference/cli#bookkeeper-shell-bookieformat"><code class="highlighter-rouge">bookieformat</code></a> command on each bookie. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
+</code></pre></div></div>
<blockquote>
<p>The <code class="highlighter-rouge">-force</code> and <code class="highlighter-rouge">-nonInteractive</code> flags are also available for the <code class="highlighter-rouge">bookieformat</code> command.</p>
@@ -648,13 +637,12 @@
<p>Accidentally replacing disks or removing directories can cause a bookie to fail while trying to read a ledger fragment that, according to the ledger metadata, exists on the bookie. For this reason, when a bookie is started for the first time, its disk configuration is fixed for the lifetime of that bookie. Any change to its disk configuration, such as a crashed disk or an accidental configuration change, will result in the bookie being unable to start. That will throw an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
.......at org.apache.bookkeeper.bookie.Cookie.verify(Cookie.java:82)
.......at org.apache.bookkeeper.bookie.Bookie.checkEnvironment(Bookie.java:275)
.......at org.apache.bookkeeper.bookie.Bookie.<init>(Bookie.java:351)
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If the change was the result of an accidental configuration change, the change can be reverted and the bookie can be restarted. However, if the change <em>cannot</em> be reverted, such as is the case when you want to add a new disk or replace a disk, the bookie must be wiped and then all its data re-replicated onto it.</p>
@@ -665,21 +653,19 @@ org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
<li>
<p>Run the following command to re-replicate the data:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
<zkserver> <span class="se">\</span>
<oldbookie> <span class="se">\</span>
<newbookie>
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>The ZooKeeper server, old bookie, and new bookie, are all identified by their external IP and <code class="highlighter-rouge">bookiePort</code> (3181 by default). Here’s an example:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
zk1.example.com <span class="se">\</span>
192.168.1.10:3181 <span class="se">\</span>
192.168.1.10:3181
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>See the <a href="../autorecovery">AutoRecovery</a> documentation for more info on the re-replication process.</p>
</li>
diff --git a/content/docs/4.6.1/admin/http/index.html b/content/docs/4.6.1/admin/http/index.html
index 00d428d..af32187 100644
--- a/content/docs/4.6.1/admin/http/index.html
+++ b/content/docs/4.6.1/admin/http/index.html
@@ -560,12 +560,11 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
</table>
</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"configName1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"configName2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue2"</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"configName1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"configName2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue2"</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Response:</p>
@@ -712,13 +711,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"ledgerId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata2"</span><span class="p">,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ledgerId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata2"</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="err">}</span><span class="w">
-</span></code></pre>
- </div>
+ </span><span class="p">}</span><span class="w">
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -780,11 +778,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -858,13 +855,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"entryId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"entryId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 2"</span><span class="p">,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"entryId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entryId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 2"</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="err">}</span><span class="w">
-</span></code></pre>
- </div>
+ </span><span class="p">}</span><span class="w">
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -934,13 +930,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookieSocketAddress1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"bookieSocketAddress2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname2"</span><span class="p">,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookieSocketAddress1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"bookieSocketAddress2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname2"</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="err">}</span><span class="w">
-</span></code></pre>
- </div>
+ </span><span class="p">}</span><span class="w">
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -980,14 +975,13 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free:</span><span class="w"> </span><span class="err">xxx,</span><span class="w"> </span><span class="err">total:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
- </span><span class="nt">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free:</span><span class="w"> </span><span class="err">xxx,</span><span class="w"> </span><span class="err">total:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">,</span><span class="w"> </span><span class="err">total</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
+ </span><span class="s2">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">,</span><span class="w"> </span><span class="err">total</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="nt">"clusterInfo"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">total_free:</span><span class="w"> </span><span class="err">xxx,</span><span class="w"> </span><span class="err">total:</span><span class="w"> </span><span class="err">xxx</span><span class="p">}</span><span class="w">
+ </span><span class="s2">"clusterInfo"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">total_free</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">,</span><span class="w"> </span><span class="err">total</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1027,13 +1021,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="err">JournalId1</span><span class="w"> </span><span class="err">:</span><span class="w"> </span><span class="err">position1,</span><span class="w">
- </span><span class="err">JournalId2</span><span class="w"> </span><span class="err">:</span><span class="w"> </span><span class="err">position2,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="err">JournalId</span><span class="mi">1</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="err">position</span><span class="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="err">JournalId</span><span class="mi">2</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="err">position</span><span class="mi">2</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1095,13 +1088,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"journal files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="p">,</span><span class="w">
- </span><span class="nt">"entrylog files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2..."</span><span class="p">,</span><span class="w">
- </span><span class="nt">"index files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"journal files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entrylog files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2..."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"index files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1150,13 +1142,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<ul>
<li>Description: Ledger data recovery for failed bookie</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_src1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_src2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
- </span><span class="nt">"bookie_dest"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_dest1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_dest2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
- </span><span class="nt">"delete_cookie"</span><span class="p">:</span><span class="w"> </span><span class="err"><bool_value></span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_src1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_src2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"bookie_dest"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_dest1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_dest2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"delete_cookie"</span><span class="p">:</span><span class="w"> </span><span class="err"><bool_value></span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Parameters:</p>
@@ -1284,11 +1275,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="err">[ledgerId1,</span><span class="w"> </span><span class="err">ledgerId2...]</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="p">[</span><span class="err">ledgerId</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="err">ledgerId</span><span class="mi">2</span><span class="err">...</span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1328,11 +1318,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"Auditor"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname/hostAddress:Port"</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"Auditor"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname/hostAddress:Port"</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1410,11 +1399,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<ul>
<li>Description: Set lostBookieRecoveryDelay value in seconds.</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"delay_seconds"</span><span class="p">:</span><span class="w"> </span><span class="err"><delay_seconds></span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"delay_seconds"</span><span class="p">:</span><span class="w"> </span><span class="err"><delay_seconds></span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Parameters:</p>
@@ -1474,11 +1462,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<ul>
<li>Description: Decommission Bookie, Force trigger Audit task and make sure all the ledgers stored in the decommissioning bookie are replicated.</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="err"><bookie_src></span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="err"><bookie_src></span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Parameters:</p>
diff --git a/content/docs/4.6.1/api/ledger-adv-api/index.html b/content/docs/4.6.1/api/ledger-adv-api/index.html
index ed979d3..1121009 100644
--- a/content/docs/4.6.1/api/ledger-adv-api/index.html
+++ b/content/docs/4.6.1/api/ledger-adv-api/index.html
@@ -471,17 +471,16 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<p>Here’s an exmaple:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You can also create advanced ledgers asynchronously.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">createComplete</span><span class="o">(</span><span class="kt">int</span> <span class="n">returnCode</span><span class="o">,</span> <span class="n">LedgerHandle</span> <span class="n">handle</span><span class="o">,</span> <span class="n">Object</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Ledger successfully created"</span><span class="o">);</span>
<span class="o">}</span>
@@ -495,12 +494,11 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="k">new</span> <span class="nf">LedgerCreationCallback</span><span class="o">(),</span>
<span class="s">"some context"</span>
<span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Besides the APIs above, BookKeeper allows users providing <code class="highlighter-rouge">ledger-id</code> when creating advanced ledgers.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
@@ -508,8 +506,7 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>Please note, it is users’ responsibility to provide a unique ledger id when using the API above.
@@ -522,11 +519,10 @@ a <a href="../javadoc/org/apache/bookkeeper/client/BKException.BKLedgerExistExce
<p>The normal <a href="ledger-api/#adding-entries-to-ledgers">add entries api</a> in advanced ledgers are disabled. Instead, when users want to add entries
to advanced ledgers, an entry id is required to pass in along with the entry data when adding an entry.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
<span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="n">entryId</span><span class="o">,</span> <span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>A few notes when using this API:</p>
diff --git a/content/docs/4.6.1/api/ledger-api/index.html b/content/docs/4.6.1/api/ledger-api/index.html
index 58aebf3..8830632 100644
--- a/content/docs/4.6.1/api/ledger-api/index.html
+++ b/content/docs/4.6.1/api/ledger-api/index.html
@@ -473,7 +473,7 @@
<p>If you’re using <a href="https://maven.apache.org/">Maven</a>, add this to your <a href="https://maven.apache.org/guides/introduction/introduction-to-the-pom.html"><code class="highlighter-rouge">pom.xml</code></a> build configuration file:</p>
-<div class="language-xml highlighter-rouge"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
<span class="nt"><bookkeeper.version></span>4.6.1<span class="nt"></bookkeeper.version></span>
<span class="c"><!-- in your <dependencies> block --></span>
@@ -482,8 +482,7 @@
<span class="nt"><artifactId></span>bookkeeper-server<span class="nt"></artifactId></span>
<span class="nt"><version></span>${bookkeeper.version}<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>BookKeeper uses google <a href="https://github.com/google/protobuf/tree/master/java">protobuf</a> and <a href="https://github.com/google/guava">guava</a> libraries
a lot. If your application might include different versions of protobuf or guava introduced by other dependencies, you can choose to use the
@@ -493,7 +492,7 @@ shaded library, which relocate classes of protobuf and guava into a different na
a dependency-reduced pom file for shaded artifact using <a href="https://maven.apache.org/plugins/maven-shade-plugin/examples/attached-artifact.html">shadedArtifactAttached</a>. You need to manually to exclude relocated packages when using the shaded artifact. Full example of how to use this is
showed as below.</p>
-<div class="language-xml highlighter-rouge"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
<span class="nt"><bookkeeper.version></span>4.6.1<span class="nt"></bookkeeper.version></span>
<span class="c"><!-- in your <dependencies> block --></span>
@@ -513,12 +512,11 @@ showed as below.</p>
<span class="nt"></exclusion></span>
<span class="nt"></exclusions></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Or you can use a separate shaded artifact <code class="highlighter-rouge">bookkeeper-server-shaded</code>.</p>
-<div class="language-xml highlighter-rouge"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
<span class="nt"><bookkeeper.version></span>4.6.1<span class="nt"></bookkeeper.version></span>
<span class="c"><!-- in your <dependencies> block --></span>
@@ -527,14 +525,13 @@ showed as below.</p>
<span class="nt"><artifactId></span>bookkeeper-server-shaded<span class="nt"></artifactId></span>
<span class="nt"><version></span>${bookkeeper.version}<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="gradle">Gradle</h3>
<p>If you’re using <a href="https://gradle.org/">Gradle</a>, add this to your <a href="https://spring.io/guides/gs/gradle/"><code class="highlighter-rouge">build.gradle</code></a> build configuration file:</p>
-<div class="language-groovy highlighter-rouge"><pre class="highlight"><code><span class="n">dependencies</span> <span class="o">{</span>
+<div class="language-groovy highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="nl">group:</span> <span class="s1">'org.apache.bookkeeper'</span><span class="o">,</span> <span class="nl">name:</span> <span class="s1">'bookkeeper-server'</span><span class="o">,</span> <span class="nl">version:</span> <span class="s1">'4.6.1'</span>
<span class="o">}</span>
@@ -542,12 +539,11 @@ showed as below.</p>
<span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="s1">'org.apache.bookkeeper:bookkeeper-server:4.6.1'</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Similarly as using maven, you can also configure to use the shaded jars.</p>
-<div class="language-groovy highlighter-rouge"><pre class="highlight"><code><span class="c1">// use the shaded artifact of `bookkeeper-server` jar</span>
+<div class="language-groovy highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// use the shaded artifact of `bookkeeper-server` jar</span>
<span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="o">(</span><span class="s1">'org.apache.bookkeeper:bookkeeper-server::shaded'</span><span class="o">)</span> <span class="o">{</span>
<span class="n">exclude</span> <span class="nl">group:</span> <span class="s1">'org.apache.bookkeeper'</span><span class="o">,</span> <span class="nl">module:</span> <span class="err">"</span><span class="n">bookkeeper</span><span class="o">-</span><span class="n">common</span><span class="err">'</span>
@@ -560,8 +556,7 @@ showed as below.</p>
<span class="n">dependencies</span> <span class="o">{</span>
<span class="n">compile</span> <span class="s1">'org.apache.bookkeeper:bookkeeper-server-shaded:'</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="connection-string">Connection string</h2>
@@ -577,14 +572,13 @@ showed as below.</p>
<p>In order to create a new <a href="../javadoc/org/apache/bookkeeper/client/BookKeeper"><code class="highlighter-rouge">BookKeeper</code></a> client object, you need to pass in a <a href="#connection-string">connection string</a>. Here is an example client object using a ZooKeeper connection string:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="k">try</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">try</span> <span class="o">{</span>
<span class="n">String</span> <span class="n">connectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span> <span class="c1">// For a single-node, local ZooKeeper cluster</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">connectionString</span><span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">InterruptedException</span> <span class="o">|</span> <span class="n">IOException</span> <span class="o">|</span> <span class="n">KeeperException</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
<span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>If you’re running BookKeeper <a href="../../getting-started/run-locally">locally</a>, using the <a href="../../reference/cli#bookkeeper-localbookie"><code class="highlighter-rouge">localbookie</code></a> command, use <code class="highlighter-rouge">"127.0.0.1:2181"</code> for your connection string, as in the example above.</p>
@@ -596,29 +590,26 @@ showed as below.</p>
<li>
<p>By passing in a <a href="../javadoc/org/apache/bookkeeper/conf/ClientConfiguration"><code class="highlighter-rouge">ClientConfiguration</code></a> object. Here’s an example:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">config</span><span class="o">.</span><span class="na">setZkServers</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
<span class="n">config</span><span class="o">.</span><span class="na">setAddEntryTimeout</span><span class="o">(</span><span class="mi">2000</span><span class="o">);</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">config</span><span class="o">);</span>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>By specifying a <code class="highlighter-rouge">ClientConfiguration</code> and a <a href="http://zookeeper.apache.org/doc/current/api/org/apache/zookeeper/ZooKeeper.html"><code class="highlighter-rouge">ZooKeeper</code></a> client object:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ClientConfiguration</span> <span class="n">config</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">config</span><span class="o">.</span><span class="na">setAddEntryTimeout</span><span class="o">(</span><span class="mi">5000</span><span class="o">);</span>
<span class="n">ZooKeeper</span> <span class="n">zkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ZooKeeper</span><span class="o">(</span><span class="cm">/* client args */</span><span class="o">);</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">config</span><span class="o">,</span> <span class="n">zkClient</span><span class="o">);</span>
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Using the <code class="highlighter-rouge">forConfig</code> method:</p>
- <div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="n">BookKeeper</span><span class="o">.</span><span class="na">forConfig</span><span class="o">(</span><span class="n">conf</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
- </div>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="n">BookKeeper</span><span class="o">.</span><span class="na">forConfig</span><span class="o">(</span><span class="n">conf</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
+</code></pre></div> </div>
</li>
</ul>
@@ -628,16 +619,15 @@ showed as below.</p>
<p>Here’s an example:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandle</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedger</span><span class="o">(</span><span class="n">BookKeeper</span><span class="o">.</span><span class="na">DigestType</span><span class="o">.</span><span class="na">MAC</span><span class="o">,</span> <span class="n">password</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You can also create ledgers asynchronously</p>
<h3 id="create-ledgers-asynchronously">Create ledgers asynchronously</h3>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">createComplete</span><span class="o">(</span><span class="kt">int</span> <span class="n">returnCode</span><span class="o">,</span> <span class="n">LedgerHandle</span> <span class="n">handle</span><span class="o">,</span> <span class="n">Object</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Ledger successfully created"</span><span class="o">);</span>
<span class="o">}</span>
@@ -651,34 +641,30 @@ showed as below.</p>
<span class="k">new</span> <span class="nf">LedgerCreationCallback</span><span class="o">(),</span>
<span class="s">"some context"</span>
<span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="adding-entries-to-ledgers">Adding entries to ledgers</h2>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
+</code></pre></div></div>
<h3 id="add-entries-asynchronously">Add entries asynchronously</h3>
<h2 id="reading-entries-from-ledgers">Reading entries from ledgers</h2>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span> <span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">1</span><span class="o">,</span> <span class="mi">99</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span> <span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">1</span><span class="o">,</span> <span class="mi">99</span><span class="o">);</span>
+</code></pre></div></div>
<p>To read all possible entries from the ledger:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
<span class="n">handle</span><span class="o">.</span><span class="na">readEntries</span><span class="o">(</span><span class="mi">0</span><span class="o">,</span> <span class="n">handle</span><span class="o">.</span><span class="na">getLastAddConfirmed</span><span class="o">());</span>
<span class="k">while</span> <span class="o">(</span><span class="n">entries</span><span class="o">.</span><span class="na">hasNextElement</span><span class="o">())</span> <span class="o">{</span>
<span class="n">LedgerEntry</span> <span class="n">entry</span> <span class="o">=</span> <span class="n">entries</span><span class="o">.</span><span class="na">nextElement</span><span class="o">();</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Successfully read entry "</span> <span class="o">+</span> <span class="n">entry</span><span class="o">.</span><span class="na">getId</span><span class="o">());</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="reading-entries-after-the-lastaddconfirmed-range">Reading entries after the LastAddConfirmed range</h3>
@@ -688,29 +674,27 @@ For entries which are within the range 0..LastAddConfirmed BookKeeper guarantees
For entries outside that range it is possible that the writer never received the acknowledge and so there is the risk that the reader is seeing entries before the writer and this could result in a consistency issue in some cases.
With this method you can even read entries before the LastAddConfirmed and entries after it with one call, the expected consistency will be as described above.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Enumerator</span><span class="o"><</span><span class="n">LedgerEntry</span><span class="o">></span> <span class="n">entries</span> <span class="o">=</span>
<span class="n">handle</span><span class="o">.</span><span class="na">readUnconfirmedEntries</span><span class="o">(</span><span class="mi">0</span><span class="o">,</span> <span class="n">lastEntryIdExpectedToRead</span><span class="o">);</span>
<span class="k">while</span> <span class="o">(</span><span class="n">entries</span><span class="o">.</span><span class="na">hasNextElement</span><span class="o">())</span> <span class="o">{</span>
<span class="n">LedgerEntry</span> <span class="n">entry</span> <span class="o">=</span> <span class="n">entries</span><span class="o">.</span><span class="na">nextElement</span><span class="o">();</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Successfully read entry "</span> <span class="o">+</span> <span class="n">entry</span><span class="o">.</span><span class="na">getId</span><span class="o">());</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="deleting-ledgers">Deleting ledgers</h2>
<p><span class="pop" id="ledger-popover">Ledgers</span> can also be deleted synchronously or asynchronously.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="mi">1234</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="mi">1234</span><span class="o">;</span>
<span class="k">try</span> <span class="o">{</span>
<span class="n">bkClient</span><span class="o">.</span><span class="na">deleteLedger</span><span class="o">(</span><span class="n">ledgerId</span><span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">Exception</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
<span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="delete-entries-asynchronously">Delete entries asynchronously</h3>
@@ -718,13 +702,12 @@ With this method you can even read entries before the LastAddConfirmed and entri
<p>*</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">DeleteEntryCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">DeleteCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">DeleteEntryCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">DeleteCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">deleteComplete</span><span class="o">()</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Delete completed"</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="simple-example">Simple example</h2>
@@ -742,7 +725,7 @@ With this method you can even read entries before the LastAddConfirmed and entri
<li>reads all available entries</li>
</ul>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="c1">// Create a client object for the local ensemble. This</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// Create a client object for the local ensemble. This</span>
<span class="c1">// operation throws multiple exceptions, so make sure to</span>
<span class="c1">// use a try/catch block when instantiating client objects.</span>
<span class="n">BookKeeper</span> <span class="n">bkc</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"localhost:2181"</span><span class="o">);</span>
@@ -784,17 +767,15 @@ With this method you can even read entries before the LastAddConfirmed and entri
<span class="c1">// Close the ledger and the client</span>
<span class="n">lh</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
<span class="n">bkc</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Running this should return this output:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>Result: 0
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Result: 0
Result: 1
Result: 2
<span class="c"># etc</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="example-application">Example application</h2>
@@ -810,9 +791,8 @@ Result: 2
<p>To start up a cluster consisting of six <span class="pop" id="bookie-popover">bookies</span> locally:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
+</code></pre></div></div>
<p>You can specify a different number of bookies if you’d like.</p>
@@ -830,15 +810,14 @@ Result: 2
<p>To begin, download the base application, compile and run it.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>git clone https://github.com/ivankelly/bookkeeper-tutorial.git
-<span class="gp">$ </span>mvn package
-<span class="gp">$ </span>mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>git clone https://github.com/ivankelly/bookkeeper-tutorial.git
+<span class="nv">$ </span>mvn package
+<span class="nv">$ </span>mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+</code></pre></div></div>
<p>That should yield output that looks something like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>[INFO] Scanning for projects...
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building tutorial 1.0-SNAPSHOT
@@ -849,14 +828,13 @@ Result: 2
Value = 4
Value = 5
Value = 3
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="the-base-application">The base application</h3>
<p>The application in this tutorial is a dice application. The <code class="highlighter-rouge">Dice</code> class below has a <code class="highlighter-rouge">playDice</code> function that generates a random number between 1 and 6 every second, prints the value of the dice roll, and runs indefinitely.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
<span class="n">Random</span> <span class="n">r</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Random</span><span class="o">();</span>
<span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
@@ -866,12 +844,11 @@ Value = 3
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>When you run the <code class="highlighter-rouge">main</code> function of this class, a new <code class="highlighter-rouge">Dice</code> object will be instantiated and then run indefinitely:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="o">{</span>
<span class="c1">// other methods</span>
<span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
@@ -879,8 +856,7 @@ Value = 3
<span class="n">d</span><span class="o">.</span><span class="na">playDice</span><span class="o">();</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="leaders-and-followers-and-a-bit-of-background">Leaders and followers (and a bit of background)</h3>
@@ -908,7 +884,7 @@ Value = 3
<p>We’ll use zookeeper to elect a leader. A zookeeper instance will have started locally when you started the localbookie application above. To verify it’s running, run the following command.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span><span class="nb">echo </span>stat | nc localhost 2181
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">echo stat</span> | nc localhost 2181
Zookeeper version: 3.4.6-1569965, built on 02/20/2014 09:09 GMT
Clients:
/127.0.0.1:59343[1]<span class="o">(</span><span class="nv">queued</span><span class="o">=</span>0,recved<span class="o">=</span>40,sent<span class="o">=</span>41<span class="o">)</span>
@@ -926,12 +902,11 @@ Outstanding: 0
Zxid: 0x11
Mode: standalone
Node count: 16
-</code></pre>
-</div>
+</code></pre></div></div>
<p>To interact with zookeeper, we’ll use the Curator client rather than the stock zookeeper client. Getting things right with the zookeeper client can be tricky, and curator removes a lot of the pointy corners for you. In fact, curator even provides a leader election recipe, so we need to do very little work to get leader election in our application.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="kd">extends</span> <span class="n">LeaderSelectorListenerAdapter</span> <span class="kd">implements</span> <span class="n">Closeable</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="nc">Dice</span> <span class="kd">extends</span> <span class="n">LeaderSelectorListenerAdapter</span> <span class="kd">implements</span> <span class="n">Closeable</span> <span class="o">{</span>
<span class="kd">final</span> <span class="kd">static</span> <span class="n">String</span> <span class="n">ZOOKEEPER_SERVER</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
<span class="kd">final</span> <span class="kd">static</span> <span class="n">String</span> <span class="n">ELECTION_PATH</span> <span class="o">=</span> <span class="s">"/dice-elect"</span><span class="o">;</span>
@@ -948,8 +923,7 @@ Node count: 16
<span class="n">leaderSelector</span><span class="o">.</span><span class="na">autoRequeue</span><span class="o">();</span>
<span class="n">leaderSelector</span><span class="o">.</span><span class="na">start</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>In the constructor for Dice, we need to create the curator client. We specify four things when creating the client, the location of the zookeeper service, the session timeout, the connect timeout and the retry policy.</p>
@@ -957,7 +931,7 @@ Node count: 16
<p>Finally, you’ll have noticed that Dice now extends LeaderSelectorListenerAdapter and implements Closeable. Closeable is there to close the resource we have initialized in the constructor, the curator client and the leaderSelector. LeaderSelectorListenerAdapter is a callback that the leaderSelector uses to notify the instance that it is now the leader. It is passed as the third argument to the LeaderSelector constructor.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="nd">@Override</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nd">@Override</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">takeLeadership</span><span class="o">(</span><span class="n">CuratorFramework</span> <span class="n">client</span><span class="o">)</span>
<span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
<span class="kd">synchronized</span> <span class="o">(</span><span class="k">this</span><span class="o">)</span> <span class="o">{</span>
@@ -972,12 +946,11 @@ Node count: 16
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>takeLeadership() is the callback called by LeaderSelector when the instance is leader. It should only return when the instance wants to give up leadership. In our case, we never do so we wait on the current object until we’re interrupted. To signal to the rest of the program that we are leader we set a volatile boolean called leader to true. This is unset after we are interrupted.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="kt">void</span> <span class="nf">playDice</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">InterruptedException</span> <span class="o">{</span>
<span class="k">while</span> <span class="o">(</span><span class="kc">true</span><span class="o">)</span> <span class="o">{</span>
<span class="k">while</span> <span class="o">(</span><span class="n">leader</span><span class="o">)</span> <span class="o">{</span>
<span class="n">Thread</span><span class="o">.</span><span class="na">sleep</span><span class="o">(</span><span class="mi">1000</span><span class="o">);</span>
@@ -986,8 +959,7 @@ Node count: 16
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Finally, we modify the <code class="highlighter-rouge">playDice</code> function to only generate random numbers when it is the leader.</p>
@@ -997,18 +969,17 @@ Node count: 16
<p>Now go back to the shell that the original leader was on and wake up the process using fg. You’ll see something like the following:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>...
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>...
...
Value <span class="o">=</span> 4, isLeader <span class="o">=</span> <span class="nb">true
</span>Value <span class="o">=</span> 4, isLeader <span class="o">=</span> <span class="nb">true</span>
^Z
-<span class="o">[</span>1]+ Stopped mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
-<span class="gp">$ </span><span class="nb">fg
-</span>mvn <span class="nb">exec</span>:java -Dexec.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+<span class="o">[</span>1]+ Stopped mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
+<span class="nv">$ </span><span class="nb">fg
+</span>mvn <span class="nb">exec</span>:java <span class="nt">-Dexec</span>.mainClass<span class="o">=</span>org.apache.bookkeeper.Dice
Value <span class="o">=</span> 3, isLeader <span class="o">=</span> <span class="nb">true
</span>Value <span class="o">=</span> 1, isLeader <span class="o">=</span> <span class="nb">false</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h2 id="new-api">New API</h2>
@@ -1027,7 +998,7 @@ Value <span class="o">=</span> 3, isLeader <span class="o">=</span> <span class=
<p>Here is an example building the bookkeeper client.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="c1">// construct a client configuration instance</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// construct a client configuration instance</span>
<span class="n">ClientConfiguration</span> <span class="n">conf</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ClientConfiguration</span><span class="o">();</span>
<span class="n">conf</span><span class="o">.</span><span class="na">setZkServers</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
<span class="n">conf</span><span class="o">.</span><span class="na">setZkLedgersRootPath</span><span class="o">(</span><span class="s">"/path/to/ledgers/root"</span><span class="o">);</span>
@@ -1038,8 +1009,7 @@ Value <span class="o">=</span> 3, isLeader <span class="o">=</span> <span class=
<span class="o">...</span>
<span class="o">.</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="create-ledgers">Create ledgers</h3>
@@ -1048,7 +1018,7 @@ a <a href="../javadoc/org/apache/bookkeeper/client/api/digesttype"><code class="
<p>here’s an example:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
@@ -1060,8 +1030,7 @@ a <a href="../javadoc/org/apache/bookkeeper/client/api/digesttype"><code class="
<span class="o">.</span><span class="na">withAckQuorumSize</span><span class="o">(</span><span class="mi">2</span><span class="o">)</span>
<span class="o">.</span><span class="na">execute</span><span class="o">()</span> <span class="c1">// execute the creation op</span>
<span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// wait for the execution to complete</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>A <a href="../javadoc/org/apache/bookkeeper/client/api/WriteHandle"><code class="highlighter-rouge">WriteHandle</code></a> is returned for applications to write and read entries to and from the ledger.</p>
@@ -1069,7 +1038,7 @@ a <a href="../javadoc/org/apache/bookkeeper/client/api/digesttype"><code class="
<p>The <a href="../javadoc/org/apache/bookkeeper/client/api/WriteHandle"><code class="highlighter-rouge">WriteHandle</code></a> can be used for applications to append entries to the ledgers.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">WriteHandle</span> <span class="n">wh</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">WriteHandle</span> <span class="n">wh</span> <span class="o">=</span> <span class="o">...;</span>
<span class="n">CompletableFuture</span><span class="o"><</span><span class="n">Long</span><span class="o">></span> <span class="n">addFuture</span> <span class="o">=</span> <span class="n">wh</span><span class="o">.</span><span class="na">append</span><span class="o">(</span><span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
@@ -1100,8 +1069,7 @@ a <a href="../javadoc/org/apache/bookkeeper/client/api/digesttype"><code class="
<span class="c1">// handle the exception</span>
<span class="o">}</span>
<span class="o">});</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>The append method supports three representations of a bytes array: the native java <code class="highlighter-rouge">byte[]</code>, java nio <code class="highlighter-rouge">ByteBuffer</code> and netty <code class="highlighter-rouge">ByteBuf</code>.
It is recommended to use <code class="highlighter-rouge">ByteBuf</code> as it is more gc friendly.</p>
@@ -1113,7 +1081,7 @@ in order to open the ledgers.</p>
<p>here’s an example:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
@@ -1123,8 +1091,7 @@ in order to open the ledgers.</p>
<span class="o">.</span><span class="na">withPassword</span><span class="o">(</span><span class="n">password</span><span class="o">)</span>
<span class="o">.</span><span class="na">execute</span><span class="o">()</span> <span class="c1">// execute the open op</span>
<span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// wait for the execution to complete</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>A <a href="../javadoc/org/apache/bookkeeper/client/api/ReadHandle"><code class="highlighter-rouge">ReadHandle</code></a> is returned for applications to read entries to and from the ledger.</p>
@@ -1133,7 +1100,7 @@ in order to open the ledgers.</p>
<p>By default, the <a href="../javadoc/org/apache/bookkeeper/client/api/openBuilder"><code class="highlighter-rouge">openBuilder</code></a> opens the ledger in a <code class="highlighter-rouge">NoRecovery</code> mode. You can open the ledger in <code class="highlighter-rouge">Recovery</code> mode by specifying
<code class="highlighter-rouge">withRecovery(true)</code> in the open builder.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">password</span> <span class="o">=</span> <span class="s">"some-password"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
@@ -1145,8 +1112,7 @@ in order to open the ledgers.</p>
<span class="o">.</span><span class="na">execute</span><span class="o">()</span>
<span class="o">.</span><span class="na">get</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p><strong>What is the difference between “Recovery” and “NoRecovery”?</strong></p>
@@ -1159,7 +1125,7 @@ to be appended to it. The writer which is currently appending entries to the led
<p>The <a href="../javadoc/org/apache/bookkeeper/client/api/ReadHandle"><code class="highlighter-rouge">ReadHandle</code></a> returned from the open builder can be used for applications to read entries from the ledgers.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">startEntryId</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">endEntryId</span> <span class="o">=</span> <span class="o">...;</span>
@@ -1192,8 +1158,7 @@ to be appended to it. The writer which is currently appending entries to the led
<span class="c1">// handle the exception</span>
<span class="o">}</span>
<span class="o">});</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Once you are done with processing the <a href="../javadoc/org/apache/bookkeeper/client/api/LedgerEntries"><code class="highlighter-rouge">LedgerEntries</code></a>, you can call <code class="highlighter-rouge">#close()</code> on the <code class="highlighter-rouge">LedgerEntries</code> instance to
release the buffers held by it.</p>
@@ -1206,9 +1171,8 @@ attempts to read entries beyond <code class="highlighter-rouge">LastAddConfirmed
<p><code class="highlighter-rouge">readUnconfirmed</code> is provided the mechanism for applications to read entries beyond <code class="highlighter-rouge">LastAddConfirmed</code>. Applications should be aware of <code class="highlighter-rouge">readUnconfirmed</code> doesn’t provide any
repeatable read consistency.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">CompletableFuture</span><span class="o"><</span><span class="n">LedgerEntries</span><span class="o">></span> <span class="n">readFuture</span> <span class="o">=</span> <span class="n">rh</span><span class="o">.</span><span class="na">readUnconfirmed</span><span class="o">(</span><span class="n">startEntryId</span><span class="o">,</span> <span class="n">endEntryId</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">CompletableFuture</span><span class="o"><</span><span class="n">LedgerEntries</span><span class="o">></span> <span class="n">readFuture</span> <span class="o">=</span> <span class="n">rh</span><span class="o">.</span><span class="na">readUnconfirmed</span><span class="o">(</span><span class="n">startEntryId</span><span class="o">,</span> <span class="n">endEntryId</span> [...]
+</code></pre></div></div>
<h3 id="tailing-reads">Tailing Reads</h3>
@@ -1218,7 +1182,7 @@ repeatable read consistency.</p>
<p>You can do this in synchronous way:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">startEntryId</span> <span class="o">=</span> <span class="mi">0L</span><span class="o">;</span>
<span class="kt">long</span> <span class="n">nextEntryId</span> <span class="o">=</span> <span class="n">startEntryId</span><span class="o">;</span>
@@ -1240,12 +1204,11 @@ repeatable read consistency.</p>
<span class="n">nextEntryId</span> <span class="o">=</span> <span class="n">endEntryId</span> <span class="o">+</span> <span class="mi">1</span><span class="o">;</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h4 id="long-polling">Long Polling</h4>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ReadHandle</span> <span class="n">rh</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">startEntryId</span> <span class="o">=</span> <span class="mi">0L</span><span class="o">;</span>
<span class="kt">long</span> <span class="n">nextEntryId</span> <span class="o">=</span> <span class="n">startEntryId</span><span class="o">;</span>
@@ -1269,22 +1232,20 @@ repeatable read consistency.</p>
<span class="n">nextEntryId</span> <span class="o">=</span> <span class="n">endEntryId</span> <span class="o">+</span> <span class="mi">1</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="delete-ledgers">Delete ledgers</h3>
<p><span class="pop" id="ledger-popover">Ledgers</span> can be deleted by using <a href="../javadoc/org/apache/bookkeeper/client/api/DeleteBuilder"><code class="highlighter-rouge">DeleteBuilder</code></a>.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span>
<span class="n">bk</span><span class="o">.</span><span class="na">newDeleteLedgerOp</span><span class="o">()</span>
<span class="o">.</span><span class="na">withLedgerId</span><span class="o">(</span><span class="n">ledgerId</span><span class="o">)</span>
<span class="o">.</span><span class="na">execute</span><span class="o">()</span>
<span class="o">.</span><span class="na">get</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.6.1/deployment/dcos/index.html b/content/docs/4.6.1/deployment/dcos/index.html
index cd58b08..d395cfa 100644
--- a/content/docs/4.6.1/deployment/dcos/index.html
+++ b/content/docs/4.6.1/deployment/dcos/index.html
@@ -485,9 +485,8 @@
<h2 id="installing-bookkeeper">Installing BookKeeper</h2>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper --yes
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="nt">--yes</span>
+</code></pre></div></div>
<p>This command will:</p>
@@ -499,7 +498,7 @@
<p>The bookie that is automatically started up uses the host mode of the network and by default exports the service at <code class="highlighter-rouge">agent_ip:3181</code>.</p>
<blockquote>
- <p>If you run <code class="highlighter-rouge">dcos package install bookkeeper</code> without setting the <code class="highlighter-rouge">--yes</code> flag, the install will run in interactive mode. For more information on the <code class="highlighter-rouge">package install</code> command, see the <a href="https://docs.mesosphere.com/latest/cli/command-reference/dcos-package/dcos-package-install/">DC/OS docs</a>.</p>
+ <p>If you run <code class="highlighter-rouge">dcos package install bookkeeper</code> without setting the <code class="highlighter-rouge">--yes</code> flag, the install will run in interactive mode. For more information on the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">install</span></code> command, see the <a href="https://docs.mesosphere.com/latest/cli/command-reference/dcos-package/dcos-package-install/">DC/OS docs</a>.</p>
</blockquote>
<h3 id="services">Services</h3>
@@ -532,15 +531,13 @@
<p>To connect to bookies running on DC/OS using clients running within your Mesos cluster, you need to specify the ZooKeeper connection string for DC/OS’s ZooKeeper cluster:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>master.mesos:2181
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>master.mesos:2181
+</code></pre></div></div>
<p>This is the <em>only</em> ZooKeeper host/port you need to include in your connection string. Here’s an example using the <a href="../../api/ledger-api#the-java-ledger-api-client">Java client</a>:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"master.mesos:2181"</span><span class="o">);</span>
-</code></pre>
-</div>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="s">"master.mesos:2181"</span><span class="o">);</span>
+</code></pre></div></div>
<p>If you’re connecting using a client running outside your Mesos cluster, you need to supply the public-facing connection string for your DC/OS ZooKeeper cluster.</p>
@@ -550,17 +547,15 @@
<p>You can supply a non-default configuration when installing the package using a JSON file. Here’s an example command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper <span class="se">\</span>
- --options<span class="o">=</span>/path/to/config.json
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="se">\</span>
+ <span class="nt">--options</span><span class="o">=</span>/path/to/config.json
+</code></pre></div></div>
-<p>You can then fetch the current configuration for BookKeeper at any time using the <code class="highlighter-rouge">package describe</code> command:</p>
+<p>You can then fetch the current configuration for BookKeeper at any time using the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">describe</span></code> command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package describe bookkeeper <span class="se">\</span>
- --config
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package describe bookkeeper <span class="se">\</span>
+ <span class="nt">--config</span>
+</code></pre></div></div>
<h3 id="available-parameters">Available parameters</h3>
@@ -627,31 +622,28 @@
<p>Here’s an example JSON configuration object for BookKeeper on DC/OS:</p>
-<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
- </span><span class="nt">"instances"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
- </span><span class="nt">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
- </span><span class="nt">"mem"</span><span class="p">:</span><span class="w"> </span><span class="mf">2048.0</span><span class="p">,</span><span class="w">
- </span><span class="nt">"volume_size"</span><span class="p">:</span><span class="w"> </span><span class="mi">250</span><span class="w">
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"instances"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"mem"</span><span class="p">:</span><span class="w"> </span><span class="mf">2048.0</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"volume_size"</span><span class="p">:</span><span class="w"> </span><span class="mi">250</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
-</div>
+</span></code></pre></div></div>
<p>If that configuration were stored in a file called <code class="highlighter-rouge">bk-config.json</code>, you could apply that configuration upon installating the BookKeeper package using this command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package install bookkeeper <span class="se">\</span>
- --options<span class="o">=</span>./bk-config.json
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package <span class="nb">install </span>bookkeeper <span class="se">\</span>
+ <span class="nt">--options</span><span class="o">=</span>./bk-config.json
+</code></pre></div></div>
<h2 id="uninstalling-bookkeeper">Uninstalling BookKeeper</h2>
-<p>You can shut down and uninstall the <code class="highlighter-rouge">bookkeeper</code> from DC/OS at any time using the <code class="highlighter-rouge">package uninstall</code> command:</p>
+<p>You can shut down and uninstall the <code class="highlighter-rouge">bookkeeper</code> from DC/OS at any time using the <code class="highlighter-rouge"><span class="k">package</span> <span class="n">uninstall</span></code> command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>dcos package uninstall bookkeeper
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>dcos package uninstall bookkeeper
Uninstalled package <span class="o">[</span>bookkeeper] version <span class="o">[</span>4.6.1]
Thank you <span class="k">for </span>using bookkeeper.
-</code></pre>
-</div>
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.6.1/deployment/kubernetes/index.html b/content/docs/4.6.1/deployment/kubernetes/index.html
index 53b152a..125dfb5 100644
--- a/content/docs/4.6.1/deployment/kubernetes/index.html
+++ b/content/docs/4.6.1/deployment/kubernetes/index.html
@@ -494,15 +494,14 @@
<p>As an example, we’ll create a new GKE cluster for Kubernetes version <a href="https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG.md#v164">1.6.4</a> in the <a href="https://cloud.google.com/compute/docs/regions-zones/regions-zones#available">us-central1-a</a> zone. The cluster will be named <code class="highlighter-rouge">bookkeeper-gke-cluster</code> and will consist of three VMs, each using two locally attached SSDs and running on <a href="https://cloud.google.com/compute [...]
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>gcloud config <span class="nb">set </span>compute/zone us-central1-a
-<span class="gp">$ </span>gcloud config <span class="nb">set </span>project your-project-name
-<span class="gp">$ </span>gcloud container clusters create bookkeeper-gke-cluster <span class="se">\</span>
- --machine-type<span class="o">=</span>n1-standard-8 <span class="se">\</span>
- --num-nodes<span class="o">=</span>3 <span class="se">\</span>
- --local-ssd-count<span class="o">=</span>2 <span class="se">\</span>
- --enable-kubernetes-alpha
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>gcloud config <span class="nb">set </span>compute/zone us-central1-a
+<span class="nv">$ </span>gcloud config <span class="nb">set </span>project your-project-name
+<span class="nv">$ </span>gcloud container clusters create bookkeeper-gke-cluster <span class="se">\</span>
+ <span class="nt">--machine-type</span><span class="o">=</span>n1-standard-8 <span class="se">\</span>
+ <span class="nt">--num-nodes</span><span class="o">=</span>3 <span class="se">\</span>
+ <span class="nt">--local-ssd-count</span><span class="o">=</span>2 <span class="se">\</span>
+ <span class="nt">--enable-kubernetes-alpha</span>
+</code></pre></div></div>
<p>By default, bookies will run on all the machines that have locally attached SSD disks. In this example, all of those machines will have two SSDs, but you can add different types of machines to the cluster later. You can control which machines host bookie servers using <a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels">labels</a>.</p>
@@ -510,20 +509,18 @@
<p>You can observe your cluster in the <a href="https://kubernetes.io/docs/tasks/access-application-cluster/web-ui-dashboard/">Kubernetes Dashboard</a> by downloading the credentials for your Kubernetes cluster and opening up a proxy to the cluster:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>gcloud container clusters get-credentials bookkeeper-gke-cluster <span class="se">\</span>
- --zone<span class="o">=</span>us-central1-a <span class="se">\</span>
- --project<span class="o">=</span>your-project-name
-<span class="gp">$ </span>kubectl proxy
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>gcloud container clusters get-credentials bookkeeper-gke-cluster <span class="se">\</span>
+ <span class="nt">--zone</span><span class="o">=</span>us-central1-a <span class="se">\</span>
+ <span class="nt">--project</span><span class="o">=</span>your-project-name
+<span class="nv">$ </span>kubectl proxy
+</code></pre></div></div>
<p>By default, the proxy will be opened on port 8001. Now you can navigate to <a href="http://localhost:8001/ui">localhost:8001/ui</a> in your browser to access the dashboard. At first your GKE cluster will be empty, but that will change as you begin deploying.</p>
<p>When you create a cluster, your <code class="highlighter-rouge">kubectl</code> config in <code class="highlighter-rouge">~/.kube/config</code> (on MacOS and Linux) will be updated for you, so you probably won’t need to change your configuration. Nonetheless, you can ensure that <code class="highlighter-rouge">kubectl</code> can interact with your cluster by listing the nodes in the cluster:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl get nodes
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl get nodes
+</code></pre></div></div>
<p>If <code class="highlighter-rouge">kubectl</code> is working with your cluster, you can proceed to deploy ZooKeeper and Bookies.</p>
@@ -531,29 +528,26 @@
<p>You <em>must</em> deploy ZooKeeper as the first component, as it is a dependency for the others.</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl apply -f zookeeper.yaml
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl apply <span class="nt">-f</span> zookeeper.yaml
+</code></pre></div></div>
<p>Wait until all three ZooKeeper server pods are up and have the status <code class="highlighter-rouge">Running</code>. You can check on the status of the ZooKeeper pods at any time:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl get pods -l <span class="nv">component</span><span class="o">=</span>zookeeper
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl get pods <span class="nt">-l</span> <span class="nv">component</span><span class="o">=</span>zookeeper
NAME READY STATUS RESTARTS AGE
zk-0 1/1 Running 0 18m
zk-1 1/1 Running 0 17m
zk-2 0/1 Running 6 15m
-</code></pre>
-</div>
+</code></pre></div></div>
<p>This step may take several minutes, as Kubernetes needs to download the Docker image on the VMs.</p>
<p>If you want to connect to one of the remote zookeeper server, you can use<a href="https://github.com/rgs1/zk_shell">zk-shell</a>, you need to forward a local port to the
remote zookeeper server:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl port-forward zk-0 2181:2181
-<span class="gp">$ </span>zk-shell localhost 2181
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl port-forward zk-0 2181:2181
+<span class="nv">$ </span>zk-shell localhost 2181
+</code></pre></div></div>
<h3 id="deploy-bookies">Deploy Bookies</h3>
@@ -575,27 +569,24 @@ the data replication. It maintains the best latency property. However, it uses <
can be potentially higher when using persistent volumes, because there is usually built-in replication in the persistent volumes.</p>
</blockquote>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="c"># deploy bookies in a daemon set</span>
-<span class="gp">$ </span>kubectl apply -f bookkeeper.yaml
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># deploy bookies in a daemon set</span>
+<span class="nv">$ </span>kubectl apply <span class="nt">-f</span> bookkeeper.yaml
<span class="c"># deploy bookies in a stateful set</span>
-<span class="gp">$ </span>kubectl apply -f bookkeeper.stateful.yaml
-</code></pre>
-</div>
+<span class="nv">$ </span>kubectl apply <span class="nt">-f</span> bookkeeper.stateful.yaml
+</code></pre></div></div>
<p>You can check on the status of the Bookie pods for these components either in the Kubernetes Dashboard or using <code class="highlighter-rouge">kubectl</code>:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl get pods
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl get pods
+</code></pre></div></div>
<p>While all BookKeeper pods is Running, by zk-shell you could find all available bookies under /ledgers/</p>
<p>You could also run a <a href="https://github.com/ivankelly/bookkeeper-tutorial/">bookkeeper tutorial</a> instance, which named as ‘dice’ here, in this bookkeeper cluster.</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="nv">$</span>kubectl run -i --tty --attach dice --image<span class="o">=</span>caiok/bookkeeper-tutorial --env <span class="nv">ZOOKEEPER_SERVERS</span><span class="o">=</span><span class="s2">"zk-0.zookeeper"</span>
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$</span>kubectl run <span class="nt">-i</span> <span class="nt">--tty</span> <span class="nt">--attach</span> dice <span class="nt">--image</span><span class="o">=</span>caiok/bookkeeper-tutorial <span class="nt">--env</span> <span class="nv">ZOOKEEPER_SERVERS</span><span class="o">=</span><span class="s2">"zk-0.zookeeper"</span>
+</code></pre></div></div>
<p>An example output of Dice instance is like this:</p>
<pre><code class="language-aidl">➜ $ kubectl run -i --tty --attach dice --image=caiok/bookkeeper-tutorial --env ZOOKEEPER_SERVERS="zk-0.zookeeper"
@@ -619,24 +610,20 @@ Value = 2, epoch = 5, leading
<p>Delete Demo dice instance</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="nv">$</span>kubectl delete deployment dice
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$</span>kubectl delete deployment dice
+</code></pre></div></div>
<p>Delete BookKeeper</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl delete -f bookkeeper.yaml
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl delete <span class="nt">-f</span> bookkeeper.yaml
+</code></pre></div></div>
<p>Delete ZooKeeper</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>kubectl delete -f zookeeper.yaml
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>kubectl delete <span class="nt">-f</span> zookeeper.yaml
+</code></pre></div></div>
<p>Delete cluster</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>gcloud container clusters delete bookkeeper-gke-cluster
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>gcloud container clusters delete bookkeeper-gke-cluster
+</code></pre></div></div>
</section>
diff --git a/content/docs/4.6.1/deployment/manual/index.html b/content/docs/4.6.1/deployment/manual/index.html
index aa93c7c..5ae16ae 100644
--- a/content/docs/4.6.1/deployment/manual/index.html
+++ b/content/docs/4.6.1/deployment/manual/index.html
@@ -472,9 +472,8 @@
<p>On each bookie host, you need to <a href="../../getting-started/installation#download">download</a> the BookKeeper package as a tarball. Once you’ve done that, you need to configure the bookie by setting values in the <code class="highlighter-rouge">bookkeeper-server/conf/bk_server.conf</code> config file. The one parameter that you will absolutely need to change is the <a href="../../config#zkServers"><code class="highlighter-rouge">zkServers</code></a> parameter, which you will need [...]
-<div class="language-properties highlighter-rouge"><pre class="highlight"><code><span class="py">zkServers</span><span class="p">=</span><span class="s">100.0.0.1:2181,100.0.0.2:2181,100.0.0.3:2181</span>
-</code></pre>
-</div>
+<div class="language-properties highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="py">zkServers</span><span class="p">=</span><span class="s">100.0.0.1:2181,100.0.0.2:2181,100.0.0.3:2181</span>
+</code></pre></div></div>
<blockquote>
<p>A full listing of configurable parameters available in <code class="highlighter-rouge">bookkeeper-server/conf/bk_server.conf</code> can be found in the <a href="../../reference/config">Configuration</a> reference manual.</p>
@@ -482,9 +481,8 @@
<p>Once the bookie’s configuration is set, you can start it up using the <a href="../../reference/cli#bookkeeper-bookie"><code class="highlighter-rouge">bookie</code></a> command of the <a href="../../reference/cli#bookkeeper"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<blockquote>
<p>You can also build BookKeeper <a href="../../getting-started/installation#clone">by cloning it from source</a> or <a href="../../getting-started/installation#build-using-maven">using Maven</a>.</p>
@@ -519,9 +517,8 @@
<p>Once you’ve started up a cluster of bookies, you need to set up cluster metadata for the cluster by running the following command from any bookie in the cluster:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
+</code></pre></div></div>
<p>You can run in the formatting</p>
diff --git a/content/docs/4.6.1/getting-started/concepts/index.html b/content/docs/4.6.1/getting-started/concepts/index.html
index 4b8c3eb..2753127 100644
--- a/content/docs/4.6.1/getting-started/concepts/index.html
+++ b/content/docs/4.6.1/getting-started/concepts/index.html
@@ -679,10 +679,9 @@
<p>BookKeeper requires a ZooKeeper installation for storing <a href="#ledger">ledger</a> metadata. Whenever you construct a <a href="../../api/javadoc/org/apache/bookkeeper/client/BookKeeper"><code class="highlighter-rouge">BookKeeper</code></a> client object, you need to pass a list of ZooKeeper servers as a parameter to the constructor, like this:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">String</span> <span class="n">zkConnectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">String</span> <span class="n">zkConnectionString</span> <span class="o">=</span> <span class="s">"127.0.0.1:2181"</span><span class="o">;</span>
<span class="n">BookKeeper</span> <span class="n">bkClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">BookKeeper</span><span class="o">(</span><span class="n">zkConnectionString</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>For more info on using the BookKeeper Java client, see <a href="../../api/ledger-api#the-java-ledger-api-client">this guide</a>.</p>
@@ -714,15 +713,13 @@
<p>The <em>hierarchical ledger manager</em>, implemented in the <a href="../../api/javadoc/org/apache/bookkeeper/meta/HierarchicalLedgerManager"><code class="highlighter-rouge">HierarchicalLedgerManager</code></a> class, first obtains a global unique ID from ZooKeeper using an <a href="https://zookeeper.apache.org/doc/current/api/org/apache/zookeeper/CreateMode.html#EPHEMERAL_SEQUENTIAL"><code class="highlighter-rouge">EPHEMERAL_SEQUENTIAL</code></a> znode. Since ZooKeeper’s sequence cou [...]
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="o">{</span>level1 <span class="o">(</span>2 digits<span class="o">)}{</span>level2 <span class="o">(</span>4 digits<span class="o">)}{</span>level3 <span class="o">(</span>4 digits<span class="o">)}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">{</span>level1 <span class="o">(</span>2 digits<span class="o">)}{</span>level2 <span class="o">(</span>4 digits<span class="o">)}{</span>level3 <span class="o">(</span>4 digits<span class="o">)}</span>
+</code></pre></div></div>
<p>These three parts are used to form the actual ledger node path to store ledger metadata:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="o">{</span>ledgers_root_path<span class="o">}</span>/<span class="o">{</span>level1<span class="o">}</span>/<span class="o">{</span>level2<span class="o">}</span>/L<span class="o">{</span>level3<span class="o">}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">{</span>ledgers_root_path<span class="o">}</span>/<span class="o">{</span>level1<span class="o">}</span>/<span class="o">{</span>level2<span class="o">}</span>/L<span class="o">{</span>level3<span class="o">}</span>
+</code></pre></div></div>
<p>For example, ledger 0000000001 is split into three parts, 00, 0000, and 00001, and stored in znode <code class="highlighter-rouge">/{ledgers_root_path}/00/0000/L0001</code>. Each znode could have as many 10,000 ledgers, which avoids the problem of the child list being larger than the maximum ZooKeeper packet size (which is the <a href="https://issues.apache.org/jira/browse/BOOKKEEPER-39">limitation</a> that initially prompted the creation of the hierarchical ledger manager).</p>
diff --git a/content/docs/4.6.1/getting-started/installation/index.html b/content/docs/4.6.1/getting-started/installation/index.html
index 6c1cbe6..aae1d26 100644
--- a/content/docs/4.6.1/getting-started/installation/index.html
+++ b/content/docs/4.6.1/getting-started/installation/index.html
@@ -470,31 +470,28 @@
<p>You can download Apache BookKeeper releases from one of many <a href="http://www.apache.org/dyn/closer.cgi/bookkeeper">Apache mirrors</a>. Here’s an example for the <a href="http://apache.claz.org/bookkeeper">apache.claz.org</a> mirror:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>curl -O http://apache.claz.org/bookkeeper/bookkeeper-4.6.1/bookkeeper-4.6.1-src.tar.gz
-<span class="gp">$ </span>tar xvf bookkeeper-4.6.1-src.tar.gz
-<span class="gp">$ </span><span class="nb">cd </span>bookkeeper-4.6.1
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-O</span> http://apache.claz.org/bookkeeper/bookkeeper-4.6.1/bookkeeper-4.6.1-src.tar.gz
+<span class="nv">$ </span><span class="nb">tar </span>xvf bookkeeper-4.6.1-src.tar.gz
+<span class="nv">$ </span><span class="nb">cd </span>bookkeeper-4.6.1
+</code></pre></div></div>
<h2 id="clone">Clone</h2>
<p>To build BookKeeper from source, clone the repository, either from the <a href="https://github.com/apache/bookkeeper">GitHub mirror</a> or from the <a href="http://git.apache.org/bookkeeper.git/">Apache repository</a>:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="c"># From the GitHub mirror</span>
-<span class="gp">$ </span>git clone https://github.com/apache/bookkeeper
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># From the GitHub mirror</span>
+<span class="nv">$ </span>git clone https://github.com/apache/bookkeeper
<span class="c"># From Apache directly</span>
-<span class="gp">$ </span>git clone git://git.apache.org/bookkeeper.git/
-</code></pre>
-</div>
+<span class="nv">$ </span>git clone git://git.apache.org/bookkeeper.git/
+</code></pre></div></div>
<h2 id="build-using-maven">Build using Maven</h2>
<p>Once you have the BookKeeper on your local machine, either by <a href="#download">downloading</a> or <a href="#clone">cloning</a> it, you can then build BookKeeper from source using Maven:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>mvn package
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>mvn package
+</code></pre></div></div>
<blockquote>
<p>You can skip tests by adding the <code class="highlighter-rouge">-DskipTests</code> flag when running <code class="highlighter-rouge">mvn package</code>.</p>
diff --git a/content/docs/4.6.1/getting-started/run-locally/index.html b/content/docs/4.6.1/getting-started/run-locally/index.html
index a76bbe2..ae8983d 100644
--- a/content/docs/4.6.1/getting-started/run-locally/index.html
+++ b/content/docs/4.6.1/getting-started/run-locally/index.html
@@ -459,9 +459,8 @@
<p>This would start up an ensemble with 10 bookies:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 10
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 10
+</code></pre></div></div>
<blockquote>
<p>When you start up an ensemble using <code class="highlighter-rouge">localbookie</code>, all bookies run in a single JVM process.</p>
diff --git a/content/docs/4.6.1/reference/cli/index.html b/content/docs/4.6.1/reference/cli/index.html
index 00e15b7..e144b8a 100644
--- a/content/docs/4.6.1/reference/cli/index.html
+++ b/content/docs/4.6.1/reference/cli/index.html
@@ -525,9 +525,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-localbookie">localbookie</h3>
@@ -536,9 +535,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie N
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie N
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-autorecovery">autorecovery</h3>
@@ -547,9 +545,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-upgrade">upgrade</h3>
@@ -558,9 +555,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-shell">shell</h3>
@@ -569,9 +565,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell
+</code></pre></div></div>
<hr />
<h3 id="bookkeeper-help">help</h3>
@@ -580,9 +575,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper <span class="nb">help</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper <span class="nb">help</span>
+</code></pre></div></div>
<h2 id="the-bookkeeper-shell">The BookKeeper shell</h2>
@@ -592,10 +586,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -629,10 +622,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieFormat <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieFormat <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -671,9 +663,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieinfo
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieinfo
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -684,10 +675,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookiesanity <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookiesanity <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -721,9 +711,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell decommissionbookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell decommissionbookie
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -734,10 +723,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell deleteledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell deleteledger <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -771,9 +759,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell expandstorage
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell expandstorage
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -784,9 +771,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell <span class="nb">help</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell <span class="nb">help</span>
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -797,9 +783,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell lastmark
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell lastmark
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -810,10 +795,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell ledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell ledger <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -842,10 +826,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell ledgermetadata <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell ledgermetadata <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -874,10 +857,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listbookies <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listbookies <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -916,10 +898,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listfilesondisc <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listfilesondisc <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -958,10 +939,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listledgers <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listledgers <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -990,10 +970,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell listunderreplicated <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell listunderreplicated <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1027,10 +1006,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1064,10 +1042,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell lostbookierecoverydelay <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell lostbookierecoverydelay <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1101,10 +1078,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readjournal <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readjournal <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1138,10 +1114,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readledger <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readledger <span class="se">\</span>
<ledger_id> <span class="o">[</span><start_entry_id> <span class="o">[</span><end_entry_id>]]
-</code></pre>
-</div>
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -1152,11 +1127,10 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell readlog <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell readlog <span class="se">\</span>
<entry_log_id | entry_log_file_name> <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1205,11 +1179,10 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
<bookieSrc> <span class="o">[</span><bookieDest>] <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1238,10 +1211,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell simpletest <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell simpletest <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1285,9 +1257,8 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell triggeraudit
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell triggeraudit
+</code></pre></div></div>
<p><!-- if command.options --></p>
<hr />
@@ -1298,10 +1269,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell updatecookie <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell updatecookie <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
@@ -1330,10 +1300,9 @@
<h5>Usage</h5>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell updateledgers <span class="se">\</span>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell updateledgers <span class="se">\</span>
<options>
-</code></pre>
-</div>
+</code></pre></div></div>
<h5>Options</h5>
diff --git a/content/docs/4.6.1/security/sasl/index.html b/content/docs/4.6.1/security/sasl/index.html
index f8c614a..dc20e67 100644
--- a/content/docs/4.6.1/security/sasl/index.html
+++ b/content/docs/4.6.1/security/sasl/index.html
@@ -467,24 +467,21 @@ by mechanism-specific details and wrap up with some operational details.</p>
<li>
<p>Pass the <code class="highlighter-rouge">JAAS</code> config file location as JVM parameter to each Bookie. For example:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
+</code></pre></div> </div>
</li>
<li>
<p>Enable SASL auth plugin in bookies, by setting <code class="highlighter-rouge">bookieAuthProviderFactoryClass</code> to <code class="highlighter-rouge">org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory</code>.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
+</code></pre></div> </div>
</li>
<li>
<p>If you are running <code class="highlighter-rouge">autorecovery</code> along with bookies, then you want to enable SASL auth plugin for <code class="highlighter-rouge">autorecovery</code>, by setting
<code class="highlighter-rouge">clientAuthProviderFactoryClass</code> to <code class="highlighter-rouge">org.apache.bookkeeper.sasl.SASLClientProviderFactory</code>.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
<li>Follow the steps in <a href="#kerberos">GSSAPI (Kerberos)</a> to configure SASL.</li>
</ol>
@@ -515,16 +512,14 @@ by mechanism-specific details and wrap up with some operational details.</p>
<li>
<p>Pass the <code class="highlighter-rouge">JAAS</code> config file location as JVM parameter to each client JVM. For example:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
+</code></pre></div> </div>
</li>
<li>
<p>Configure the following properties in bookkeeper <code class="highlighter-rouge">ClientConfiguration</code>:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
</ol>
@@ -550,10 +545,9 @@ for each Bookie in your cluster and for every operating system user that will ac
<p>If you have installed your own Kerberos, you will need to create these principals yourself using the following commands:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>sudo /usr/sbin/kadmin.local -q <span class="s1">'addprinc -randkey bookkeeper/{hostname}@{REALM}'</span>
-sudo /usr/sbin/kadmin.local -q <span class="s2">"ktadd -k /etc/security/keytabs/{keytabname}.keytab bookkeeper/{hostname}@{REALM}"</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo</span> /usr/sbin/kadmin.local <span class="nt">-q</span> <span class="s1">'addprinc -randkey bookkeeper/{hostname}@{REALM}'</span>
+<span class="nb">sudo</span> /usr/sbin/kadmin.local <span class="nt">-q</span> <span class="s2">"ktadd -k /etc/security/keytabs/{keytabname}.keytab bookkeeper/{hostname}@{REALM}"</span>
+</code></pre></div></div>
<h5 id="all-hosts-must-be-reachable-using-hostnames">All hosts must be reachable using hostnames</h5>
@@ -566,7 +560,7 @@ sudo /usr/sbin/kadmin.local -q <span class="s2">"ktadd -k /etc/security/keytabs/
<p>Add a suitably modified JAAS file similar to the one below to each Bookie’s config directory, let’s call it <code class="highlighter-rouge">bookie_jaas.conf</code>
for this example (note that each bookie should have its own keytab):</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> Bookie {
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> Bookie {
com.sun.security.auth.module.Krb5LoginModule required
useKeyTab=true
storeKey=true
@@ -589,8 +583,7 @@ for this example (note that each bookie should have its own keytab):</p>
keyTab="/etc/security/keytabs/bookie.keytab"
principal="bookkeeper/bk1.hostname.com@EXAMPLE.COM";
};
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>The <code class="highlighter-rouge">Bookie</code> section in the JAAS file tells the bookie which principal to use and the location of the keytab where this principal is stored.
It allows the bookie to login using the keytab specified in this section. See <a href="#notes">notes</a> for more details on Zookeeper’s SASL configuration.</p>
@@ -598,16 +591,14 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Pass the name of the JAAS file as a JVM parameter to each Bookie:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookie_jaas.conf
+</code></pre></div> </div>
<p>You may also wish to specify the path to the <code class="highlighter-rouge">krb5.conf</code> file
(see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">JDK’s Kerberos Requirements</a> for more details):</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
+</code></pre></div> </div>
</li>
<li>
<p>Make sure the keytabs configured in the JAAS file are readable by the operating system user who is starting the Bookies.</p>
@@ -615,11 +606,10 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Enable SASL authentication plugin in the bookies by setting following parameters.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">bookieAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLBookieAuthProviderFactory
<span class="c"># if you run `autorecovery` along with bookies</span>
<span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
</ol>
@@ -634,29 +624,26 @@ for this example (note that each bookie should have its own keytab):</p>
how the clients like writers and readers can connect to the Bookies. The following is an example configuration for a client using
a keytab (recommended for long-running processes):</p>
- <div class="highlighter-rouge"><pre class="highlight"><code> BookKeeper {
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> BookKeeper {
com.sun.security.auth.module.Krb5LoginModule required
useKeyTab=true
storeKey=true
keyTab="/etc/security/keytabs/bookkeeper.keytab"
principal="bookkeeper-client-1@EXAMPLE.COM";
};
-</code></pre>
- </div>
+</code></pre></div> </div>
</li>
<li>
<p>Pass the name of the JAAS file as a JVM parameter to the client JVM:</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.auth.login.config<span class="o">=</span>/etc/bookkeeper/bookkeeper_jaas.conf
+</code></pre></div> </div>
<p>You may also wish to specify the path to the <code class="highlighter-rouge">krb5.conf</code> file (see
<a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">JDK’s Kerberos Requirements</a> for more details).</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> -Djava.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt">-Djava</span>.security.krb5.conf<span class="o">=</span>/etc/bookkeeper/krb5.conf
+</code></pre></div> </div>
</li>
<li>
<p>Make sure the keytabs configured in the <code class="highlighter-rouge">bookkeeper_jaas.conf</code> are readable by the operating system user who is starting bookkeeper client.</p>
@@ -664,9 +651,8 @@ for this example (note that each bookie should have its own keytab):</p>
<li>
<p>Enable SASL authentication plugin in the client by setting following parameters.</p>
- <div class="language-shell highlighter-rouge"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
-</code></pre>
- </div>
+ <div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nv">clientAuthProviderFactoryClass</span><span class="o">=</span>org.apache.bookkeeper.sasl.SASLClientProviderFactory
+</code></pre></div> </div>
</li>
</ol>
diff --git a/content/docs/4.6.1/security/tls/index.html b/content/docs/4.6.1/security/tls/index.html
index 5b9b0ed..1f32afe 100644
--- a/content/docs/4.6.1/security/tls/index.html
+++ b/content/docs/4.6.1/security/tls/index.html
@@ -481,9 +481,8 @@ In (2), with a CA, the bookie or client will trust any certificate that was sign
You can use Java’s <code class="highlighter-rouge">keytool</code> utility to accomplish this task. We will generate the key into a temporary keystore
initially so that we can export and sign it later with CA.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias localhost -validity <span class="o">{</span>validity<span class="o">}</span> -genkey
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-validity</span> <span class="o">{</span>validity<span class="o">}</span> <span class="nt">-genkey</span>
+</code></pre></div></div>
<p>You need to specify two parameters in the above command:</p>
@@ -510,25 +509,22 @@ to ensure the passport is authentic. Similarly, the CA signs the certificates, a
certificate is computationally difficult to forge. Thus, as long as the CA is a genuine and trusted authority, the clients have
high assurance that they are connecting to the authentic machines.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl req -new -x509 -keyout ca-key -out ca-cert -days 365
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl req <span class="nt">-new</span> <span class="nt">-x509</span> <span class="nt">-keyout</span> ca-key <span class="nt">-out</span> ca-cert <span class="nt">-days</span> 365
+</code></pre></div></div>
<p>The generated CA is simply a <em>public-private</em> key pair and certificate, and it is intended to sign other certificates.</p>
<p>The next step is to add the generated CA to the clients’ truststore so that the clients can trust this CA:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.truststore.jks -alias CARoot -import -file ca-cert
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.truststore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+</code></pre></div></div>
<p>NOTE: If you configure the bookies to require client authentication by setting <code class="highlighter-rouge">sslClientAuthentication</code> to <code class="highlighter-rouge">true</code> on the
<a href="../../reference/config">bookie config</a>, then you must also provide a truststore for the bookies and it should have all the CA
certificates that clients keys were signed by.</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore client.truststore.jks -alias CARoot -import -file ca-cert
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> client.truststore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+</code></pre></div></div>
<p>In contrast to the keystore, which stores each machine’s own identity, the truststore of a client stores all the certificates
that the client should trust. Importing a certificate into one’s truststore also means trusting all certificates that are signed
@@ -541,22 +537,19 @@ That way all machines can authenticate all other machines.</p>
<p>The next step is to sign all certificates in the keystore with the CA we generated. First, you need to export the certificate from the keystore:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias localhost -certreq -file cert-file
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-certreq</span> <span class="nt">-file</span> cert-file
+</code></pre></div></div>
<p>Then sign it with the CA:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl x509 -req -CA ca-cert -CAkey ca-key -in cert-file -out cert-signed -days <span class="o">{</span>validity<span class="o">}</span> -CAcreateserial -passin pass:<span class="o">{</span>ca-password<span class="o">}</span>
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl x509 <span class="nt">-req</span> <span class="nt">-CA</span> ca-cert <span class="nt">-CAkey</span> ca-key <span class="nt">-in</span> cert-file <span class="nt">-out</span> cert-signed <span class="nt">-days</span> <span class="o">{</span>validity<span class="o">}</span> <span class="nt">-CAcreateserial</span> <span class="nt">-passin</span> pass:<span class="o">{</span>ca-password [...]
+</code></pre></div></div>
<p>Finally, you need to import both the certificate of the CA and the signed certificate into the keystore:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>keytool -keystore bookie.keystore.jks -alias CARoot -import -file ca-cert
-keytool -keystore bookie.keystore.jks -alias localhost -import -file cert-signed
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> CARoot <span class="nt">-import</span> <span class="nt">-file</span> ca-cert
+keytool <span class="nt">-keystore</span> bookie.keystore.jks <span class="nt">-alias</span> localhost <span class="nt">-import</span> <span class="nt">-file</span> cert-signed
+</code></pre></div></div>
<p>The definitions of the parameters are the following:</p>
@@ -585,7 +578,7 @@ netty bindings to leverage installed OpenSSL.</p>
<p>The following TLS configs are needed on the bookie side:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
<span class="c"># key store</span>
<span class="nv">tlsKeyStoreType</span><span class="o">=</span>JKS
<span class="nv">tlsKeyStore</span><span class="o">=</span>/var/private/tls/bookie.keystore.jks
@@ -594,8 +587,7 @@ netty bindings to leverage installed OpenSSL.</p>
<span class="nv">tlsTrustStoreType</span><span class="o">=</span>JKS
<span class="nv">tlsTrustStore</span><span class="o">=</span>/var/private/tls/bookie.truststore.jks
<span class="nv">tlsTrustStorePasswordPath</span><span class="o">=</span>/var/private/tls/bookie.truststore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>NOTE: it is important to restrict access to the store files and corresponding password files via filesystem permissions.</p>
@@ -614,19 +606,17 @@ netty bindings to leverage installed OpenSSL.</p>
<p>To verify the bookie’s keystore and truststore are setup correctly you can run the following command:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>openssl s_client -debug -connect localhost:3181 -tls1
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl s_client <span class="nt">-debug</span> <span class="nt">-connect</span> localhost:3181 <span class="nt">-tls1</span>
+</code></pre></div></div>
<p>NOTE: TLSv1 should be listed under <code class="highlighter-rouge">tlsEnabledProtocols</code>.</p>
<p>In the output of this command you should see the server’s certificate:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>-----BEGIN CERTIFICATE-----
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">-----BEGIN</span> CERTIFICATE-----
<span class="o">{</span>variable sized random bytes<span class="o">}</span>
------END CERTIFICATE-----
-</code></pre>
-</div>
+<span class="nt">-----END</span> CERTIFICATE-----
+</code></pre></div></div>
<p>If the certificate does not show up or if there are any other error messages then your keystore is not setup correctly.</p>
@@ -637,11 +627,10 @@ supported. The configs for TLS will be the same as bookies.</p>
<p>If client authentication is not required by the bookies, the following is a minimal configuration example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsProvider</span><span class="o">=</span>OpenSSL
<span class="nv">clientTrustStore</span><span class="o">=</span>/var/private/tls/client.truststore.jks
<span class="nv">clientTrustStorePasswordPath</span><span class="o">=</span>/var/private/tls/client.truststore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If client authentication is required, then a keystore must be created for each client, and the bookies’ truststores must
trust the certificate in the client’s keystore. This may be done using commands that are similar to what we used for
@@ -649,11 +638,10 @@ the <a href="#bookie-keystore">bookie keystore</a>.</p>
<p>And the following must also be configured:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">tlsClientAuthentication</span><span class="o">=</span><span class="nb">true
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">tlsClientAuthentication</span><span class="o">=</span><span class="nb">true
</span><span class="nv">clientKeyStore</span><span class="o">=</span>/var/private/tls/client.keystore.jks
<span class="nv">clientKeyStorePasswordPath</span><span class="o">=</span>/var/private/tls/client.keystore.passwd
-</code></pre>
-</div>
+</code></pre></div></div>
<p>NOTE: it is important to restrict access to the store files and corresponding password files via filesystem permissions.</p>
@@ -663,9 +651,8 @@ the <a href="#bookie-keystore">bookie keystore</a>.</p>
<p>You can enable TLS debug logging at the JVM level by starting the bookies and/or clients with <code class="highlighter-rouge">javax.net.debug</code> system property. For example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code>-Djavax.net.debug<span class="o">=</span>all
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">-Djavax</span>.net.debug<span class="o">=</span>all
+</code></pre></div></div>
<p>You can find more details on this in <a href="http://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/ReadDebug.html">Oracle documentation</a> on
<a href="http://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/ReadDebug.html">debugging SSL/TLS connections</a>.</p>
diff --git a/content/docs/latest/admin/autorecovery/index.html b/content/docs/latest/admin/autorecovery/index.html
index a08e2f7..c1a087a 100644
--- a/content/docs/latest/admin/autorecovery/index.html
+++ b/content/docs/latest/admin/autorecovery/index.html
@@ -474,20 +474,18 @@
<p>Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="c"># IP and port for the failed bookie</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If you wish, you can also specify which bookie you’d like to rereplicate to. Here’s an example:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
zk1.example.com:2181 <span class="se">\ </span><span class="c"># IP and port for ZooKeeper</span>
192.168.1.10:3181 <span class="se">\ </span> <span class="c"># IP and port for the failed bookie</span>
192.168.1.11:3181 <span class="c"># IP and port for the bookie to rereplicate to</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="the-manual-recovery-process">The manual recovery process</h3>
@@ -520,9 +518,8 @@
<p>You can start up AutoRecovery using the <a href="../../reference/cli#bookkeeper-autorecovery"><code class="highlighter-rouge">autorecovery</code></a> command of the <a href="../../reference/cli"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool.</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper autorecovery
+</code></pre></div></div>
<blockquote>
<p>The most important thing to ensure when starting up AutoRecovery is that the ZooKeeper connection string specified by the <a href="../../reference/config#zkServers"><code class="highlighter-rouge">zkServers</code></a> parameter points to the right ZooKeeper cluster.</p>
@@ -542,15 +539,13 @@
<p>You can disable AutoRecover using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -disable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-disable</span>
+</code></pre></div></div>
<p>Once disabled, you can reenable AutoRecovery using the <a href="../../reference/cli#bookkeeper-shell-autorecovery"><code class="highlighter-rouge">enable</code></a> shell command:</p>
-<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery -enable
-</code></pre>
-</div>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell autorecovery <span class="nt">-enable</span>
+</code></pre></div></div>
<h2 id="autorecovery-architecture">AutoRecovery architecture</h2>
diff --git a/content/docs/latest/admin/bookies/index.html b/content/docs/latest/admin/bookies/index.html
index ef9583c..3e1fd1f 100644
--- a/content/docs/latest/admin/bookies/index.html
+++ b/content/docs/latest/admin/bookies/index.html
@@ -484,15 +484,13 @@
<p>To start a bookie in the foreground, use the <a href="../../reference/cli#bookkeeper-bookie"><code class="highlighter-rouge">bookie</code></a> command of the <a href="../../reference/cli#bookkeeper"><code class="highlighter-rouge">bookkeeper</code></a> CLI tool:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>To start a bookie in the background, use the <a href="../../reference/cli#bookkeeper-daemon.sh"><code class="highlighter-rouge">bookkeeper-daemon.sh</code></a> script and run <code class="highlighter-rouge">start bookie</code>:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper-daemon.sh start bookie
+</code></pre></div></div>
<h3 id="local-bookies">Local bookies</h3>
@@ -500,9 +498,8 @@
<p>This would spin up a local ensemble of 6 bookies:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper localbookie 6
+</code></pre></div></div>
<blockquote>
<p>When you run a local bookie ensemble, all bookies run in a single JVM process.</p>
@@ -556,18 +553,16 @@
<p>To enable logging for a bookie, create a <code class="highlighter-rouge">log4j.properties</code> file and point the <code class="highlighter-rouge">BOOKIE_LOG_CONF</code> environment variable to the configuration file. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
-<span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">export </span><span class="nv">BOOKIE_LOG_CONF</span><span class="o">=</span>/some/path/log4j.properties
+<span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<h2 id="upgrading">Upgrading</h2>
<p>From time to time you may need to make changes to the filesystem layout of bookies—changes that are incompatible with previous versions of BookKeeper and require that directories used with previous versions are upgraded. If a filesystem upgrade is required when updating BookKeeper, the bookie will fail to start and return an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-25 10:41:50,494 - ERROR - [main:Bookie@246] - Directory layout version is less than 3, upgrade needed
+</code></pre></div></div>
<p>BookKeeper provides a utility for upgrading the filesystem. You can perform an upgrade using the <a href="../../reference/cli#bookkeeper-upgrade"><code class="highlighter-rouge">upgrade</code></a> command of the <code class="highlighter-rouge">bookkeeper</code> CLI tool. When running <code class="highlighter-rouge">bookkeeper upgrade</code> you need to specify one of three flags:</p>
@@ -598,27 +593,23 @@
<p>A standard upgrade pattern is to run an upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --upgrade
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--upgrade</span>
+</code></pre></div></div>
<p>…then check that everything is working normally, then kill the bookie. If everything is okay, finalize the upgrade…</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --finalize
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--finalize</span>
+</code></pre></div></div>
<p>…and then restart the server:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper bookie
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
<p>If something has gone wrong, you can always perform a rollback:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper upgrade --rollback
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper upgrade <span class="nt">--rollback</span>
+</code></pre></div></div>
<h2 id="formatting">Formatting</h2>
@@ -626,15 +617,13 @@
<p>By default, formatting is done in interactive mode, which prompts you to confirm the format operation if old data exists. You can disable confirmation using the <code class="highlighter-rouge">-nonInteractive</code> flag. If old data does exist, the format operation will abort <em>unless</em> you set the <code class="highlighter-rouge">-force</code> flag. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell metaformat
+</code></pre></div></div>
<p>You can format the local filesystem data on a bookie using the <a href="../../reference/cli#bookkeeper-shell-bookieformat"><code class="highlighter-rouge">bookieformat</code></a> command on each bookie. Here’s an example:</p>
-<div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
-</code></pre>
-</div>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell bookieformat
+</code></pre></div></div>
<blockquote>
<p>The <code class="highlighter-rouge">-force</code> and <code class="highlighter-rouge">-nonInteractive</code> flags are also available for the <code class="highlighter-rouge">bookieformat</code> command.</p>
@@ -648,13 +637,12 @@
<p>Accidentally replacing disks or removing directories can cause a bookie to fail while trying to read a ledger fragment that, according to the ledger metadata, exists on the bookie. For this reason, when a bookie is started for the first time, its disk configuration is fixed for the lifetime of that bookie. Any change to its disk configuration, such as a crashed disk or an accidental configuration change, will result in the bookie being unable to start. That will throw an error like this:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2017-05-29 18:19:13,790 - ERROR - [main:BookieServer314] – Exception running bookie server : @
org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
.......at org.apache.bookkeeper.bookie.Cookie.verify(Cookie.java:82)
.......at org.apache.bookkeeper.bookie.Bookie.checkEnvironment(Bookie.java:275)
.......at org.apache.bookkeeper.bookie.Bookie.<init>(Bookie.java:351)
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If the change was the result of an accidental configuration change, the change can be reverted and the bookie can be restarted. However, if the change <em>cannot</em> be reverted, such as is the case when you want to add a new disk or replace a disk, the bookie must be wiped and then all its data re-replicated onto it.</p>
@@ -665,21 +653,19 @@ org.apache.bookkeeper.bookie.BookieException$InvalidCookieException
<li>
<p>Run the following command to re-replicate the data:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
<zkserver> <span class="se">\</span>
<oldbookie> <span class="se">\</span>
<newbookie>
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>The ZooKeeper server, old bookie, and new bookie, are all identified by their external IP and <code class="highlighter-rouge">bookiePort</code> (3181 by default). Here’s an example:</p>
- <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>bookkeeper-server/bin/bookkeeper shell recover <span class="se">\</span>
zk1.example.com <span class="se">\</span>
192.168.1.10:3181 <span class="se">\</span>
192.168.1.10:3181
-</code></pre>
- </div>
+</code></pre></div> </div>
<p>See the <a href="../autorecovery">AutoRecovery</a> documentation for more info on the re-replication process.</p>
</li>
diff --git a/content/docs/latest/admin/http/index.html b/content/docs/latest/admin/http/index.html
index 210d6c9..2a122e9 100644
--- a/content/docs/latest/admin/http/index.html
+++ b/content/docs/latest/admin/http/index.html
@@ -560,12 +560,11 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
</table>
</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"configName1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"configName2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue2"</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"configName1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"configName2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"configValue2"</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Response:</p>
@@ -712,13 +711,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"ledgerId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata2"</span><span class="p">,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ledgerId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata2"</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="err">}</span><span class="w">
-</span></code></pre>
- </div>
+ </span><span class="p">}</span><span class="w">
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -780,11 +778,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"ledgerId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ledgerMetadata1"</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -858,13 +855,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"entryId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"entryId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 2"</span><span class="p">,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"entryId1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entryId2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"entry content 2"</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="err">}</span><span class="w">
-</span></code></pre>
- </div>
+ </span><span class="p">}</span><span class="w">
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -934,13 +930,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookieSocketAddress1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname1"</span><span class="p">,</span><span class="w">
- </span><span class="nt">"bookieSocketAddress2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname2"</span><span class="p">,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookieSocketAddress1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"bookieSocketAddress2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname2"</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="err">}</span><span class="w">
-</span></code></pre>
- </div>
+ </span><span class="p">}</span><span class="w">
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -980,14 +975,13 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free:</span><span class="w"> </span><span class="err">xxx,</span><span class="w"> </span><span class="err">total:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
- </span><span class="nt">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free:</span><span class="w"> </span><span class="err">xxx,</span><span class="w"> </span><span class="err">total:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">,</span><span class="w"> </span><span class="err">total</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
+ </span><span class="s2">"bookieAddress"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">free</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">,</span><span class="w"> </span><span class="err">total</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">},</span><span class="w">
</span><span class="err">...</span><span class="w">
- </span><span class="nt">"clusterInfo"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">total_free:</span><span class="w"> </span><span class="err">xxx,</span><span class="w"> </span><span class="err">total:</span><span class="w"> </span><span class="err">xxx</span><span class="p">}</span><span class="w">
+ </span><span class="s2">"clusterInfo"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="err">total_free</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">,</span><span class="w"> </span><span class="err">total</span><span class="p">:</span><span class="w"> </span><span class="err">xxx</span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1027,13 +1021,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="err">JournalId1</span><span class="w"> </span><span class="err">:</span><span class="w"> </span><span class="err">position1,</span><span class="w">
- </span><span class="err">JournalId2</span><span class="w"> </span><span class="err">:</span><span class="w"> </span><span class="err">position2,</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="err">JournalId</span><span class="mi">1</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="err">position</span><span class="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="err">JournalId</span><span class="mi">2</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="err">position</span><span class="mi">2</span><span class="p">,</span><span class="w">
</span><span class="err">...</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1095,13 +1088,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"journal files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="p">,</span><span class="w">
- </span><span class="nt">"entrylog files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2..."</span><span class="p">,</span><span class="w">
- </span><span class="nt">"index files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"journal files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entrylog files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2..."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"index files"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="s2">"filename1 filename2 ..."</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1150,13 +1142,12 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<ul>
<li>Description: Ledger data recovery for failed bookie</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_src1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_src2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
- </span><span class="nt">"bookie_dest"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_dest1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_dest2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
- </span><span class="nt">"delete_cookie"</span><span class="p">:</span><span class="w"> </span><span class="err"><bool_value></span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_src1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_src2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"bookie_dest"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"bookie_dest1"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bookie_dest2"</span><span class="err">...</span><span class="w"> </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"delete_cookie"</span><span class="p">:</span><span class="w"> </span><span class="err"><bool_value></span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Parameters:</p>
@@ -1284,11 +1275,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="err">[ledgerId1,</span><span class="w"> </span><span class="err">ledgerId2...]</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="p">[</span><span class="err">ledgerId</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="err">ledgerId</span><span class="mi">2</span><span class="err">...</span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1328,11 +1318,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<li>
<p>Response Body format:</p>
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"Auditor"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname/hostAddress:Port"</span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"Auditor"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hostname/hostAddress:Port"</span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
</ul>
</li>
@@ -1410,11 +1399,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<ul>
<li>Description: Set lostBookieRecoveryDelay value in seconds.</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"delay_seconds"</span><span class="p">:</span><span class="w"> </span><span class="err"><delay_seconds></span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"delay_seconds"</span><span class="p">:</span><span class="w"> </span><span class="err"><delay_seconds></span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Parameters:</p>
@@ -1474,11 +1462,10 @@ To use this feature, set <code class="highlighter-rouge">httpServerEnabled</code
<ul>
<li>Description: Decommission Bookie, Force trigger Audit task and make sure all the ledgers stored in the decommissioning bookie are replicated.</li>
<li>Body:
- <div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nt">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="err"><bookie_src></span><span class="w">
+ <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"bookie_src"</span><span class="p">:</span><span class="w"> </span><span class="err"><bookie_src></span><span class="w">
</span><span class="p">}</span><span class="w">
-</span></code></pre>
- </div>
+</span></code></pre></div> </div>
</li>
<li>
<p>Parameters:</p>
diff --git a/content/docs/latest/api/javadoc/index-all.html b/content/docs/latest/api/javadoc/index-all.html
index 2e59383..a1089f2 100644
--- a/content/docs/latest/api/javadoc/index-all.html
+++ b/content/docs/latest/api/javadoc/index-all.html
@@ -4105,8 +4105,6 @@
<dd> </dd>
<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/PendingReadLacOp.html#maxLac">maxLac</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/PendingReadLacOp.html" title="class in org.apache.bookkeeper.client">PendingReadLacOp</a></dt>
<dd> </dd>
-<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/PendingReadOp.html#maxMissedReadsAllowed">maxMissedReadsAllowed</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/PendingReadOp.html" title="class in org.apache.bookkeeper.client">PendingReadOp</a></dt>
-<dd> </dd>
<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/ReadLastConfirmedAndEntryOp.html#maxMissedReadsAllowed">maxMissedReadsAllowed</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/ReadLastConfirmedAndEntryOp.html" title="class in org.apache.bookkeeper.client">ReadLastConfirmedAndEntryOp</a></dt>
<dd> </dd>
<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/WeightedRandomSelection.html#maxProbabilityMultiplier">maxProbabilityMultiplier</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/WeightedRandomSelection.html" title="class in org.apache.bookkeeper.client">WeightedRandomSelection</a></dt>
@@ -4344,9 +4342,9 @@
<dd> </dd>
<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/conf/ClientConfiguration.html#NUM_WORKER_THREADS">NUM_WORKER_THREADS</a></span> - Static variable in class org.apache.bookkeeper.conf.<a href="org/apache/bookkeeper/conf/ClientConfiguration.html" title="class in org.apache.bookkeeper.conf">ClientConfiguration</a></dt>
<dd> </dd>
-<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/LedgerHandle.html#numEnsembleChanges">numEnsembleChanges</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></dt>
+<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#numBookiesMissingEntry">numBookiesMissingEntry</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html" title="class in org.apache.bookkeeper.client">PendingReadOp.LedgerEntryRequest</a></dt>
<dd> </dd>
-<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#numMissedEntryReads">numMissedEntryReads</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html" title="class in org.apache.bookkeeper.client">PendingReadOp.LedgerEntryRequest</a></dt>
+<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/LedgerHandle.html#numEnsembleChanges">numEnsembleChanges</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></dt>
<dd> </dd>
<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/ReadLastConfirmedAndEntryOp.ReadLACAndEntryRequest.html#numMissedEntryReads">numMissedEntryReads</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/ReadLastConfirmedAndEntryOp.ReadLACAndEntryRequest.html" title="class in org.apache.bookkeeper.client">ReadLastConfirmedAndEntryOp.ReadLACAndEntryRequest</a></dt>
<dd> </dd>
@@ -5261,6 +5259,8 @@
<dd> </dd>
<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/impl/BookKeeperBuilderImpl.html#requestTimer-io.netty.util.HashedWheelTimer-">requestTimer(HashedWheelTimer)</a></span> - Method in class org.apache.bookkeeper.client.impl.<a href="org/apache/bookkeeper/client/impl/BookKeeperBuilderImpl.html" title="class in org.apache.bookkeeper.client.impl">BookKeeperBuilderImpl</a></dt>
<dd> </dd>
+<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/PendingReadOp.html#requiredBookiesMissingEntryForRecovery">requiredBookiesMissingEntryForRecovery</a></span> - Variable in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/PendingReadOp.html" title="class in org.apache.bookkeeper.client">PendingReadOp</a></dt>
+<dd> </dd>
<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/client/LedgerHandle.html#rereadMetadata-org.apache.bookkeeper.proto.BookkeeperInternalCallbacks.GenericCallback-">rereadMetadata(BookkeeperInternalCallbacks.GenericCallback<LedgerMetadata>)</a></span> - Method in class org.apache.bookkeeper.client.<a href="org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></dt>
<dd> </dd>
<dt><span class="memberNameLink"><a href="org/apache/bookkeeper/conf/AbstractConfiguration.html#REREPLICATION_ENTRY_BATCH_SIZE">REREPLICATION_ENTRY_BATCH_SIZE</a></span> - Static variable in class org.apache.bookkeeper.conf.<a href="org/apache/bookkeeper/conf/AbstractConfiguration.html" title="class in org.apache.bookkeeper.conf">AbstractConfiguration</a></dt>
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerRecoveryOp.RecoveryReadOp.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerRecoveryOp.RecoveryReadOp.html
index 10ed8d3..4d31997 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerRecoveryOp.RecoveryReadOp.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerRecoveryOp.RecoveryReadOp.html
@@ -168,7 +168,7 @@ extends <a href="../../../../org/apache/bookkeeper/client/ListenerBasedPendingRe
<!-- -->
</a>
<h3>Fields inherited from class org.apache.bookkeeper.client.<a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html" title="class in org.apache.bookkeeper.client">PendingReadOp</a></h3>
-<code><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#complete">complete</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#endEntryId">endEntryId</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#isRecoveryRead">isRecoveryRead</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#lh">lh</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#maxMissedReadsAllowed">maxMissedReadsAllo [...]
+<code><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#complete">complete</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#endEntryId">endEntryId</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#isRecoveryRead">isRecoveryRead</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#lh">lh</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#numPendingEntries">numPendingEntries</a>, [...]
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.org.apache.bookkeeper.common.util.SafeRunnable">
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/ListenerBasedPendingReadOp.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/ListenerBasedPendingReadOp.html
index 4ddce4b..1c2d061 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/ListenerBasedPendingReadOp.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/ListenerBasedPendingReadOp.html
@@ -171,7 +171,7 @@ extends <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html" ti
<!-- -->
</a>
<h3>Fields inherited from class org.apache.bookkeeper.client.<a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html" title="class in org.apache.bookkeeper.client">PendingReadOp</a></h3>
-<code><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#complete">complete</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#endEntryId">endEntryId</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#isRecoveryRead">isRecoveryRead</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#lh">lh</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#maxMissedReadsAllowed">maxMissedReadsAllo [...]
+<code><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#complete">complete</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#endEntryId">endEntryId</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#isRecoveryRead">isRecoveryRead</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#lh">lh</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#numPendingEntries">numPendingEntries</a>, [...]
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.org.apache.bookkeeper.common.util.SafeRunnable">
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html
index 1c63da3..160530e 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html
@@ -164,7 +164,7 @@ implements <a href="../../../../org/apache/bookkeeper/client/SpeculativeRequestE
</tr>
<tr class="rowColor">
<td class="colFirst"><code>(package private) int</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#numMissedEntryReads">numMissedEntryReads</a></span></code> </td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#numBookiesMissingEntry">numBookiesMissingEntry</a></span></code> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>(package private) int</code></td>
@@ -319,13 +319,13 @@ implements <a href="../../../../org/apache/bookkeeper/client/SpeculativeRequestE
<pre>int firstError</pre>
</li>
</ul>
-<a name="numMissedEntryReads">
+<a name="numBookiesMissingEntry">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>numMissedEntryReads</h4>
-<pre>int numMissedEntryReads</pre>
+<h4>numBookiesMissingEntry</h4>
+<pre>int numBookiesMissingEntry</pre>
</li>
</ul>
<a name="ensemble">
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.ParallelReadRequest.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.ParallelReadRequest.html
index 5000e3d..58fff58 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.ParallelReadRequest.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.ParallelReadRequest.html
@@ -152,7 +152,7 @@ extends <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEn
<!-- -->
</a>
<h3>Fields inherited from class org.apache.bookkeeper.client.<a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html" title="class in org.apache.bookkeeper.client">PendingReadOp.LedgerEntryRequest</a></h3>
-<code><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#complete">complete</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#eId">eId</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#ensemble">ensemble</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#entryImpl">entryImpl</a>, <a href="../../../../org/apache/bookkeeper/cli [...]
+<code><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#complete">complete</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#eId">eId</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#ensemble">ensemble</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#entryImpl">entryImpl</a>, <a href="../../../../org/apache/bookkeeper/cli [...]
</ul>
</li>
</ul>
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.SequenceReadRequest.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.SequenceReadRequest.html
index 25acd6b..aa00415 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.SequenceReadRequest.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.SequenceReadRequest.html
@@ -164,7 +164,7 @@ extends <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEn
<!-- -->
</a>
<h3>Fields inherited from class org.apache.bookkeeper.client.<a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html" title="class in org.apache.bookkeeper.client">PendingReadOp.LedgerEntryRequest</a></h3>
-<code><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#complete">complete</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#eId">eId</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#ensemble">ensemble</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#entryImpl">entryImpl</a>, <a href="../../../../org/apache/bookkeeper/cli [...]
+<code><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#complete">complete</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#eId">eId</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#ensemble">ensemble</a>, <a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html#entryImpl">entryImpl</a>, <a href="../../../../org/apache/bookkeeper/cli [...]
</ul>
</li>
</ul>
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.html
index f219ee4..e31ee3d 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/PendingReadOp.html
@@ -186,25 +186,25 @@ implements org.apache.bookkeeper.proto.BookkeeperInternalCallbacks.ReadEntryCall
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#lh">lh</a></span></code> </td>
</tr>
<tr class="altColor">
-<td class="colFirst"><code>(package private) int</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#maxMissedReadsAllowed">maxMissedReadsAllowed</a></span></code> </td>
-</tr>
-<tr class="rowColor">
<td class="colFirst"><code>(package private) long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#numPendingEntries">numPendingEntries</a></span></code> </td>
</tr>
-<tr class="altColor">
+<tr class="rowColor">
<td class="colFirst"><code>(package private) boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#parallelRead">parallelRead</a></span></code> </td>
</tr>
-<tr class="rowColor">
+<tr class="altColor">
<td class="colFirst"><code>(package private) <a href="../../../../org/apache/bookkeeper/stats/OpStatsLogger.html" title="interface in org.apache.bookkeeper.stats">OpStatsLogger</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#readOpLogger">readOpLogger</a></span></code> </td>
</tr>
-<tr class="altColor">
+<tr class="rowColor">
<td class="colFirst"><code>(package private) long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#requestTimeNanos">requestTimeNanos</a></span></code> </td>
</tr>
+<tr class="altColor">
+<td class="colFirst"><code>(package private) int</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#requiredBookiesMissingEntryForRecovery">requiredBookiesMissingEntryForRecovery</a></span></code> </td>
+</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="http://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../org/apache/bookkeeper/client/PendingReadOp.LedgerEntryRequest.html" title="class in org.apache.bookkeeper.client">PendingReadOp.LedgerEntryRequest</a>></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/bookkeeper/client/PendingReadOp.html#seq">seq</a></span></code> </td>
@@ -400,13 +400,13 @@ implements org.apache.bookkeeper.proto.BookkeeperInternalCallbacks.ReadEntryCall
<pre><a href="../../../../org/apache/bookkeeper/stats/OpStatsLogger.html" title="interface in org.apache.bookkeeper.stats">OpStatsLogger</a> readOpLogger</pre>
</li>
</ul>
-<a name="maxMissedReadsAllowed">
+<a name="requiredBookiesMissingEntryForRecovery">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>maxMissedReadsAllowed</h4>
-<pre>final int maxMissedReadsAllowed</pre>
+<h4>requiredBookiesMissingEntryForRecovery</h4>
+<pre>final int requiredBookiesMissingEntryForRecovery</pre>
</li>
</ul>
<a name="isRecoveryRead">
diff --git a/content/docs/latest/api/ledger-adv-api/index.html b/content/docs/latest/api/ledger-adv-api/index.html
index 94e7c8c..49a476c 100644
--- a/content/docs/latest/api/ledger-adv-api/index.html
+++ b/content/docs/latest/api/ledger-adv-api/index.html
@@ -471,17 +471,16 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<p>Here’s an exmaple:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>You can also create advanced ledgers asynchronously.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">LedgerCreationCallback</span> <span class="kd">implements</span> <span class="n">AsyncCallback</span><span class="o">.</span><span class="na">CreateCallback</span> <span class="o">{</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">createComplete</span><span class="o">(</span><span class="kt">int</span> <span class="n">returnCode</span><span class="o">,</span> <span class="n">LedgerHandle</span> <span class="n">handle</span><span class="o">,</span> <span class="n">Object</span> <span class="n">ctx</span><span class="o">)</span> <span class="o">{</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Ledger successfully created"</span><span class="o">);</span>
<span class="o">}</span>
@@ -495,12 +494,11 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="k">new</span> <span class="nf">LedgerCreationCallback</span><span class="o">(),</span>
<span class="s">"some context"</span>
<span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>Besides the APIs above, BookKeeper allows users providing <code class="highlighter-rouge">ledger-id</code> when creating advanced ledgers.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">ledgerId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// the ledger id is generated externally.</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
<span class="n">LedgerHandleAdv</span> <span class="n">handle</span> <span class="o">=</span> <span class="n">bkClient</span><span class="o">.</span><span class="na">createLedgerAdv</span><span class="o">(</span>
@@ -508,8 +506,7 @@ It allows user passing in an <code class="highlighter-rouge">entryId</code> when
<span class="mi">3</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="c1">// replica settings</span>
<span class="n">DigestType</span><span class="o">.</span><span class="na">CRC32</span><span class="o">,</span>
<span class="n">passwd</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<blockquote>
<p>Please note, it is users’ responsibility to provide a unique ledger id when using the API above.
@@ -519,7 +516,7 @@ a <a href="../javadoc/org/apache/bookkeeper/client/BKException.BKLedgerExistExce
<p>Creating advanced ledgers can be done throught a fluent API since 4.6.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">BookKeeper</span> <span class="n">bk</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">byte</span><span class="o">[]</span> <span class="n">passwd</span> <span class="o">=</span> <span class="s">"some-passwd"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">();</span>
@@ -534,28 +531,25 @@ a <a href="../javadoc/org/apache/bookkeeper/client/BKException.BKLedgerExistExce
<span class="o">.</span><span class="na">execute</span><span class="o">()</span> <span class="c1">// execute the creation op</span>
<span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// wait for the execution to complete</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<h3 id="add-entries">Add Entries</h3>
<p>The normal <a href="ledger-api/#adding-entries-to-ledgers">add entries api</a> in advanced ledgers are disabled. Instead, when users want to add entries
to advanced ledgers, an entry id is required to pass in along with the entry data when adding an entry.</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
<span class="n">ledger</span><span class="o">.</span><span class="na">addEntry</span><span class="o">(</span><span class="n">entryId</span><span class="o">,</span> <span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>If you are using the new API, you can do as following:</p>
-<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="n">WriteHandle</span> <span class="n">wh</span> <span class="o">=</span> <span class="o">...;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">WriteHandle</span> <span class="n">wh</span> <span class="o">=</span> <span class="o">...;</span>
<span class="kt">long</span> <span class="n">entryId</span> <span class="o">=</span> <span class="o">...;</span> <span class="c1">// entry id generated externally</span>
<span class="n">wh</span><span class="o">.</span><span class="na">write</span><span class="o">(</span><span class="n">entryId</span><span class="o">,</span> <span class="s">"Some entry data"</span><span class="o">.</span><span class="na">getBytes</span><span class="o">()).</span><span class="na">get</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>A few notes when using this API:</p>
diff --git a/content/docs/latest/api/ledger-api/index.html b/content/docs/latest/api/ledger-api/index.html
index 10f0130..ca79c82 100644
--- a/content/docs/latest/api/ledger-api/index.html
+++ b/content/docs/latest/api/ledger-api/index.html
@@ -473,7 +473,7 @@
<p>If you’re using <a href="https://maven.apache.org/">Maven</a>, add this to your <a href="https://maven.apache.org/guides/introduction/introduction-to-the-pom.html"><code class="highlighter-rouge">pom.xml</code></a> build configuration file:</p>
-<div class="language-xml highlighter-rouge"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
<span class="nt"><bookkeeper.version></span>4.7.0-SNAPSHOT<span class="nt"></bookkeeper.version></span>
<span class="c"><!-- in your <dependencies> block --></span>
@@ -482,43 +482,13 @@
<span class="nt"><artifactId></span>bookkeeper-server<span class="nt"></artifactId></span>
<span class="nt"><version></span>${bookkeeper.version}<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div></div>
<p>BookKeeper uses google <a href="https://github.com/google/protobuf/tree/master/java">protobuf</a> and <a href="https://github.com/google/guava">guava</a> libraries
a lot. If your application might include different versions of protobuf or guava introduced by other dependencies, you can choose to use the
shaded library, which relocate classes of protobuf and guava into a different namespace to avoid conflicts.</p>
-<p>You can use the shaded artifact of <code class="highlighter-rouge">bookkeeper-server</code>. Please note that <a href="https://maven.apache.org/plugins/maven-shade-plugin">maven-shade-plugin</a> doesn’t generate
-a dependency-reduced pom file for shaded artifact using <a href="https://maven.apache.org/plugins/maven-shade-plugin/examples/attached-artifact.html">shadedArtifactAttached</a>. You need to manually to exclude relocated packages when using the shaded artifact. Full example of how to use this is
-showed as below.</p>
-
-<div class="language-xml highlighter-rouge"><pre class="highlight"><code><span class="c"><!-- in your <properties> block --></span>
... 1996 lines suppressed ...
--
To stop receiving notification emails like this one, please contact
git-site-role@apache.org.