Product tutorials, how-tos, and fully-documented APIs.

Riak CS FAQs

    What is Riak CS?

    Riak CS is multi-tenant cloud storage software for public and private clouds. Built on Basho's distributed database Riak, Riak CS is commercial software designed to provide simple, available, distributed cloud storage at any scale. Riak CS is S3-API compatible and supports per-tenant reporting for billing and metering use cases.

    Can users share data?

    Data is by default private. Users can manipulate ACLs (Access Control Lists) to grant access for their buckets or objects to other users, or even unauthenticated requesters.

    For implementation details see the Access Control Lists documentation.

    Is it possible to specify a file system where my Riak CS buckets will live?

    You can specify the location of all Riak CS bucket data by changing the settings for Riak's backends to a path on a particular filesystem. If this is your goal, you can configure Riak to suit your environment.

    If you look at our example Riak app.config backend definition from the Configuring Riak section, it looks like this:

    {add_paths, ["/usr/lib/riak-cs/lib/riak_moss-X.Y.Z/ebin"]},
    {storage_backend, riak_cs_kv_multi_backend},
    {multi_backend_prefix_list, [{<<"0b:">>, be_blocks}]},
    {multi_backend_default, be_default},
    {multi_backend, [
      {be_default, riak_kv_eleveldb_backend, [
        {max_open_files, 50},
          {data_root, "/var/lib/riak/leveldb"}
      ]},
        {be_blocks, riak_kv_bitcask_backend, [
          {data_root, "/var/lib/riak/bitcask"}
      ]}
    ]},
    

    What you need to change are the two data_root values, substituting /var/lib/riak as shown in the above example with the path to the filesystem you prefer. Please note that you should do this before starting Riak for the first time; if you do make these changes after you've started Riak, the previous data will not be available unless you manually move it to to the new location.

    This will allow you to change the location of all bucket data. Riak CS does not yet currently support specifying per bucket filesystem granularity.