Build instructions for BookKeeper
Requirements:
- Unix System
- JDK 1.6
- Maven 3.0
- Internet connection for first build (to fetch all dependencies)
The BookKeeper project contains:
- bookkeeper-server (BookKeeper server and client)
- bookkeeper-benchmark (Benchmark suite for testing BookKeeper performance)
- bookkeeper-stats (BookKeeper stats library)
- bookkeeper-stats-providers (BookKeeper stats providers)
BookKeeper is a system to reliably log streams of records. It is designed to
store write ahead logs, such as those found in database or database like
applications.
How do I build?
BookKeeper uses maven as its build system. To build, run "mvn package" from the
top-level directory, or from within any of the submodules.
Useful maven commands are:
- Clean : mvn clean
- Compile : mvn compile
- Run tests : mvn test
- Create JAR : mvn package
- Run findbugs : mvn compile findbugs:findbugs
- Install JAR in M2 cache : mvn install
- Deploy JAR to Maven repo : mvn deploy
- Run Rat : mvn apache-rat:check
- Build javadocs : mvn compile javadoc:aggregate
- Build distribution : mvn package assembly:single
Tests options:
- Use -DskipTests to skip tests when running the following Maven goals:
'package', 'install', 'deploy' or 'verify' - -Dtest=,<TESTCLASSNAME#METHODNAME>,....
- -Dtest.exclude=
- -Dtest.exclude.pattern=/.java,/.java
How do I run the services?
Running BookKeeper service, requires a running ZooKeeper service
(see http://zookeeper.apache.org).
To start a bookkeeper service quickly for testing, run:
$ bookkeeper-server/bin/bookkeeper localbookie 10
This will start a standalone, ZooKeeper instance and 10 BookKeeper bookies.
Note that this is only useful for testing. Data is not persisted between runs.
To start a real BookKeeper service, you must set up a ZooKeeper instance and
run start a bookie on several machines. Modify bookkeeper-server/conf/bk_server.conf
to point to your ZooKeeper instance. To start a bookie run:
$ bookkeeper-server/bin/bookkeeper bookie
You can get more help on using these commands by running:
$ bookkeeper-server/bin/bookkeeper help