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

Récupérer les sources de Redmine par SVN :

cd ~
svn checkout http://redmine.rubyforge.org/svn/tags/0.7.3/

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

cd ~/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"

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 ~/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 :

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 :

sudo rm -rf ~/0.7.3

Lancer Redmine :

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

Once WEBrick has started, point your browser to http://localhost:3000/. You should now see the application welcome page.

8. Use default administrator account to log in:

• login: admin
• password: admin

You can go to Admin & Settings to modify application settings.