[TUTORIAL] Installation de Redmine avec Apache, le tout sur une Debian Lenny (5.0)

[Kawo]

La nouvelle Debian 5.0 (Lenny) est sortie le 14 Février dernier.

Voici une nouvelle version de mon précédent tuto (Installation de Redmine avec Apache, le tout sur une Debian Etch) basée sur l'actuelle Debian stable.

Globalement pas beaucoup de changement dans la procédure, si ce n'est que tout les paquets peuvent maintenant être installés depuis les dépôts de Lenny directement au lieu de passer par les backports ou la compilation. Il y a néanmoins quelques nuances, à ne pas lire en diagonal donc ;)

Présentation

Redmine est un gestionnaire de projets très "web 2.0" (design épuré, ajax, interactions). Il permet donc, comme sa description l'indique, de faire du suivi de projets (roadmap, gantt, assistance) mais pas seulement. On peut le faire interagir avec un contrôleur de versions (sont supportés actuellement subversion, darcs, mercurial, cvs, bazaar, git et filesystem) et, par exemple, lier automatiquement un ticket d'assistance avec un commit.
Il inclut aussi un système de forums et de wiki, spécifiques à chaque projets.

Redmine est écrit en Ruby et utilise le framework Ruby On Rails (RoR ou Rails pour les intimes). Seulement, pour faire tourner ce genre d'application, il faut utiliser un serveur spécifique capable d'interpréter le Rails (webrick ou mongrel pour les plus connus).

Le problème c'est que bien souvent on a un Apache qui tourne derrière avec généralement du PHP et tout le toutim. L'objectif est donc de faire marcher Redmine avec Apache, histoire d'avoir une plate-forme homogène, et que l'on ait pas besoin de jongler avec les ports (par défaut, un serveur Rails écoute le port 3000 ou 8000).
Ce tutorial est très spécifique à la Debian 5.0 Lenny, mais le principe reste le même pour les autres distro.

Note : je n'aborde pas ici la sécurisation du serveur, il est bien évident qu'il ne faudra pas laisser par exemple phpmyadmin libre d'accès comme ça.

I. Installation du serveur LAMP

Si vous avez déjà un LAMP qui tourne, vous pouvez passer directement à l'étape suivante.
Pour installer un LAMP, debian-way :

# aptitude update && aptitude install apache2 mysql-server php5 libapache2-mod-php5 php5-mysql php5-mcrypt

Voilà, finit.

On effectue une première sécurisation basique du serveur MySQL :

# mysql_secure_installation

