What is redmine?

Redmine is an open source, web-based project management and bug-tracking tool. It includes calendar and gantt charts to aid visual representation of projects and their deadlines. It supports multiple projects. Redmine is a FOSS solution which provides integrated project management features, issue tracking, and support for multiple version control options.

For more information: http://www.redmine.org

Installation

Foreword

In this walkthrough you will see several 'variables', you'll have to substitute them to suit your needs. You can safely "export" them in your shell environment if you wish.

In particular:

• DBNAME: is the database name
  • this walkthrough assumes you will be using MySQL
• DOCROOT: where Redmine will be unpacked
  • this walkthrough assumes that Redmine will be installed in: ~/public_html/binaryhelix.org/default

Retrieving Redmine

At the time of writing, the latest release of Redmine is 0.8.6. Redmine can be retrieved from: http://rubyforge.org/frs/?group_id=1850 In particular we'll be using: http://rubyforge.org/frs/download.php/66633/redmine-0.8.6.tar.gz

So let's get it started:

lvillani@mire:~$ cd public_html/binaryhelix.org/default
lvillani@mire:~/public_html/binaryhelix.org/default$ wget http://rubyforge.org/frs/download.php/66633/redmine-0.8.6.tar.gz
lvillani@mire:~/public_html/binaryhelix.org/default$ tar xf redmine-0.8.6.tar.gz
lvillani@mire:~/public_html/binaryhelix.org/default$ ls
redmine-0.8.6  redmine-0.8.6.tar.gz

Updating gems

Now we'll need to update some of the "gems" installed on HCoop servers. Please note that we'll be installing those gems inside your home directory thus wasting a little bit of space.

Let's update both rake and rails:

lvillani@mire:~$ gem install --install-dir $HOME/.gem --no-ri --no-rdoc -y rake
lvillani@mire:~$ gem install --install-dir $HOME/.gem --no-ri --no-rdoc -y rails -v=2.1.2

The stuff will be installed inside ~/.gem.

Now, in order to use the new rake and rails command we need to prepend ~/.gem/bin to the PATH. Assuming that you are using the bash shell, open ~/.bashrc (create it if it doesn't exist) and add:

export PATH="$HOME/.gem/bin:$PATH"

We will also need to tell ruby where to find the ruby libraries we've just installed, this is done by exporting the GEM_HOME environment variable. Add the following to your ~/.bashrc:

export GEM_HOME="$HOME/.gem"

Now make sure that the new settings are loaded in your current shell:

lvillani@mire:~$ . ~/.bashrc

Verify that you are actually using the latest rake:

lvillani@mire:~$ rake -V
rake, version 0.8.7

Database

To setup the database please follow instructions at: MemberManual/Databases#MySQL