ZooKeeper setup

We won’t provide a full guide to setting up a ZooKeeper cluster here. We recommend that you consult this guide in the official ZooKeeper documentation.

Starting up bookies

Once your ZooKeeper cluster is up and running, you can start up as many bookies 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.

On each bookie host, you need to download the BookKeeper package as a tarball. Once you’ve done that, you need to configure the bookie by setting values in the bookkeeper-server/conf/bk_server.conf config file. The one parameter that you will absolutely need to change is the zkServers parameter, which you will need to set to the ZooKeeper connection string for your ZooKeeper cluster. Here’s an example:

zkServers=100.0.0.1:2181,100.0.0.2:2181,100.0.0.3:2181

A full listing of configurable parameters available in bookkeeper-server/conf/bk_server.conf can be found in the Configuration reference manual.

Once the bookie’s configuration is set, you can start it up using the bookie command of the bookkeeper CLI tool: