QuickStart

QuickStart as of Riak CS 2.1

Make sure you have Basho erlang R16B02bashoX, and if possible, erlang-quickcheck boosts quality because Riak CS includes several QuickCheck tests.

Clone and Build

$ mkdir cs-2.1
$ cd cs-2.1
$ git clone git://github.com/basho/riak_ee -b 2.1
$ git clone git://github.com/basho/stanchion -b 2.1
$ git clone git://github.com/basho/riak_cs -b 2.1
$ make -C riak_ee stage
$ make -C stanchion stage
$ make -C riak_cs stage

Configure

$ sed -i.back 's/storage_backend = bitcask/storage_backend = prefix_multi/' riak_ee/rel/riak/etc/riak.conf
$ echo "buckets.default.allow_mult = true" >> riak_ee/rel/riak/etc/riak.conf
$ echo "buckets.default.merge_strategy = 2" >> riak_ee/rel/riak/etc/riak.conf

If you use MapReduce in Riak (e.g. storage calcualtion), tell Riak CS beam path to Riak, in advanced.config.

{riak_kv, [
  {add_paths, ["/your/abs/path/to/riak_cs/rel/riak_cs/ebin"]}
]},

Start

$ riak_ee/rel/riak/bin/riak start
$ stanchion/rel/stanchion/bin/stanchion start
$ riak_cs/rel/riak_cs/bin/riak_cs start

Create first admin user

$ riak_cs/rel/riak_cs attach
> riak_cs_user:create_user("admin", "[email protected]", "admin-key", "admin-secret").

Then you'll get a new account with its key "admin-key" and secret "admin-secret". Set up you clients like s3cmd S3cmd-Configuration or s3curl Using-s3curl.