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 libxml2-dev libxslt1-dev
3. Create database config to qa-reports/config/database.yml (example exists by name database.example.yml)
4. Install gem rack to get what's needed to be able to use the git version: $ gem install rack

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