Project

General

Profile

FrRedmineInstall » History » Revision 9

Revision 8 (yannick quenec'hdu, 2010-05-14 19:45) → Revision 9/32 (yannick quenec'hdu, 2010-05-14 19:45)

h1. Installer Redmine 

 {{>TOC}} 

 h2. Exigences 

 
 h3. Système d'exploitation  

  
 Redmine devrait fonctionner sur la plupart des Unix, Linux, Mac et systèmes Windows systems aussi longtemps que Ruby est disponible sur cette plate-forme. 

 h3. Prérequis 

 * Le version de Ruby et Ruby on Rails pour une version donnée de Redmine: 

 |_. Version de Redmine|_. Versions de Ruby supportés|_. Version de Rails exigée|_. Version de Rails exigée| 
 |current trunk|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1| 
 |trunk from r2493 to r2886|ruby 1.8.6, 1.8.7|Rails 2.2.2|| 
 |trunk before r2493|ruby 1.8.6, 1.8.7|Rails 2.1.2|| 
 |0.9.x|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1| 
 |0.8.x|ruby 1.8.6, 1.8.7|Rails 2.1.2|| 
 |0.7.x|ruby 1.8.6|Rails 2.0.2|| 

 Les distributions officielles comprennent la version appropriée de Rails dans leur répertoire @vendor@. Aucune action n'est donc demandée. Si vous faites un checkout des sources depuis le dépôt Redmine, vous pouvez installer une version spécifique de Rails sur votre machine en lançant : 

  gem install rails -v=2.3.5  

 Notes: 
 * *Ruby 1.9 n'est pas supporté.* Vous _devez_ utiliser Ruby 1.8.x comme indiqué au dessus. 
 * RubyGems 1.3.1 est obligatoire 
 * Rake 0.8.3 est obligatoire 

 * Une base de données 

 * MySQL 4.1 ou plus (recommandé) 
 * Assurez-vous d'avoir installer les lien sen C pour Ruby qui améliorent considérablement les performances. Vous pouvez les obtenir en exécutant la commande @ gem install mysql @. 
  * Le gem Ruby MySQL ne supporte pas actuellement MySQL 5.1 

 * PostgreSQL 8 

  * Il faut être sur que le format de date (datestyle) de votre base de données est positionnée (Paramètres par défaut). Vous pouvez la positionner avec la commande: @ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";@ 
  * Certaines anomalies dans PostgreSQL 8.4.0 et 8.4.1 affecte le comportement de Redmine (#4259, #4314), elles sont corrigées dans PostgreSQL 8.4.2 
  * Installer l'adapter PosgreSQL pour Ruby. Vous pouvez le faire en utilisant une des techniques suivantes : 
  **    @gem install postgres-pr@ 
  **    @gem install pg@ (fonctionne avec une connexion SSL, peut nécessiter les librairies de développement libraries/packages pour votre OS avant la compilation) 
  *** Ubuntu OS: La librairie de développement peut être installée de la manière suivante (ou similaire): @sudo aptitude install libdbd-pg-ruby1.8@ 


 * SQLite 3 (svp lisez ceci: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails) 


 * Optionnel: 

     * binaires SCM    (exemple    @svn@), pour la consultation des dépôts (doivent être disponible dans votre PATH). Voir [[RedmineRepositories]] pour consulter les exigences et    comptabilités des différents SCM. 
       *    (to enable Gantt export to png image) 
       * "RMagick":http://rmagick.rubyforge.org/ (pour activer l'export Gantt dans une image au format png) 
       * "Ruby OpenID Library":http://openidenabled.com/ruby-openid/ (Pour activer le support    OpenID) [seulement sur pour le trunck de Redmine / 0.9-dev]    La version 2 ou supérieure est obligatoire. 


 h2. Installation 

 1. [[Download|Téléchargez]] et extrayez l'archive ou faites un [[CheckingoutRedmine|checkout]] de Redmine. 

 2. Créez une base de données vide nommée par exemple @redmine@. 

 Pour MySQL: 

 <pre> 
 create database redmine character set utf8; 
 create user 'redmine'@'localhost' identified by 'my_password'; 
 grant all privileges on redmine.* to 'redmine'@'localhost'; 
 </pre> 

 Pour les versions de MySQL antérieures à la 5.0.2 - passer l'étape 'create user' et opter plutôt pour cette commande : 
 <pre> 
 grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password'; 
 </pre> 

 For PostgreSQL: 

 <pre> 
 CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity'; 
 CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine; 
 </pre> 

 3. Copiez @config/database.yml.example@ dans @config/database.yml@ et éditez ce fichier pour configurer vos paramètres de base dans l'environnement "production". 

 Exemple pour une base de données MySQL: 

 <pre> 
 production: 
   adapter: mysql 
   database: redmine 
   host: localhost 
   username: redmine 
   password: my_password 
 </pre> 

 Si votre serveur ne fonctionne pas sur le port standard (3306), utiliser plutôt cette configuration: 

 <pre> 
 production: 
   adapter: mysql 
   database: redmine 
   host: localhost 
   port: 3307 
   username: redmine 
   password: my_password 
 </pre> 


 Exemple pour la base de données PostgreSQL (port par défaut): 

 <pre> 
 production: 
   adapter: postgresql 
   database: <le nom de votre base de données> 
   host: <nom de la machine de la DB> 
   username: <identifiant postgres> 
   password: <mot de passe postgres> 
   encoding: utf8 
   schema_search_path: <schéma de la base de données> (par défaut - public) 
 </pre> 

 4. Générer une secret de session. Il est obligatoire depuis le trunck r2493 ou pour les versions de Redmine released 0.8.7 et supérieure. 

 Redmine stocke les données de session dans un cookie par défaut, ce qui nécessite un secret pour être générées. Ceci peut être fait en exécutant: 

    RAILS_ENV=production rake config/initializers/session_store.rb 

 Si vous utilisez une version de Redmine postérieur à r3055, le fichier ci-dessus n'existent plus, il était obsolète sur le r3054. Sur ces versions, exécutez 

    rake generate_session_store 


 5. Créez la structure de base en lançant la commande suivante depuis le répertoire racine de l'application: 

   rake db:migrate RAILS_ENV="production" 

 Ceci va créer les tables et le compte administrateur. 

 5. Insérez les données de la configuration par défaut dans la base en lançant la commande suivante: 

   rake redmine:load_default_data RAILS_ENV="production" 

 Si vous obtenez l'erreur suivante:  
 <pre> 
 Rake aborted! 
 no such file to load -- net/https 
 </pre> 

 Vous devez installer la librairie libopenssl-ruby1.8, depuis ubuntu, executer la commande suivante : apt-get install libopenssl-ruby1.8 

 6. Insérer les données de configuration par default dans la base de données, en exécutant la commande suivante: 

   RAILS_ENV=production rake redmine:load_default_data 

 Cette étape est optionnelle mais *fortement recommandée*, sauf si vous définissez votre propre configuration depuis rien. Elle va charger les rôles par défaut, les trackers, statuts, workflows et énumérations. 

 7. Paramétrez les permissions 

 NB: _Les utilisateurs sous Windows doivent sauter cette section._ 

 L'utilisateur qui exécute Redmine doit avoir les permissions en écriture sur les sous-répertoires suivants: @files@, @log@, @tmp@ (créer ce dernier s'il n'est pas présent). 

 A supposer que vous fassiez fonctionner Redmine avec un utilisateur@redmine@: 

 <pre> 
 mkdir tmp public/plugin_assets 
 sudo chown -R redmine:redmine files log tmp public/plugin_assets 
 sudo chmod -R 755 files log tmp public/plugin_assets 
 </pre> 


 8. Testez l'installation en exécutant le serveur web WEBrick: 

   ruby script/server webrick -e production 

 Une fois WEBrick démarré, saisir l'URL dans votre navigateur http://localhost:3000/. Vous devriez voir apparaitre la page de bienvenue de Redmine. 

 8. Utilisez le compte administrateur par défaut pour vous connecter: 

     * identifiant: admin 
     * mot de passe: admin 

 Vous pouvez aller sur    @Administration@ pour modifier la configuration de l'application. 

 h2. Configuration du serveur SMTP 

 Copier le fichier @config/email.yml.example@ en @config/email.yml@ et éditer le fichier pour adapter les paramètres SMTP. 

 Consulter les exemples de configuration [[frRedmineConfigurationEmail|Exemple de configuration de mail]]. 

 Ne pas oublier de redémarrer l'application après avoir effectuer les modifications  


 h3. Sauvegarde 

 Une sauvegarde Redmine inclue les élements suivants: 
 * data (stored in your redmine database) 
 * attachments (stored in the @files@ directory of your Redmine install) 

 Here is a simple shell script that can be used for daily backups (assuming you're using a mysql database): 

 <pre> 
 # Database 
 /usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz 

 # Attachments 
 rsync -a /path/to/redmine/files /path/to/backup/files 
 </pre> 

 h3. versions 0.7.x 

 Dans config/environment.rb, vous pouvez configurer les paramètres de votre serveur SMTP: 

     * config.action_mailer.smtp_settings: configuration du serveur SMTP 
     * config.action_mailer.perform_deliveries: mettre à false pour désactiver l'envoi de messages 

 N'oubliez pas de redémarrer l'application après toute modification. 

 h2. Sauvegarde 

 Les sauvegardes Redmine devraient inclure: 
 * les données (stockées dans votre base de données redmine) 
 * pièces jointes (stockées dans le répertoire @files@ de votre installation Redmine) 

 Voici un simple script shell pouvant être utilisé pour des sauvegardes quotidiennes (à supposer que vous utilisez une base mysql): 

 <pre> 
 # Base 
 /usr/bin/mysqldump -u <utilisateur> -p <motdepasse> <base_redmine> | gzip > /chemin/vers/sauvegarde/db/redmine_`date +%y_%m_%d`.gz 

 # Pièces jointes 
 rsync -a /chemin/vers/redmine/files /chemin/vers/sauvegarde/files 
 </pre>