Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
tutoriel:comment_installer_redmine [Le 19/12/2008, 23:02] v0n |
— (Version actuelle) | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | {{tag>tutoriel BROUILLON}} | ||
- | ====== 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). | ||
- | |||
- | ===== Présentation ===== | ||
- | |||
- | **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 : [[subversion|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]] | ||
- | |||
- | <note>Un article complet le décrivant [[http://www.projet-plume.org/fr/fiche/redmine|ici]].</note> | ||
- | |||
- | ===== Pré-requis ===== | ||
- | |||
- | ==== Paquets nécessaires ==== | ||
- | |||
- | Pour installer Redmine vous aurez besoin de Ruby, son framework Ruby on Rails et MySQL. Il faut donc [[:tutoriel:comment_installer_un_paquet|installer les paquets]] [[apt://rails,mysql-server|rails, mysql-server]]. | ||
- | |||
- | Durant l'installation de MySQL, il sera demandé un mot de passe pour le compte d'administration de MySQL ("//root//"). | ||
- | |||
- | ==== Base de données MySQL ==== | ||
- | |||
- | === Créer un utilisateur spécifique === | ||
- | |||
- | 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. | ||
- | |||
- | <note>Pour la suite du tutoriel, nous considérerons que le mot de passe de l'utilisateur redmine est "//password//".</note> | ||
- | |||
- | === Créer la base de données de 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 : | ||
- | |||
- | <code SQL> | ||
- | CREATE DATABASE redmine DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; | ||
- | </code> | ||
- | |||
- | <code SQL> | ||
- | GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION; | ||
- | </code> | ||
- | |||
- | La base de données de redmine est créée. Sortez avec : | ||
- | |||
- | <code SQL> | ||
- | exit | ||
- | </code> | ||
- | |||
- | ==== Télécharger Redmine ==== | ||
- | |||
- | 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 | ||
- | |||
- | ===== Configuration de Redmine et MySQL ===== | ||
- | |||
- | Vous devez vous trouver dans le répertoire des sources de Redmine pour la suite des opérations : | ||
- | |||
- | cd ~/redmine-0.7.3 | ||
- | |||
- | ==== Éditer le fichier d'accès à la base ==== | ||
- | |||
- | Copier le fichier de configuration : | ||
- | |||
- | cp config/database.yml.example config/database.yml | ||
- | |||
- | Puis [[:tutoriel:comment_editer_un_fichier|é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 | ||
- | |||
- | <note tip>L'option //socket// est spécifique à Ubuntu.</note> | ||
- | |||
- | ==== Créer la structure de la base de données ==== | ||
- | |||
- | rake db:migrate RAILS_ENV="production" | ||
- | |||
- | ==== Insérer les données par défaut ==== | ||
- | |||
- | rake load_default_data RAILS_ENV="production" | ||
- | |||
- | ===== Finir l'installation proprement ===== | ||
- | |||
- | 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. | ||
- | |||
- | ==== Déplacement 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 : | ||
- | |||
- | 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 ~/redmine-0.7.3 redmine-0.7.3.tar.gz | ||
- | |||
- | ===== Lancer Redmine ===== | ||
- | |||
- | 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. |