Setting up Taskboard

How to install and run Taskboard

Currently we only support install instructions for Linux machines (tested on Ubuntu) as some required Ruby native extensions (juggernaut) do not work well on Windows.

The guide is prepared for Ubuntu (Debian). If you have a different distribution of Linux you have to change the command “sudo aptitude install” with the specific for your OS.

System dependencies

You can skip these steps if you have all the required software installed already.

Ruby on Rails

As Taskboard is a Ruby on Rails application you need to have Ruby and Rails installed on your machine.

1. Install Ruby (recomended version is 1.8.7)

   sudo aptitude install ruby ruby-dev libopenssl-ruby rdoc

2. Download Ruby Gems from here and install it ( >= 1.3.2, recomended version is 1.3.5)
   
   Change ‘x’ below to your version number
   
   

   tar xvfz rubygems-1.3.×.tgz
   
   cd rubygems-1.3.x
   
   sudo ruby setup.rb
   
   sudo ln -s /usr/bin/gem1.8 /usr/bin/gem

3. Install Rails gem

   sudo gem install -v=2.3.5 rails

Database (MySQL)

Taskboard also needs some database to keep it’s data in, so you will need to set-up one also. By default we use MySQL but any database that works with Rails will be OK.

1. To install MySQL will all needed stuff:

   sudo aptitude install mysql-server mysql-client libmysqlclient15-dev

2. To install MySQL support for Ruby:

   sudo gem install mysql

Other

To install some gems you will need build tools

sudo aptitude install build-essential

To download the source directly from repository you will need Git installed

sudo aptitude install git-core

Setting up the Taskboard application

Getting the source

1. Download the source from GitHub or clone repository

   git clone git://github.com/CognifideLabs/taskboard.git

2. Go to taskboard directory (all the commands below should be run from there)

   cd taskboard

Configuration

1. Create configuration files

   cp config/database.example.yml config/database.yml
   
   cp config/juggernaut.example.yml config/juggernaut.yml
   
   cp config/juggernaut_hosts.example.yml config/juggernaut_hosts.yml
   
   cp config/taskboard.example.yml config/taskboard.yml

2. Read and edit configuration for juggernaut server

    gedit config/juggernaut.yml

3. Read and edit configuration between rails application and juggernaut server

    gedit config/juggernaut_host.yml

4. Taskboard allows to import tasks directly from JIRA, to use that feature you need to specify url, username and password:

    gedit config/taskboard.yml 

Install dependency gems

1. Install all plugins

   sudo rake gems:install

Preparing the database

1. Make sure that details in config/database.yml are correct (database hosts, logins, passwords, etc)
2. Run scripts to create databases

   rake db:create:all

3. Run all migrations to prepare databases

   rake db:migrate

Running the Taskboard app

1. Run juggernaut server

   juggernaut -c config/juggernaut.yml

2. Run Taskboard server in new terminal

   script/server

3. Launch your browser and open address: localhost:3000
4. Default user and password is taskboard / taskboard
5. Have fun!