User Tools

Site Tools


Sidebar

tutorials:redmine

This is an old revision of the document!


= Redmine =

* Install and configure Redmine on Debian

Installation

* Debian GNU/Linux Testing (squeeze) repositories contain a Redmine package. If you are using Debian GNU/Linux Lenny (stable version), make sure you add a testing repository in sources.list}

deb http://ftp.ro.debian.org/debian testing main contrib non-free
deb-src http://ftp.ro.debian.org/debian testing main contrib non-free

* Update packages & install Redmine using apt-get}:

rosedu:~# apt-get update
rosedu:~# apt-get install redmine

* In the configuration dialog, I prefer selecting an sqlite3 database as there is no need for a database daemon or configuration overhead. * In case of using Debian GNU/Linux Lenny, I sugest uncommeting the above lines from sources.list}.

Configuration

* Important files/folders: redmine} - Redmine installation folder redmine} - Redmine configuration folder default} - default Redmine instance configuration folder database.yml} - default Redmine instance database configuration file default.conf} - default Redmine instance dbconfig configuration file redmine} - Redmine Debian documentation

Apache2 integration

* Use sample configuration file to Apache2 conf.d} folder (I'm using an Apache2 host) (apache2-alias}) * Update configuration file to suit your needs. * Make sure mod_rewrite} and mod_fcgid} are enabled:

rosedu:/usr/share/doc/redmine# a2enmod rewrite
Module rewrite already enabled
rosedu:/usr/share/doc/redmine# a2enmod fcgid
Module fcgid already enabled

= Old Redmine installation tutorial =

* This tutorial draft is part of the work of installing Redmine from source on a Debian GNU/Linux Testing (squeeze) system.

System settings

* Debian GNU/Linux Testing (squeeze)

ixlabs:~# cat /etc/issue
Debian GNU/Linux squeeze/sid \n \l

* kernel 2.6.30, CPU Pentium 4 2.66GHz, 1GB RAM

ixlabs:~# uname -a
Linux ixlabs 2.6.30-2-686 #1 SMP Sat Sep 26 01:16:22 UTC 2009 i686 GNU/Linux

ixlabs:~# lscpu
Architecture:          i686
CPU(s):                1
Thread(s) per core:    1
Core(s) per socket:    1
CPU socket(s):         1
Vendor ID:             GenuineIntel
CPU family:            15
Model:                 4
Stepping:              1
CPU MHz:               2666.887
L1d cache:             16K
L2 cache:              1024K

ixlabs:~# free -m
             total       used       free     shared    buffers     cached
Mem:           470        441         29          0         67        188
-/+ buffers/cache:        186        284
Swap:         3835         11       3823

* Apache 2.2.14

ixlabs:~# apache2 -v       
Server version: Apache/2.2.14 (Debian)
Server built:   Sep 29 2009 19:02:20
Scripts

* The scripts used throughout the process are stored in this Git repository.

Installation steps

Install Packages

apt-get install ruby rubygems ruby-dev libgemplugin-ruby libruby-extras rails rake subversion git-core libapache2-svn

Download Redmine

* I'm using Subversion to checkout the latest stable branch as described on the Redmine download page.

mkdir -p $FULL_CHECKOUT_PATH
svn co http://redmine.rubyforge.org/svn/branches/0.8-stable $FULL_CHECKOUT_PATH

* full_checkout_path} is the root folder for the Redmine instance; it's redmine-0.8} in my case.

Configuration steps

Update Rails version

* The current Redmine stable version (0.8.6, on October 14, 2009) defaults to using Rails 2.1.2. * My Debian (squeeze) installation uses Rails 2.2.3

ixlabs:~/repo-admin/ixlabs/redmine# dpkg -l rails
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Inst/Cfg-files/Unpacked/Failed-cfg/Half-inst/trig-aWait/Trig-pend
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
||/ Name           Version        Description
+++-==============-==============-============================================
ii  rails          2.2.3-1        MVC ruby based framework geared for web appl

* I have to comment out the ruby_gem_version} variable definition in environment.rb} to use the latest installed version

#RAILS_GEM_VERSION = '2.1.2' unless defined? RAILS_GEM_VERSION

Configure the database

* I'm using MySQL as database backend. * First step is creating the database:

mysql> create database redmine;
Query OK, 1 row affected (0.00 sec)

mysql> grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'om0Tayui';
Query OK, 0 rows affected (0.00 sec)

mysql> flush privileges;
Query OK, 0 rows affected (0.00 sec)

* I'm using the following script to configure the database for Redmine:



tutorials/redmine.1267816704.txt.gz · Last modified: 2010/03/05 21:18 by razvan