Quality/QA-tools/QAReports/Setting up the development environment

Introduction

QA Reports is a Ruby on Rails application so you need to install a bunch of stuff to get it up and running. This draft documentation is based on experiences in installation on Ubuntu 10.10

Installing Ruby

Most likely you won't succeed with the packaged version of Ruby. Thus this guide uses Ruby Version Manager (rvm).

1. Install dependencies: $ sudo apt-get install git-core curl
2. Install rvm: $ bash < <( curl http://rvm.beginrescueend.com/releases/rvm-install-head )
3. Follow the instructions printed once installation is ready
   1. Install needed packages - check section "For Ruby (MRI & ree) you should install the following OS dependencies"
   2. Enable loading of rvm - check section "You must now complete the install by loading RVM in new shells"
      1. Edit .bashrc as described
      2. Restart your shell to have rvm enabled
4. Install Ruby: $ rvm install 1.8.7
5. Set into use: $ rvm use 1.8.7

Set up QA Reports

1. Clone qa-reports from git: $ git clone git://gitorious.org/meego-quality-assurance/qa-reports.git
2. Install preqrequisites: $ sudo apt-get install libmysqlclient-dev
3. Create database config to qa-reports/config/database.yml (example exists by name database.example.yml)

Follow the instructions then from qa-reports/README.creole:

1. $ gem update --system
   1. Note: if you get an error about zlib, follow these instructions
2. $ gem install bundler --no-ri --no-rdoc
3. $ bundle install --without staging production
4. $ rake db:create
5. $ rake db:migrate
   1. Failed, but after rerun worked
6. Start the server: $ rails server
   1. And see it fail due to problems with RubyGem rack. TODO: fix this