Blueflood on OSX

TODO: Move the first part of this page to the 10 Minute Guide as a quick way to get started. Move the installation instructions to Deployment Dependencies, probably. That's where all the other installation instructions are, although a "Dev dependencies" page might be more appropriate.

ARCHIVE: These are old instructions. See Installing From Source instead.

These instructions will get Blueflood set up as a demo with the latest Blueflood release.

Get necessary files

1. Get the latest jar

   curl -s -L https://github.com/rackerlabs/blueflood/releases/latest | egrep -o 'rackerlabs/blueflood/releases/download/rax-release-.*/blueflood-all-.*-jar-with-dependencies.jar' |  xargs -I % curl -C - -L https://github.com/% --create-dirs -o blueflood-all/target/blueflood-all-2.0.0-SNAPSHOT-jar-with-dependencies.jar
   

2. Get various scripts and config files

   ### blueflood-start.sh
   curl -s https://raw.githubusercontent.com/rackerlabs/blueflood/master/bin/blueflood-start.sh --create-dirs -o bin/blueflood-start.sh
   
   ### blueflood.conf
   curl -s https://raw.githubusercontent.com/rackerlabs/blueflood/master/demo/local/config/blueflood.conf --create-dirs -o ./demo/local/config/blueflood.conf
   
   ### blueflood-log4j.properties
   curl -s https://raw.githubusercontent.com/rackerlabs/blueflood/master/demo/local/config/blueflood-log4j.properties --create-dirs -o demo/local/config/blueflood-log4j.properties
   
   ### load.script
   curl -s -O https://raw.githubusercontent.com/rackerlabs/blueflood/enums-feature/src/cassandra/cli/load.cdl
   

3. Make blueflood-start.sh executable

   chmod +x bin/blueflood-start.sh
   

Install Elasticsearch and Cassandra

Elasticsearch

See our page 'setup elasticsearch' for full instructions on setting up Elasticsearch.

Cassandra

We recommend using homebrew (http://brew.sh) to install Cassandra.

1. Install Cassandra

   brew update 
   brew install cassandra
   

2. Turn on RPC server

   sed -i 's/start_rpc: true/start_rpc: false/g' /usr/local/etc/cassandra/cassandra.yaml
   

3. Start automatically and start server

   launchctl load ~/Library/LaunchAgents/homebrew.mxcl.cassandra.plist
   

4. Load the Cassandra schema

   cqlsh -f load.cdl
   

Start Blueflood

1. Yep. Start it!

   bin/blueflood-start.sh
   

Submit, Query and List Metrics

Try it all out by sending and querying some metrics! Check out the 10-minute guide for some examples.

Doing More

We used the latest release jar just to simplify things a bit. Now that you have all the bits working on OSX, you might want to check out the code at https://github.com/rackerlabs/blueflood, make some changes and compile Blueflood from source.