Project

General

Profile

FrRedmineInstall » History » Revision 4

Revision 3 (Fabrice Phung, 2008-12-11 22:53) → Revision 4/32 (Fabrice Phung, 2008-12-11 22:54)

h1. Installer Redmine 

 {{>TOC}} 

 h2. Prérequis 

 * Ruby & Ruby on Rails: 

 |_. version Redmine|_. version Rails requise| 
 |trunk|Rails 2.1.2| 
 |0.8.x|Rails 2.1.2| 
 |0.7.x|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 : 
 If you checkout the source from the Redmine repository, you can install a specific Rails version on your machine by running: 

  gem install rails -v=2.1.2  

 * Une base de données 

 * MySQL 4.1 ou plus (recommandé) 
 * PostgreSQL 8 
 * SQLite 3 (svp lisez ceci: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails) 

 * Optionnel: 

     * binaires SVN (>= 1.3), pour la consultation des dépôts (doivent être atteignables dans votre PATH) 
     * RMagick (export Gantt dans une image png) 

 Notez que Rails a quelques problèmes de compatibilité avec Ruby 1.8.7. *La version de ruby supportée est 1.8.6*. 


 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: 

   create database redmine character set utf8; 

 3. Coiez @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: 

   production: 
     adapter: mysql 
     database: redmine 
     host: localhost 
     username: bduser 
     password: bdpasswd 

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

 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. 

 6. Paramétrez les permissions 

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

 L'utilisateur faisant tourner Redmine doit avoir la permission d'écriture sur les sous-répertoires suivants: @files@, @log@, @tmp@ (créez ce dernier s'il n'est pas présent). 

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

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


 7. Testez l'installation en lançant le serveur web WEBrick: 

   ruby script/server -e production 

 Une fois WEBrick démarré, dirigez votre navigateur sur http://localhost:3000/. Vous devriez voir maintenant la page de bienvenue de l'application. 

 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 

 h3. versions 0.8.x 

 Copiez @config/email.yml.example@ vers @config/email.yml@ et éditez ce fichier pour ajuster vos paramètres SMTP.  

 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>