User Tools

Site Tools


tutorials:redmine

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 /etc/apt/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 /etc/apt/sources.list.

Configuration

  • Important files/folders:
    • /usr/share/redmine/ - Redmine installation folder
    • /etc/redmine/ - Redmine configuration folder
    • /etc/redmine/default/ - default Redmine instance configuration folder
    • /etc/redmine/default/database.yml - default Redmine instance database configuration file
    • /etc/dbconfig-common/redmine/instances/default.conf - default Redmine instance dbconfig configuration file
    • /usr/share/doc/redmine/ - Redmine Debian documentation

Apache2 integration

  • Use sample configuration file to Apache2 conf.d/ folder (I'm using an Apache2 host) (/usr/share/doc/redmine/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

Basic configuration

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

LDAP authentication

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

HTTPS access

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

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

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 /usr/local/lib/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 $FULL_CHECKOUT_PATH/config/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.txt · Last modified: 2010/03/05 23:54 by razvan