This is an old revision of the document!
= Redmine =
* Install and configure Redmine on Debian
* 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}.
* 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
* 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
* Restart Apache in order to deploy the configuration.
# /etc/init.d/apache2 restart
* The default administrative account is admin (default password is admin}) * After logging in, it is advised to update the admin} account, change password etc. * Go to administration_-_information} for a quick checklist of the installation. * You should browse the administration_-_settings} menu and configure basic setting for the Redmine installation.
* Go to administration_-_settings_-_authentication}. * Click on the LDAP authentication link and fill required fields. For my particular LDAP installation, I filled the following: Name: swarm.cs.pub.ro LDAP authentication Host: swarm.cs.pub.ro Port: 636, LDAPS Account: N/A Password: N/A Base DN: dc=swarm,dc=cs,dc=pub,dc=ro On-the-fly user creation: checked Attributes * Login: uid * Firstname: givenName * Lastname: sn * Email: mail * The on-the-fly user creation option allows users to register into Redmine. You don't have to create a Redmine account. Authentication is going to be handled through LDAP.
* Create an HTTPS-able Virtual Host and add the following line to the HTTP Virtual Host:
Redirect permanent / https://mydomain.com
= 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.
* 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
* The scripts used throughout the process are stored in this Git repository.
apt-get install ruby rubygems ruby-dev libgemplugin-ruby libruby-extras rails rake subversion git-core libapache2-svn
* 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.
* 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
* 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: