Project

General

Profile

FrRedmineInstall » History » Revision 25

Revision 24 (Pierre Labrie, 2012-09-21 18:22) → Revision 25/32 (Pierre Labrie, 2012-09-21 18:54)

h1. Installer Redmine facilement 

 {{>TOC}} 

 h2. Exigences 

 h3. Système d'exploitation  

 Redmine devrait fonctionner sur la plupart des Unix, Linux, Mac et systèmes Windows aussi longtemps que Ruby est disponible sur ces plates-formes. 

 h3. Ruby, Ruby on Rails, RubyGem 

 * Les versions de Ruby on Rails pour une version donnée de Redmine sont les suivantes : 


 |_. Version de Redmine|_. Versions de Ruby supportées|_. Version de Rails exigée|_. Version de RubyGems exigée| 
 |current trunk  	 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7  	 |Rails 3.2.8  	 |RubyGems <= 1.8| 
 |2.1.0  	 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7  	 |Rails 3.2.8  	 |RubyGems <= 1.8| 
 |2.0.3  	 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7  	 |Rails 3.2.6  	 |RubyGems <= 1.8| 
 |2.0.2  	 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7  	 |Rails 3.2.5  	 |RubyGems <= 1.8| 
 |2.0.0, 2.0.1  	 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7  	 |Rails 3.2.3  	 |RubyGems <= 1.8| 
 |1.4.x  	 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7  	 |Rails 2.3.14  	 |RubyGems <= 1.8| 

 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 : 

 <pre> 
  gem install rails -v=3.2.8 
 </pre> 

 h3. Base de données 

 * MySQL 5.0 ou plus (recommandé) 
 ** Assurez-vous d'avoir installé les liens C pour Ruby qui améliorent considérablement les performances. Vous pouvez les obtenir en exécutant la commande @gem install mysql2@. Si vous rencontrez des problèmes lors de l'installation de cette gem, consultez la "page dédiée de Ruby on Rails":http://wiki.rubyonrails.org/fr/database-support/mysql 
 ** les versions Mysql 4.1 et 4.X supérieurs peuvent poser des problèmes 

 * PostgreSQL 8 ou plus (8.2 ou plus à partir de Redmine 2.0.0) 
 ** Il faut être sûr que le format de date (datestyle) de votre base de données est positionné à "ISO" (paramètre par défaut de Postgres). 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 affectent le comportement de Redmine (#4259, #4314), elles sont corrigées dans PostgreSQL 8.4.2 


 * SQLite 3 

 h3. Composants optionnels 

 * binaires pour les gestionnaires de version (SCM, par 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. 
 * "RMagick":http://rmagick.rubyforge.org/ (pour activer l'export Gantt dans une image au format png) 
 * "La bibliothèque Ruby OpenID":http://openidenabled.com/ruby-openid/ (pour activer le support    OpenID) ; seulement sur les versions de développement (trunk) de Redmine / 0.9-dev ; a version 2 ou supérieure est obligatoire. 

 


 h2. Installation 

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

 2. Depuis la version 1.4.0, Redmine utilise Bundler pour gérer les dépendances de _gems_. vous devez installer Bundler en premier: 

 <pre> 
 gem install bundler 
 </pre> 

 Après vous pouvez installer tous les _gems_ requis avec la commande suivante: 

 <pre> 
 bundle install --without development test 
 </pre> 

 Si ImageMagick n'est pas installé sur votre système, vous pouvez retirer l'installation du _gem rmagick_ avec cette commande: 
 <pre> 
 bundle install --without development test rmagick 
 </pre> 

 Note concernant l'installation de rmagick sur Windows: 
 >_Au moment d'écrire ces lignes, il se peut que l'installation du _gem rmagick_ fonctionne mal avec la commande @bundle install@ si elle n'est pas déjà installée. Vous pouvez trouver de l'aide "ici":http://www.redmine.org/projects/redmine/wiki/HowTo_install_rmagick_gem_on_Windows_  
 >  
 Vous pouvez aussi retirer l'installation des adapteurs que vous n'utilisez pas. Par exemple si vous utilisez MySql, vous pouvez retirer les gems postgresql and sqlite gems avec la commande `bundle install --without development test postgresql sqlite`. 

 Si vous avez besoin de _gems_ non requis par le noyau Redmine (eg. puma,fcgi), créez un fichier nommé Gemfile.local à la racine de votre répertoire de Redmine et il sera chargé automatiquement au lancement de la commande `bundle install`. Exemple: 

 <pre> 
 # Gemfile.local 
 gem 'puma' 
 </pre> 


 3. 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 - passez l'étape 'create user' et optez plutôt pour cette commande : 
 <pre> 
 grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password'; 
 </pre> 

 Pour PostgreSQL: 

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

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

 5. 4. Générer un secret de session. Il est obligatoire depuis le trunk r2493 ou pour les versions de Redmine version 0.8.7 et supérieure. 

 * Avec Redmine 1.4.x: stocke les données de session dans un cookie par défaut, ce qui nécessite une clé secrète. Ceci peut être fait en exécutant: 

    RAILS_ENV=production rake config/initializers/session_store.rb 

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

    rake generate_session_store 
 </pre> 

 * Avec Redmine 2.x: 

 <pre> 
 rake generate_secret_token 
 </pre> 


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

 <pre> 
 RAILS_ENV=production 

   rake db:migrate 
 </pre> RAILS_ENV="production" 

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

 6. 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 cette erreur: 
 l'erreur suivante:  
 <pre> 
 Rake aborted! 
 no such file to load -- net/https 
 </pre> 

 Vous devez installer la librairie libopenssl-ruby1.8 dans Ubuntu avec cette commande: @apt-get ou équivalente. Sur Ubuntu, exécutez la commande suivante : @sudo aptitude install libopenssl-ruby1.8@ 


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

 <pre> 
 RAILS_ENV=production rake redmine:load_default_data 
 </pre> 

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

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

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

 * Avec Redmine 1.4.x: 

 <pre> 
 

   ruby script/server webrick -e production 
 </pre> 

 * Avec Redmine 2.x: 

 <pre> 
 ruby script/rails server webrick -e production 
 </pre> 


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

 10. 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 effectué les modifications  


 h3. Sauvegarde 

 Une sauvegarde Redmine inclue les éléments suivants: 
 * Les données (stockées dans votre base de données Redmine) 
 * Les fichiers (Stockés dans le répertoire @files@ de votre installation de Redmine) 

 Voici un simple script shell que vous pouvez utiliser quotidiennement pour sauvegarder vos données (en supposant que vous utilisez une base de données mysql) 

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

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

 h2. Notes à propos de l'installation sur Windows 

 Récupérer et installer    rubyinstaller depuis le site http://rubyforge.org. Depuis le menu démarrer, exécuter la console @cmd@  

 Depuis la console les commandes suivantes : 

 <pre> 
 RAILS_ENV=production rake db:migrate 
 RAILS_ENV=production rake redmine:load_default_data 
 </pre> 

 Doivent être changées par les commandes suivantes : 

 <pre> 
 set RAILS_ENV=production 
 rake db:migrate 
 rake redmine:load_default_data 
 </pre>   

 Vous pouvez avoir besoin d'installer mysql gem, avec la commande 

 <pre> 
 gem install mysql 
 </pre> 

 Et dans certains cas, il peut être nécessaire de copier le fichier    libmysql.dll file dans votre répertoire ruby/bin. 
 Toutes les librairies ne semblent pas fonctionner, récupérer sur    http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll 

 h3. Les Problèmes avec MySQL 5.1 et Rails 2.2+ 

 Avec la dernière version de MySQL, vous pouvez rencontrer plusieurs erreurs, telles que : "!!! The bundled mysql.rb driver has been removed from Ruby 2.2" et quand vous effectuez la commande "gem install mysql" vous pouvez aussi rencontrer plusieurs erreurs. Une solution possible : 

 Télécharger le fichier DLL depuis le projet InstantRails: 

 http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll 

 Copier ce fichier dans le répertoire    \Ruby\bin directory et essayer d'effectuer une nouvelle fois votre commande rake. 

 h2. Alternative à l'installation manuelle  

 Certains utilisateurs préfèrent sauter l'installation manuelle en utilisant un package pré-installé depuis la page de téléchargement [[Download#Third-party-Redmine-bundles|third-party Redmine bundles]].