Laissez les réponses par défaut (sauf pour la création du mot de passe root au début, normalement vous l'avez déjà fait lorsque vous avez installé le paquet mysql).

Un petit tweak au passage pour MySQL : marre d'avoir le charset par défaut "latin1_swedish_ci" ? Simple, il suffit d'éditer le fichier :

/etc/mysql/my.cnf

Puis ajoutez dans la section [mysqld] les lignes suivantes :

init-connect='SET NAMES utf8'
character-set-server=utf8
collation-server=utf8_general_ci

(changez avec le charset voulu si vous n'utilisez pas l'utf-8)

N'oubliez pas de redémarrer MySQL :

# /etc/init.d/mysql restart

On teste Apache :
http://www.votredomaine.tld
devrait vous renvoyer vers la page par défaut de Apache ("It works!").

On teste PHP et MySQL :

# aptitude install phpmyadmin

http://www.votredomaine.tld/phpmyadmin
Vous devriez avoir une page de login. Testez avec le compte root (ou un autre si vous en avez créé un). Si tout marche que c'est que PHP et MySQL sont bien installés.

On va maintenant créé un utilisateur de base qui accueillera Redmine plus tard :

# useradd -d /home/cequevousvoulez -g 33 -m -s /bin/bash login_voulu

-d /home/cequevousvoulez indique la home du user (elle peut avoir un nom différent du login)
-g 33 force le user à appartenir au groupe qui a la GID 33, c'est à dire Apache (indispensable pour les permissions sur le serveur web)
-m dit qu'il faut créer la home
-s /bin/bash indique le shell du user, en l'occurrence la ça sera bash
login_voulu c'est le login (ou le nom) de l'utilisateur

Ensuite il faut lui créer un mot de passe :

# passwd login_voulu

Vérifiez si tout est ok :

# ls -al /home
drwxr-xr-x 11 root root 4096 2008-08-19 20:20 .
drwxr-xr-x 22 root root 4096 2008-08-17 22:56 ..
drwxr-xr-x 3 login_voulu www-data 4096 2008-08-18 17:44 cequevousvoulez

La home est bien créée avec les bons droits, impeccable.

II. Installation de Rails

La encore, avec la nouvelle Debian Lenny 5.0, on va pouvoir utiliser la debian-way pour installer nos paquets.

Installation des paquets ruby nécessaires :

# aptitude install ruby rdoc irb libyaml-ruby ruby1.8-dev libzlib-ruby ri libopenssl-ruby1.8

Il va falloir maintenant installer rubygems, le gestionnaire de paquets interne à ruby.

Je disais que grâce à Lenny on pouvait tout installer sans utiliser de dépôts tiers, j'ai un peu menti Nous avons besoin de la version 1.3.1 de RubyGems alors que la version dans Lenny est la 1.2.0 :

# cd /root
# wget http://rubyforge.org/frs/download.ph...gems-1.3.1.tgz
# tar xvzf rubygems-1.3.1.tgz
# cd rubygems-1.3.1
# ruby setup.rb

On va aussi créer un lien symbolique pour éviter les erreurs de certains PATH codés en dur :

# ln -s /usr/bin/gem1.8 /usr/bin/gem

Bien. Notre environnement est prêt à accueillir Redmine.

Contrairement à mon ancien tuto, je vais être plus prudent cette fois et utiliser une version release de Redmine.
En effet, le développement étant devenu très actif ces dernières semaines, il y a beaucoup de changements dans les dépendances selon la révision du trunk.
Vous pouvez toujours utiliser la version trunk mais faites attention aux dépendances (à vérifier : http://www.redmine.org/wiki/redmine/RedmineInstall notamment).

Au moment où je rédige cet article, l'actuelle version release est la 0.8.2 (si ce n'est plus le cas quand vous attaquerez ce tuto, vérifiez dans le lien donné juste au dessus si il y a des changements de dépendances).

Cette version requiert :
- Ruby 1.8.6 ou 1.8.7 (on est bon avec Lenny : 1.8.7)
- RubyGems 1.3.1 (on est bon)
- Rails 2.1.2 (voir plus bas)

Il nous manque donc Rails 2.1.2 :

# gem install rails -v 2.1.2

Et voilà !

Il nous reste deux petites choses à installer. D'abord le link ruby->mysql :

# aptitude install libmysqlclient15-dev
# gem install mysql

Ensuite il nous faut le paquet imagemagick et son link ruby->RMagick pour que Redmine puisse générer les graphiques de Gantt :

# aptitude install imagemagick libmagick9-dev librmagick-ruby1.8
# gem install rmagick

Voilà ! Rails est bien installé et correctement configurer, on va passer à l'étape suivante.

III. Installation de Redmine

Comme je l'ai dis plus haut, nous allons utiliser cette fois une version release de Redmine. Actuellement c'est la 0.8.2.

On se place dans la home de l'utilisateur créé plus haut :

# cd /home/cequevousvoulez

On change d'utilisateur pour éviter de foutre la merde dans les permissions :

# su login_voulu

Vous voilà identifié en tant que login_voulu, on peut maintenant récupérer Redmine :

$ wget http://rubyforge.org/frs/download.ph...e-0.8.2.tar.gz

On va configurer la connexion à la base de données (n'oubliez donc pas de créer un utilisateur et une base pour Redmine) :

$ cd redmine/config
$ cp database.yml.example database.yml
$ nano database.yml

Renseignez les champs de la section PRODUCTION.

Ensuite nous allons initialiser la base :

$ rake db:migrate RAILS_ENV="production"

Tout est ok normalement. On va maintenant remplir la base avec les données par défaut :

$ rake redmine:load_default_data RAILS_ENV="production"

Voilà, Redmine est installé.

Premier test pour voir si tout marche bien. Assurez-vous d'être dans le répertoire racine de redmine (ici c'est donc "redmine") puis :

$ ruby script/server -e production

Ceci lance le serveur intégré Webrick sur le port 3000. Direction votre site pour tester :
http://www.votredomaine.tld:3000
Vous devriez normalement arriver sur la page d'accueil de Redmine. Si ce n'est pas le cas vérifiez que vous avez bien suivi toutes les étapes.
Si vous avez une erreur du type "500 internal error" il y a 99% de chance que ça vienne des permissions qui ont sautées. Vérifiez que toute l'arborescence appartienne bien à login_voulu:www-data. Si ce n'est pas le cas un petit :

# chown -R login_voulu:www-data /home/cequevousvoulez

devrait tout remettre en ordre.

Redmine marche c'est bien. Par contre il marche indépendamment de Apache pour l'instant. Étape suivante donc :p

IV. Servir du rails via Apache

Nous allons maintenant installer le vrai serveur pour Rails (Webrick sert surtout au debug, à ne surtout pas mettre en prod). Pour cela nous allons installer Mongrel :

# gem install gem_plugin mongrel mongrel_cluster

Ensuite nous allons créer le fichier de configuration qui dira à Mongrel quel site il faut faire tourner :

# mongrel_rails cluster::configure -e production -p 8000 -N 3 -c /home/cequevousvoulez/redmine -C /home/cequevousvoulez/redmine/config/mongrel_cluster.yml -a 127.0.0.1 --user login_voulu --group www-data

-e production indique que le serveur doit tourner en mode production
-p 8000 lance Mongrel sur le port 8000
-N 3 indique qu'il y aura 3 instances du serveur
-c /home/... le chemin vers la racine de redmine
-C /home/... le chemin vers où le fichier de configuration va être créé
-a dit à Mongrel d'écouter le localhost

Vérifiez que le fichier de config a bien été créé et est bien rempli :

# nano /home/cequevousvoulez/redmine/config/mongrel_cluster.yml

devrait afficher un truc du genre :

---
group: www-data
address: 127.0.0.1
log_file: log/mongrel.log
port: "8000"
cwd: /home/cequevousvoulez/redmine
environment: production
user: login_voulu
pid_file: tmp/pids/mongrel.pid
servers: 3

Bien. Maintenant il faut indiquer à Mongrel où trouver ce fichier de config. Par défaut il va chercher dans /etc/mongrel_cluster. Ce répertoire n'existe pas nous allons donc le créer :

# mkdir /etc/mongrel_cluster

Ensuite, plutôt que de copier le fichier de conf créé juste avant, on va y faire un lien symbolique (pratique si on lance plusieurs Redmine):

# ln -s /home/cequevousvoulez/redmine/config/mongrel_cluster.yml /etc/mongrel_cluster/monsite.yml

On installe le script qui va permet de gérer Mongrel (et de le démarrer automatiquement au boot notamment) :

# cp /usr/lib/ruby/gems/1.8/gems/mongrel_cluster-1.0.5/resources/mongrel_cluster /etc/init.d/

On le modifie par rapport à nos besoins (voir les commentaires ajoutés) :

#!/bin/bash

#
# Copyright (c) 2007 Bradley Taylor, bradley@railsmachine.com
#
# mongrel_cluster Startup script for Mongrel clusters.
#
# chkconfig: - 85 15
# description: mongrel_cluster manages multiple Mongrel processes for use \
# behind a load balancer.
#
CONF_DIR=/etc/mongrel_cluster # chemin vers lequel Mongrel cherche les fichiers de config
PID_DIR=/home/cequevousvoulez/redmine/tmp/pids # chemin vers le dossier pids créé plus haut
USER=login_voulu # le user
RETVAL=0
# Gracefully exit if the controller is missing.
which mongrel_cluster_ctl >/dev/null || exit 0
# Go no further if config directory is missing.
[ -d "$CONF_DIR" ] || exit 0
case "$1" in
start)
# Create pid directory
mkdir -p $PID_DIR
chown $USER:www-data $PID_DIR # modifier cette ligne comme ceci
mongrel_cluster_ctl start -c $CONF_DIR --clean # n'oubliez pas de rajouter --clean
RETVAL=$?
;;
stop)
mongrel_cluster_ctl stop -c $CONF_DIR --clean # pareil
RETVAL=$?
;;
restart)
mongrel_cluster_ctl restart -c $CONF_DIR --clean # pareil
RETVAL=$?
;;
status)
mongrel_cluster_ctl status -c $CONF_DIR
RETVAL=$?
;;
*)
echo "Usage: mongrel_cluster {start|stop|restart|status}"
exit 1
;;
esac
exit $RETVAL

