-
Notifications
You must be signed in to change notification settings - Fork 12
Getting started
With this guide you will be able to start a simple BookKeeper cluster and a simple HerdDB cluster in order to have all that you need to use BlobIt. BlobIt is mostly a layer on top BookKeeper so all you need is a working BookKeeper cluster, and you also have to provide an HerdDB database to store metadata, and you will need a ZooKeeper cluster as well (BookKeeper and HerdDB need it).
We are releasing a convenience binary package which allows you to start:
- A ZooKeeper server (standalone mode, not suitable for production)
- A BlobIt server, that is an HerdDB server + a Bookie
You can start as many BlobIt servers are you want, as long as they share the same ZooKeeper cluster they will join the group automatically and this will enable you to scale horizontally without any particular configuration.
Download a binary from the releases page on GitHub.
Unzip:
unzip blobit-services-XXX-zip cd blobit-services-XXXX
Start a ZooKeeper server
bin/service zookeeper start tail -f zookeeper.service.log
Start a BlobIt server
bin/service server start tail -f server.service.log
Since 0.2.0 we are shipping a simple CLI which lets you play with BlobIt, currently it is not intended for production use but it helps you understand how BlobIt works.
Create a Bucket:
bin/blobit.sh createbucket --bucket foo bin/blobit.sh listbuckets
Upload a file
bin/blobit.sh put --bucket foo --name myfile.txt --in path-to-an-existing-file.txt
Download it:
bin/blobit.sh get --bucket foo --name myfile.txt --out path-to-an-non-existing-file-path.txt