Install and run RapidFTR v1.0 on OSX with Ruby 1.8

To get RapidFTR running on your machine while it's in a dev environment, you'll need to install the following:

CouchDB

• Preferred method is to install the Native Mac App directly from Apache CouchDB Website
• You can also install via homebrew: brew install -v couchdb, but this is generally not recommended as it takes very long to install and compile erlang+couch, with the potential to run into many problems

[Optional] Newer libxml2

• Nokogiri, a dependency of webrat and cucumber, will complain about the version that comes with OSX.
• If you use Macports, run: port install libxml2
• If you use homebrew, run: brew install libxml2

ImageMagick

• Macports: port install imagemagick
• Homebrew: brew install imagemagick

XCode and Command Line Tools

• Install XCode
• From XCode → Preferences, install Command Line Tools

Git

• Git should be bundled with the command line tools
• If not, See GitHub's advice here
• Clone our GitHub Repository: git clone git://github.com/rapidftr/RapidFTR.git

Ruby 1.8.7 via RVM

• We recommend "RVM":http://rvm.beginrescueend.com/ and a dedicated "RVM gemset":http://rvm.beginrescueend.com/gemsets/ for RapidFTR
• Follow RVM's "install instructions":http://rvm.beginrescueend.com/rvm/install/.
• You need Apple GCC to compile Ruby 1.8.7:
  • Homebrew: brew install apple-gcc42
  • Macports: port install apple-gcc42
• Install Ruby 1.8.7 by running one of these:
  

  CC=/usr/local/bin/gcc-4.2 rvm install 1.8.7
  (or)
  rvm install 1.8.7 --with-gcc=clang

• If you have RVM correctly configured, then just cd <path-to-rapidftr-codebase>, RVM will automatically create and use a gemset
• Otherwise, run: rvm --create use 1.8.7rapidftr@

To run RapidFTR:

• Clone this RapidFTR git repo
• Run `bundle install`
• Follow Initial Seeding and Running