Comment installer Redmine ?

Ce tutoriel présente Redmine et montre comment l'installer sur Ubuntu.

Dans ce tutoriel, la version de Redmine installée est la 0.7.3 (dernière version stable à ce jour), choix détaillé plus tard. La base de donnée utilisée est MySQL et le système utilisé est Ubuntu LTS 8.04 Server (Ce tutoriel doit s'appliquer sans soucis sur d'autres versions, sous peine de faire attention aux versions des paquets).

Redmine est un système Open Source de gestion de projet en mode web. Il est développé en ruby grâce au framework ruby on rails.

Les fonctionnalités :

• gestion multi-projets
• gestion fine des droits utilisateurs définis par des rôles
• rapports de bugs, demandes d'évolutions
• Wiki multi-projets
• forums multi-projets
• news accessibles par RSS / ATOM
• notifications par email
• gestion de feuilles de route, GANTT, calendrier
• historique
• intégration avec divers suivis de versions : SVN, CVS, Mercurial, Git, Bazaar & Darcs
• identification possible via LDAP
• multilingue (25 langues disponibles pour la 0.7.0)
• support de plusieurs bases de données : MySQL, PostgreSQL ou SQLite

Pour installer Redmine vous aurez besoin de Ruby, son framework Ruby on Rails et MySQL. Il faut donc installer les paquets rails, mysql-server.

Durant l'installation de MySQL, il sera demandé un mot de passe pour le compte d'administration de MySQL ("root").

Pour des raisons de sécurité, il est préfèrable de créer un utilisateur spécifique à Redmine pour utiliser la base :

sudo addgroup redmine
sudo adduser redmine --no-create-home --ingroup redmine

Un mot de passe sera demandé pour l'utilisateur redmine.

mysql -u root -p

Entrez le mot de passe pour le compte d'administration de MySQL (demandé à l'installation).

Tapez les requêtes SQL correspondantes :

CREATE DATABASE redmine DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;

La base de données de redmine est créée. Sortez avec :

exit

La version de Redmine qui sera récupérée sera la version 0.7.3 qui est la dernière version stable. De plus, elle nécessite la version 2.0.2 de Rails, version présente par défaut dans les dépôts (Les versions suivantes de Redmine utiliseront Rails 2.1.2).

Télécharger les sources de Redmine dans votre répertoire personnel :

cd ~
wget http://rubyforge.org/frs/download.php/39477/redmine-0.7.3.tar.gz

Extrayez les sources :

tar -zxf redmine-0.7.3.tar.gz

Vous devez vous trouver dans le répertoire des sources de Redmine pour la suite des opérations :

cd ~/redmine-0.7.3

Copier le fichier de configuration :

cp config/database.yml.example config/database.yml

Puis éditez le fichier config/database.yml pour adapter la partie "production" comme ceci :

production:
  adapter: mysql
  socket: /var/run/mysqld/mysqld.sock 
  database: redmine
  host: localhost
  username: redmine
  password: password
  encoding: utf8

rake db:migrate RAILS_ENV="production"

rake load_default_data RAILS_ENV="production"

Le langage sera demandé, pour du français, indiquez donc :

fr

L'installation consiste grossièrement à télécharger les sources dans votre dossier personnel.

Afin de respecter la philosophie GNU/Linux sur l'installation des logiciels (au niveau arborescence), vous ne devez pas laisser un simple dossier de sources dans votre dossier personnel.

Le principe est de déplacer ce dossier dans /opt/. D'autres parts, ceci rendra le logiciel installé pour tous les utilisateurs du système et non seulement pour vous.

Créer un dossier redmine dans le répertoire /opt/ :

sudo mkdir /opt/redmine

Copier les sources vers ce répertoire :

sudo cp -r ~/redmine-0.7.3/* /opt/redmine

Un dossier tmp doit être présent par convention dans les sources (si ce n'est pas déjà le cas) :

sudo mkdir /opt/redmine/tmp

L'utilisateur qui lance Redmine doit avoir les droits d'écriture sur les dossiers files, log et tmp des sources. Nous allons prendre ici l'utilisateur redmine précédement créé :

cd /opt/redmine
sudo chown -R redmine:redmine files log tmp
sudo chmod -R 755 files log tmp

Redmine étant proprement installé, on peut maintenant supprimer les sources du dossier personnel :

rm -rf ~/redmine-0.7.3 ~/redmine-0.7.3.tar.gz

Lancer Redmine :

sudo ruby /opt/redmine/script/server -e production

L'option -d permet de le lancer en démon :

sudo ruby /opt/redmine/script/server -d -e production

Redmine écoute sur le port 3000 et utilise WEBrick. WEBrick est un serveur web libre intégré à Ruby depuis la version 1.8 et utilisé par Ruby on Rails.

Une fois WEBrick démarré, vous pouvez accéder à Redmine via http://adresse_de_votre_serveur:3000/. Vous devez à présent voir la page d'accueil de l'application.

Pour vous connectez, utilisez le compte administrateur par défaut :

• login: admin
• password: admin

Vous pouvez vous rendre dans Administration > Settings pour modifier la configuration de l'application.

Pour pouvoir démarrer, redémarrer, arrêter facilement Redmine, nous aurons besoin d'installer le paquet mongrel. Mongrel est un serveur HTTP écrit en Ruby et en C. Il a été conçu pour être leger, rapide et sécurisé. C'est ce serveur qui sera utiliser désormais pour exécuter Redmine.

Puis il faut créer un script exécutable /etc/init.d/redmine contenant ce code :

#!/bin/sh
 
set -e
 
REDMINE_PATH=/opt/redmine/
REDMINE_PID=tmp/pids/mongrel.pid
REDMINE_PORT=3000
 
if [ -x /usr/bin/mongrel_rails ] ; then
        HAVE_MONGREL=1
else
        echo "Mongrel not installed."
        exit 0
fi
 
. /lib/lsb/init-functions
 
case "$1" in
  start)
        log_action_begin_msg "Starting Redmine server"
        mongrel_rails start -d -e production -p $REDMINE_PORT -c $REDMINE_PATH -P $REDMINE_PID
        log_action_end_msg $?
        ;;
  stop)
        log_action_begin_msg "Stoping Redmine server"
        mongrel_rails stop -c $REDMINE_PATH -P $REDMINE_PID
        log_action_end_msg $?
        ;;
  force-reload|restart)
        $0 stop
        $0 start
        ;;
  *)
        echo "Usage: /etc/init.d/redmine {start|stop|restart|force-reload}"
        exit 1
        ;;
esac
 
exit 0

Ne pas oublier de rendre le script exécutable :

sudo chmod +x /etc/init.d/redmine

À ce point vous pouvez respectivement démarrer, redémarrer et arrêter Redmine à l'aide des commandes suivantes :

sudo /etc/init.d/redmine start
sudo /etc/init.d/redmine restart
sudo /etc/init.d/redmine stop

Pour ajouter Redmine au démarrage de la machine :

sudo update-rc.d redmine defaults

Redmine sera désormais lancé à chaque démarrage de la machine.

• Site officiel du projet Redmine
• Le guide de Redmine : installation, mise à jour, utilisation, etc.
• Démo en ligne de Redmine
• Une fiche descriptive de Redmine

Auteur : v0n.