--clean indique à Mongrel qu'il faut supprimer correctement le fichier pid, sinon lors d'un redémarrage du serveur il y aura une erreur du type "pid file locked".

Une fois le fichier modifié, on le rend exécutable :

# chmod +x /etc/init.d/mongrel_cluster

Et on l'injecte dans le système :

# update-rc.d -f mongrel_cluster defaults

Voilà vous pouvez désormais controler le serveur directement avec les commandes :

# /etc/init.d/mongrel_cluster start
# /etc/init.d/mongrel_cluster restart
# /etc/init.d/mongrel_cluster stop

D'ailleurs, lancez le serveur :

# /etc/init.d/mongrel_cluster start

Maintenant on s'occupe de Apache. On active les modules nécessaires :

# a2enmod rewrite
# a2enmod proxy_http
# a2enmod proxy_balancer

Puis on modifie le fichier :

# nano /etc/apache2/mods-available/proxy.conf

Pour qu'il ressemble à ceci :

<IfModule mod_proxy.c>
#turning ProxyRequests on and allowing proxying from all may allow
#spammers to use your proxy to send email.
ProxyRequests Off
<Proxy *>
AddDefaultCharset off
Order allow,deny
Allow from all
#Allow from .example.com
# Define the character set for proxied FTP directory listings
ProxyFtpDirCharset UTF-8
</Proxy>
# Enable/disable the handling of HTTP/1.1 "Via:" headers.
# ("Full" adds the server version; "Block" removes all outgoing Via: headers)
# Set to one of: Off | On | Full | Block
ProxyVia On
</IfModule>

