J'ai besoin d'... installer l'outil de gestion de projets Redmine sous Windows

Redmine est un outil de gestion de projets à la Trac ou Mantis. Il fournit une interface graphique Web très agréable. Je l’utilise depuis plus d’un an pour la gestion des projets au travail et j’en suis très satisfait. Depuis peu, j’ai réalisé une installation sur un nouveau serveur et je profite de ce billet pour décrire les étapes de cette installation.

Redmine est développé en Ruby et je présente un manuel d’installation pour Windows et le SGBD PostgreSQL.

Le plan de cette installation est le suivant

  • Téléchargement
  • Pré-requis logiciels
  • Pré-installation
    • Ruby
    • RubyGems
    • Ruby modules
    • Préparation de la base de données
  • Installation
  • Utilisation Apache 2.2 comme Proxy

Téléchargement

La distribution officielle de Redmine est disponible à cette adresse (http://rubyforge.org/frs/?group_id=1850).

Pré-requis logiciels

Vous devez installer et configurer les outils suivant avant d’installer Redmine.

  • Ruby (procédure d’installation est décrite dans ce billet) ;
  • Apache 2.2 HTTP ;
  • PostgreSQL 8.2.

Pré-installation / Ruby

Ruby est un langage open-source dynamique qui met l’accent sur la simplicité et la productivité. Sa syntaxe élégante en facilite la lecture et l’écriture : http://www.ruby-lang.org/fr.

Pour l’installation, la version 1.8.6 a été utilisée.

  • Télécharger le langage de programmation Ruby à cette adresse : http://www.ruby-lang.org/.

  • Exécuter l’outil d’installation.

Pré-installation / RubyGems

RubyGems est l’outil de gestion de package de Ruby.

  • Télécharger le package RubyGems (http://rubyforge.org/frs/?group_id=126).

  • Extraire l’archive dans un répertoire temporaire.

  • Ouvrir un invite de commande, se placer dans le répertoire créé précédemment et exécuter l’instruction suivante.

1
ruby setup.rb

Pré-installation / Ruby Modules

Certains modules pour le langage Ruby doivent être installés (prise en compte de PostgreSQL par exemple), exécuter l’instruction suivante.

1
gem install rails mongrel mongrel\_cluster postgres-pr mongrel\_service

Pré-installation / Préparation de la base de données

Les instructions suivantes concernent le SGBD PostgreSQL.

  • Créer un utilisateur Redmine.
1
createuser redmine --no-superuser --no-createdb --no-createrole --login --pwprompt --encrypted -U postgres  
  • Créer un nouveau schéma de base de données.
1
createdb --owner=redmine --encoding=utf-8 redmine -U postgres

Installation

  • Décompresser l’archive de Redmine dans un répertoire d’installation (exemple : d:\tools\redmine).

  • Créer une copie du fichier database.yml.example en le renommant database.yml.

  • Modifier le contenu du fichier database.yml file de façon à paramétrer les informations de connexion à la base de données.

1
2
3
4
5
6
7
production:
adapter: postgresql
database: redmine
host: localhost
username: redmine
password: redmine
encoding: utf8
  • Ouvrir un invite de commande Windows, se placer dans le répertoire de Redmine et suivre les instructions suivantes.

  • Pour initialiser la session.

1
rake config/initializers/session\_store.rb
  • Pour utiliser la configuration de production.
1
rake db:migrate RAILS\_ENV="production"
  • Pour paramétrer la configuration de production.
1
rake redmine:load\_default\_data RAILS\_ENV="production"
  • À la question relative au langage, choisir l’option fr.

  • Créer une copie du fichier email.yml.example en le renommant email.yml.

  • Modifier le contenu du fichier email.yml file de façon à paramétrer les informations d’envoi d’emails.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
production:  
delivery\_method: :smtp  
smtp\_settings:  
address: "monserveur.email.fr"  
port: 25  
domain: "monserveur.email.fr"  
authentication: :plain  
  
development:  
delivery\_method: :smtp  
smtp\_settings:  
address: "monserveur.email.fr"  
port: 25  
domain: "monserveur.email.fr"  
authentication: :plain  
  • Démarrer le serveur Ruby via la commande suivante.
1
mongrel\_rails start --environment=production
  • Pour tester l’application Redmine, ouvrir un navigateur et saisir l’URL suivante.

http://localhost:3000

Utiliser Apache 2.2 comme Proxy

  • Créer ou mettre à jour le fichier http-proxy.conf situé dans le répertoire apache/conf.

  • Saisir le contenu suivant en l’adaptant à votre configuration.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
LoadModule proxy\_module modules/mod\_proxy.so  
LoadModule proxy\_http\_module modules/mod\_proxy\_http.so  
ProxyRequests Off  
<proxy>  
Order deny,allow  
Allow from all  
</proxy>  
  
Alias /redmine "D:/tools/redmine/public"  
<directory>  
Options Indexes FollowSymLinks  
AllowOverride none  
Order allow,deny  
Allow from all  
</directory>  
  
ProxyPass /redmine/images !  
ProxyPass /redmine/stylesheets !  
ProxyPass /redmine/javascripts !  
ProxyPass /redmine/ http://127.0.0.1:4000/  
ProxyPass /redmine http://127.0.0.1:4000/  
ProxyPassReverse /redmine/ http://127.0.0.1:4000/  
  • Ajouter à la fin du fichier httpd.conf d’Apache 2.2, l’instruction suivante.
1
Include conf/http-proxy.conf  
  • S’assurer que l’instruction suivante est dé-commentée dans le fichier httpd.conf.
1
LoadModule alias\_module modules/mod\_alias.so  
  • Démarrer le serveur Ruby via l’instruction suivante.
1
mongrel\_rails start --environment=production -p 4000
  • Vérifier que l’URL http://localhost/redmine fonctionne. Seule la première page s’affiche. Par ailleurs, les images ne s’affichent pas correctement.

  • Arrêter le serveur Ruby.

  • Se déplacer à la racine du répertoire Redmine et exécuter la ligne de commande suivante.

1
ruby script/plugin install http://svn.napcsweb.com/public/reverse\_proxy\_fix
  • À la question de l’URL, saisir l’URL complète (exemple : http://monserveur/redmine).

  • À la question de la version de Rails, sélectionner la valeur 2.0, 2.1, 2.2.

  • Pour installer Redmine comme un service Windows, exécuter l’instruction suivante à partir du répertoire Redmine.

1
mongrel\_rails service::install -N Redmine -p 4000 -e production
  • À partir du panneau d’administration de Windows, activer le démarrage automatique du service Redmine de telle sorte que l’application Redmine se lance au démarrage de Windows.
Ce billet est open source. Vous avez noté un problème de typographie ?
Ou quelque chose d'obscur ? Améliorer ce billet à partir du dépôt GitHub.

Je suis Mickaël BARON Ingénieur de Recherche en Informatique 💻 au @LIAS_LAB le jour 🌞
Responsable de zones #Java sur @javaDeveloppez la nuit 🌚
❤️ #Java #Docker #VueJS #Eclipse #Services #WebSemantic