| 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>,<TESTCLASSNAME#METHODNAME>,.... |
| * -Dtest.exclude=<TESTCLASSNAME> |
| * -Dtest.exclude.pattern=**/<TESTCLASSNAME1>.java,**/<TESTCLASSNAME2>.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 |