(on modifie en-fait les directives Order et Allow from).

On créé ensuite un VHOST (par exemple) :

# nano /etc/apache2/sites-available/redmine

<VirtualHost *:80>
ServerAdmin admin@votredomaine.tld
ServerName redmine.votredomaine.tld
DocumentRoot /home/cequevousvoulez/redmine/public/

<Directory /home/cequevousvoulez/redmine/public/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>

<Proxy balancer://mongrel_cluster>
BalancerMember http://127.0.0.1:8000
BalancerMember http://127.0.0.1:8001
BalancerMember http://127.0.0.1:8002
</Proxy>

RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} -f
RewriteRule (.*) $1 [L]

ProxyPass / Balancer://mongrel_cluster/
ProxyPassReverse / balancer://mongrel_cluster/

AddOutputFilter DEFLATE text/html text/plain text/xml application/xml application/xhtml+xml text/javascript text/css
BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html

ErrorLog /var/log/apache2/redmine.votredomaine.tld.error.log
LogLevel warn
CustomLog /var/log/apache2/redmine.votredomaine.tld.access.log combined
ServerSignature Off
</VirtualHost>

Ceci va créé un VHOST sur l'url http://redmine.votredomaine.tld (configurez Bind si nécessaire).

La section Proxy balancer indique à Apache de balancer toutes les requêtes venant de redmine.votredomaine.tld:80 sur localhost:8000 qui est justement l'endroit où Mongrel écoute.

Les directives Deflate disent qu'il faut utiliser Apache pour servir les fichiers de type html/css au lieu de Mongrel (le traitement est ainsi beaucoup plus rapide).

On active ce vhost :

# a2ensite redmine

Et on relance Apache pour qu'il prenne tout en compte :

# /etc/init.d/apache2 restart

Et on test l'url http://redmine.votredomaine.tld

Vous devriez voir la page d'accueil de Redmine, bravo !

Mises à jour

11/03/2009
- Première version du tuto :)

[Yapadeliss]

Bonjour,
Merci beaucoup pour ce tuto.
Cependant j'ai deux petites questions.
J'ai installé redmine, sur une gentoo. Tout fonctionne bien, hormis l'envoie de mail. Lorsque je m'envoie un mail, via la commande mail pas de souci je le reçois. En revanche depuis redmine, rien.
Y a t' il un moyen de débuger cela ?

La seconde question m'embarrasse plus. Ajouter un user et demander son authentification via ldap. Pas de pb ca marche.
Mais comment peut on le supprimer ? J'ai passé en revue toutes les options, je n'ai rien trouvé.

Merci d'avance.

[Kawo]

Coucou,

Question bête mais comme tu n'as pas précisé : as tu configuré ton serveur mail dans le fichier email.yml ?

Est-ce que ton serveur mail utilise le ssl/tls ? Si c'est le cas je te renvois à ce message : http://www.admincafe.re/forums/showp...9&postcount=24

Pour le ldap par-contre je ne pourrais pas t'aider : je ne l'utilise pas.

[Yapadeliss]

J'avais bien configuré email.yml en m'appuyant sur l'exemple.
Sauf que j'ai fais une faute de frappe. Ca marche maintenant.

Il ne me reste plus à savoir comment supprimer un utilisateur ? Je sais c'est idiot mais je ne trouve pas de bouton corbeille ou autre dans la gestion des utilisateurs.

[Kawo]

Ah si tu parles de supprimer un utilisateur dans Redmine, ce n'est pas possible. Tu peux au mieux le verrouiller mais pas le supprimer (sinon le faire manuellement dans la base de données).

