Comment installer Redmine ?

Ce tutoriel montre comment installer Redmine 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).

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.

• Copie vers /opt/ :

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

• Définition des droits :

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

• Nettoyage :

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 par défaut 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.

• (fr) La documentation de Redmine sur Ubuntu-fr

Auteur : v0n.