Skip to content
The consistent distributed key-value store in Open vStorage.
Branch: 1.9
Clone or download
Pull request Compare This branch is 554 commits ahead of Incubaid:1.8.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea
cfg
ctrl
data
debian
doc
docker
docs
examples
extension
jenkins
pylabs
redhat/SPECS
src
tools
.gitignore
.gitmodules
.merlin
.ocamlinit
.ocp-indent
.travis.yml
CNAME
COMPILING
GITBOOK.md
LIBRARIES
LICENSE
META
Makefile
README.md
SUMMARY.md
_tags
arakoon.odocl
arakoon.opam
arakoon_client.opam
book.json
dune-project
logger_macro.ml
myocamlbuild.ml
opam
report.sh
setup.py
test_it.py
travis.sh

README.md

Arakoon

Arakoon is a distributed key/value store with preference for consistency. More technically, it's a Multi-Paxos implementation (written in OCaml) running on top of TokyoCabinet.

Arakoon is licensed under the Apache License, version 2. For a full license text, see LICENSE.

For more information, see the project homepage at http://arakoon.org.

Building Arakoon

For compilation instructions, see the COMPILING document. Information about the libraries we use is available in LIBRARIES.

Quickstart

Start by building Arakoon. To set up a single-node demo server, a basic configuration file is required, e.g.

$> cat single.ini
[global]
cluster = arakoon_0
cluster_id = ricky

[arakoon_0]
ip = 127.0.0.1
client_port = 4000
messaging_port = 4010
home = /tmp
log_level = info

Now, start the node using

$> ./arakoon.native -config single.ini --node arakoon_0

This starts a single node cluster for you to play with.

You can set and retrieve values from the command line using

$> ./arakoon.native -config examples/single.ini --set hello world
$> ./arakoon.native -config examples/single.ini --get hello
"world"

An overview of all command-line options is available by running arakoon.native --help.

Of course you want to use Arakoon from within a program. We provide OCaml, C and Python clients.

Documentation

For additional information please visit the Arakoon GitBook.

Releases

Arakoon releases are available from the releases page. Any 1.X branch corresponds to the development of releases in the 1.X series.

Have fun,

The Arakoon team

You can’t perform that action at this time.