This is a self-contained demo that spins up the Zombie Inverted-Index demo on the same VM as the Vagrant Ruby Client environment.
While this app is well-designed, this project is not designed for production use. Do not use this in production.
- Read the Riak Zombie Revival blog post
- See the app live on AWS (which uses our 2.1.1 AMI)
Note on Internets: An Internet connection is required to run vagrant up
. If you want to spin up the demo and save it for later, run the initial vagrant up
mentioned below and then vagrant suspend
to save it. You can run vagrant resume
when you're ready to demo (no connection required).
- If you haven't got it, install Vagrant.
- If you haven't got it or another Vagrant-supported virtualization package, install VirtualBox.
- Clone this repo:
git clone https://github.com/basho-labs/vagrant-zombie-riak.git
cd
into this repo:cd vagrant-zombie-riak
- Run
vagrant up
to start the VM build process. - Wait a while.
- Riak KV is now running in a virtual machine, listening for protobuffs on localhost:17017, and HTTP at http://localhost:17018/
- The fully-functional zombie demo is available at http://localhost:8080/
This instance has:
- Takes up 2GB of memory to support Riak and the zombie app. 1GB didn't cut it.
- Yokozuna full-text search (or "yz") enabled. I use this to test the client's yz support, as well as other gems that also use yz search. To support yz, the Oracle JVM is installed. Yokozuna uses the "yokozuna" bucket type.
- Active Anti-Entropy enabled. This has a bit of disk and IO overhead, but is necessary for yz.
- LevelDB backend configured; 2i works, kv and yz data persist. The disk usage may grow, in which case, destroy and re-up the VM.
- allow_mult enabled by default, because I need to test how the client handles sibling resolution and CRDTs.
- Bucket types for Set, Counter, and Map CRDTs. They're called "sets", "counters", and "maps" respectively.
- Security for protocol buffers is configured but not completely enabled. The configured user has the username "user" and the password "password". There's also "certuser" identified by a client cert (which ships with the ruby-client ).
###Enabling and Disabling Security
Enabling:
your-machine> vagrant ssh
Welcome to Ubuntu 12.04.1 LTS (GNU/Linux 3.2.0-29-virtual x86_64)
vagrant@precise64:~$ sudo riak-admin security enable
Enabled
Disabling:
your-machine> vagrant ssh
Welcome to Ubuntu 12.04.1 LTS (GNU/Linux 3.2.0-29-virtual x86_64)
vagrant@precise64:~$ sudo riak-admin security disable
Disabled
Review the details in CONTRIBUTING.md in order to give back to this project.
Note that projects that extend on this repository will be linked to in the vagrant-riak-meta. Share them via issues on the Community repo!
Copyright (c) 2015 Basho Technologies, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.