Je ne sais pas trop pourquoi c'est comme ça d'ailleurs. J'imagine que c'est en rapport avec la gestion des tickets ou autre.

[TibO]

Juste pour la petite histoire, tu peux supprimer la ligne chkconfig de ton fichier /etc/init.d/mongrel_cluste, c'est une ligne qui marche pour redhat...

[gorghoa]

Bonjour à tous,
c'est peut être un peu osé de poser ma question ici, mais j'ose ^^

Je suis sur une debian lenny, j'ai suivi le tuto et tout fonctionne au poil jusqu'à webrick qui m'a permis d'aprcevoir un redmine qui fonctionne.

Là ou je patague c'est apparemment avec apache ou mongrel.
Car une fois mongre_cluster lancé (sans queconques message d'erreur)
apache redémarré,
impossible d'accéer à redmine via monserveur.tld:3000 ou monserveur.tld:8000 (pas de connexion alors que firewall et routage ok)
redmine.monserveur.tld renvoie à la racine de /var/www/ d'apache...
je suis un peu dans le flou et n'ai pas trouvé de solution on the web qui aurait fonctionné pour moi.

J'ai peut être une piste avec les ports qu'écouterait apache2 genre
listen 3000
ou listen 8000

mais si c'est ca, je ne sais pas ou le mettre car c'a me met des erreurs au restart d'apache et l'empêche de démarrer.

merci d'avance et merci pour ce tuto.

à bientôt
Gorghoa

PS, s'il faut ouvrir un sujet pour ca dites moi.

[Kawo]

Bonjour,

As-tu déjà configuré le proxy balancer sur Apache ?

Si ce n'est pas le cas encore, as-tu essayé l'url : redmine.tonserveur.com:8000 ?

Peux-tu afficher le contenu de l'hote virtuel que tu as créé pour Redmine ici stp ?

[gorghoa]

bonjour,
Merci de prendre le temps de me répondre.

Effectivement je n'ai jamais configuré le proxy balancer d'apache.

redmine.barosofts.dyndns.org:8000 bloque un navigateur sur "chargement de la page en cours" (epiphany et elinks) en local (/etc/hosts renseignés.). Firefox en externe quand à lui met une erreur de chargement.

les permission sur /opt/redmine sont user:ww-data

<VirtualHost *:80>
#ServerAdmin admin@votredomaine.tld
ServerName redmine.barosofts.dyndns.org
DocumentRoot /opt/redmine/public/

<Directory /opt/redmine/public/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>

<Proxy balancer://mongrel_cluster>
BalancerMember http://127.0.0.1:8000
BalancerMember http://127.0.0.1:8001
BalancerMember http://127.0.0.1:8002
</Proxy>

RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} -f
RewriteRule (.*) $1 [L]

ProxyPass / Balancer://mongrel_cluster/
ProxyPassReverse / balancer://mongrel_cluster/

AddOutputFilter DEFLATE text/html text/plain text/xml application/xml application/xhtml+xml text/javascript text/css
BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html

ErrorLog /var/log/apache2/redmine.votredomaine.tld.error.log
LogLevel warn
CustomLog /var/log/apache2/redmine.votredomaine.tld.access.log combined
ServerSignature Off
</VirtualHost>

merci encore.


Edit : y'a t-il un moyen de savoir que quelque chose tourne effectivement sur le port 8000 ?
ci joint mongrel_cluster status

barosofts:/home/doddo/.scripts# /etc/init.d/mongrel_cluster status
Checking all mongrel_clusters...
mongrel_rails cluster::status -C monsite.yml
found pid_file: tmp/pids/mongrel.8000.pid
found mongrel_rails: port 8000, pid 6223

found pid_file: tmp/pids/mongrel.8001.pid
found mongrel_rails: port 8001, pid 6228

found pid_file: tmp/pids/mongrel.8002.pid
found mongrel_rails: port 8002, pid 6231

[Kawo]

D'après le mongrel status c'est OK, mais tu peux aussi vérifier avec un "netstat -l" (par exemple).

Ton site donne effectivement un timeout.

Si tu n'utilises pas le proxy apache comme dans le tuto, il ne faut pas passer par lui (apache). Le proxy sert justement à faire le lien entre Apache et Mongrel.

Si tu souhaites seulement utiliser mongrel comme il me semble avoir compris, il faut que tu détruises cet hôte virtuel (apache ne doit plus du tout gérer le répertoire de redmine). Tu pourras ensuite accéder à ton serveur directement depuis ton_adresse_ip:8000.