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 50859cc Updated site at revision 029e8e0e0
50859cc is described below
commit 50859cc9fb44cb5fd7ddc9855e57cd8eed145454
Author: jenkins <[email protected]>
AuthorDate: Sat Oct 26 04:30:09 2019 +0000
Updated site at revision 029e8e0e0
---
content/docs/latest/deployment/manual/index.html | 38 +++++++++++-------------
1 file changed, 17 insertions(+), 21 deletions(-)
diff --git a/content/docs/latest/deployment/manual/index.html
b/content/docs/latest/deployment/manual/index.html
index 775d157..b8de9f9 100644
--- a/content/docs/latest/deployment/manual/index.html
+++ b/content/docs/latest/deployment/manual/index.html
@@ -521,9 +521,9 @@
<p>We won’t provide a full guide to setting up a ZooKeeper cluster here. We
recommend that you consult <a
href="https://zookeeper.apache.org/doc/current/zookeeperAdmin.html";>this
guide</a> in the official ZooKeeper documentation.</p>
-<h2 id="starting-up-bookies">Starting up bookies</h2>
+<h2 id="cluster-metadata-setup">Cluster metadata setup</h2>
-<p>Once your ZooKeeper cluster is up and running, you can start up as many
<span class="pop" id="bookie-popover">bookies</span> as you’d like to form a
cluster. Before starting up each bookie, you need to modify the bookie’s
configuration to make sure that it points to the right ZooKeeper cluster.</p>
+<p>Once your ZooKeeper cluster is up and running, there is some metadata that
needs to be written to ZooKeeper, so you need to modify the bookie’s
configuration to make sure that it points to the right ZooKeeper cluster.</p>
<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
[...]
@@ -534,15 +534,26 @@
<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>
</blockquote>
-<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>
+<p>Once the bookie’s configuration is set, you can 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"><div class="highlight"><pre
class="highlight"><code><span class="nv">$ </span>bin/bookkeeper bookie
+<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>
+
<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>
+ <p>The <code class="highlighter-rouge">metaformat</code> command performs
all the necessary ZooKeeper cluster metadata tasks and thus only needs to be
run <em>once</em> and from <em>any</em> bookie in the BookKeeper cluster.</p>
</blockquote>
+<p>Once cluster metadata formatting has been completed, your BookKeeper
cluster is ready to go!</p>
+
+<h2 id="starting-up-bookies">Starting up bookies</h2>
+
+<p>Before you start up your bookies, you should make sure that all bookie
hosts have the correct configuration, then you can start up as many <span
class="pop" id="bookie-popover">bookies</span> as you’d like to form a cluster
by 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"><div class="highlight"><pre
class="highlight"><code><span class="nv">$
</span>bookkeeper-server/bin/bookkeeper bookie
+</code></pre></div></div>
+
<h3 id="system-requirements">System requirements</h3>
<p>The number of bookies you should run in a BookKeeper cluster depends on the
quorum mode that you’ve chosen, the desired throughput, and the number of
clients using the cluster simultaneously.</p>
@@ -568,21 +579,6 @@
<p>Increasing the number of bookies will enable higher throughput, and there
is <strong>no upper limit</strong> on the number of bookies.</p>
-<h2 id="cluster-metadata-setup">Cluster metadata setup</h2>
-
-<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"><div class="highlight"><pre
class="highlight"><code><span class="nv">$ </span>bin/bookkeeper shell
metaformat
-</code></pre></div></div>
-
-<p>You can run in the formatting</p>
-
-<blockquote>
- <p>The <code class="highlighter-rouge">metaformat</code> command performs
all the necessary ZooKeeper cluster metadata tasks and thus only needs to be
run <em>once</em> and from <em>any</em> bookie in the BookKeeper cluster.</p>
-</blockquote>
-
-<p>Once cluster metadata formatting has been completed, your BookKeeper
cluster is ready to go!</p>
-
<!--
## AutoRecovery
@@ -602,9 +598,9 @@
<h2 class="title">Manual deployment</h2>
<ul class="section-nav">
<li class="toc-entry toc-h2"><a href="#zookeeper-setup">ZooKeeper
setup</a></li>
+<li class="toc-entry toc-h2"><a href="#cluster-metadata-setup">Cluster
metadata setup</a></li>
<li class="toc-entry toc-h2"><a href="#starting-up-bookies">Starting up
bookies</a></li>
<li class="toc-entry toc-h3"><a href="#system-requirements">System
requirements</a></li>
-<li class="toc-entry toc-h2"><a href="#cluster-metadata-setup">Cluster
metadata setup</a></li>
</ul>
</div>
