Razvan's wiki

* 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.

* Please check the official page on Redmine LDAP authentication. * 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: