RiakJson Installation Options

options.md

Build Riak from source

1. Download a branch of Riak that contains RJ dependencies in rebar.config, and startup changes in reltool.config
2. Run make relclean && make rel
3. Start Riak

Pros

• Least manual commands and configuration

Cons

• Requires full build of fresh Riak to get started

Patch Riak source and build from RiakJson script

1. Download RiakJson
2. Run ./bin/make_riak.sh which does the following
3. Downloads a specific tag of Riak
4. Applies changes to rebar.config and reltool.config
5. Runs make rel on Riak
6. Start Riak

Pros

• Doesn't Require a branch of Riak (can use any exisiting 2.0+ tag)

Cons

• Requires full build of fresh Riak to get started
• Requires a script or multiple install steps

Inject code directly into an existing installation of Riak

1. Download and build riak_json_http + riak_json_wire, or maybe a bridge project which includes both of them
2. Download any version of Riak 2.0+ and build it (we can suggest a tag)
3. Add a -pa </path/to/riak_json_http/ebin> </path/to/riak_json_http/ebin> to riak.conf / vm.args
4. Add a -s riak_json_http riak_json_wire to riak.conf / vm.args
5. Start Riak

Pros

• Will work with an existing installation of Riak

Cons

• Requires manual building of RiakJson instead of Riak
• Requires manual or scripted config changes to Riak + awareness of where the RiakJson code paths are locally