Différences

Ci-dessous, les différences entre deux révisions de la page.

--- tutoriel:comment_installer_redmine [Le 20/12/2008, 02:11]
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 ====
-  rake db:migrate RAILS_ENV="production"
-==== Insérer les données par défaut ====
-  rake load_default_data RAILS_ENV="production"
-Le langage sera demandé, pour du français, indiquez donc :
-  fr
-===== 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
-==== 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 =====
-Lancer Redmine :
-  sudo ruby /opt/redmine/script/server -e production
-Redmine écoute sur le port 3000 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.
-===== Liens externes =====
-  * [[http://www.redmine.org|Site officiel du projet Redmine]]
-  * [[http://www.redmine.org/wiki/redmine/FrGuide|Le guide de Redmine]] : installation, mise à jour, utilisation, etc.
-  * [[http://demo.redmine.org/|Démo en ligne de Redmine]]
-  * [[http://www.projet-plume.org/fr/fiche/redmine|Une fiche descriptive de Redmine]]
-----
-//Auteur : [[:utilisateurs:v0n]].//