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

• 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

• 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: