#pragma section-numbers off
<<TableOfContents>>

= 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]]