Getting your Development Environment up and running

This guide has been written with Ubuntu Linux and Window users in mind. Mac users reading are encouraged to document any significant differences for your platform.

1.) Install Ruby on Rails and Rubygems
Currently, the project is working against Rails version 2.2.2

On Ubuntu Linux: http://articles.slicehost.com/2009/1/6/ubuntu-intrepid-ruby-on-rails On Windows (1-click installer): http://rubyforge.org/forum/forum.php?forum_id=24905

2.) Install sqlite3 and sqlite3’s ruby bindings

On Ubuntu Linux: aptitude install libsqlite3-ruby gem install sqlite3-ruby On Windows: First we will install the bindings for sqlite3. At time writing there is a problem installing the current version of sqlite3-ruby (1.2.4) on Windows. Thus you should install a slightly older version like this ` gem install sqlite3-ruby -v 1.2.3 ` For more details see http://stackoverflow.com/questions/43778/sqlite3-ruby-gem-failed-to-build-gem-native-extension ` Install sqlite3 http://bigdiver.wordpress.com/2007/12/31/ruby-on-rails-2x-with-sqlite-3-on-windows/

3.) Install required gems: rubyist-aasm, rspec-rails and wvanbergen-scoped_search

On Ubuntu Linux/Windows platform: gem install rspec-rails gem sources -a http://gems.github.com This allows you to install gems published on Github (required for next step). Read the info at http://gems.github.com for more information gem install wvanbergen-scoped_search gem install rubyist-aasm

4.) Get the code from github – another guide will be coming soon!!!

5.) Once you have the code retrieved you need create the basic development databases

On Ubuntu Linux/Windows platform: At the command line execute setup the database structure via rake db:migrate ` Then seed the database with some basic dummy records via rake db:seed ` Hopefully all that’s left to do is go to the root of your application and start the web server via ./script/server

To troubleshoot any issues you have you can post an email to http://groups.google.com/group/ruby_ireland

Finally, commands that are your friend:

gem list This tells you what gems you have installed on your machine gem list —remote —all sqlite This tells you what versions of gems you can install from the gem repositories you are tracking (in this case sqlite)