FrRedmineInstall » History » Version 7

sebastián scarano, 2009-05-13 09:55

1 1 Fabrice Phung
h1. Installer Redmine
2 1 Fabrice Phung
3 1 Fabrice Phung
{{>TOC}}
4 1 Fabrice Phung
5 1 Fabrice Phung
h2. Prérequis
6 1 Fabrice Phung
7 2 Fabrice Phung
* Ruby & Ruby on Rails:
8 1 Fabrice Phung
9 7 sebastián scarano
|_. version Redmine|_. version Rails requise|
10 2 Fabrice Phung
|trunk|Rails 2.1.2|
11 2 Fabrice Phung
|0.8.x|Rails 2.1.2|
12 2 Fabrice Phung
|0.7.x|Rails 2.0.2|
13 1 Fabrice Phung
14 2 Fabrice Phung
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 :
15 2 Fabrice Phung
16 3 Fabrice Phung
 gem install rails -v=2.1.2 
17 2 Fabrice Phung
18 2 Fabrice Phung
* Une base de données
19 2 Fabrice Phung
20 2 Fabrice Phung
* MySQL 4.1 ou plus (recommandé)
21 2 Fabrice Phung
* PostgreSQL 8
22 2 Fabrice Phung
* SQLite 3 (svp lisez ceci: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails)
23 2 Fabrice Phung
24 2 Fabrice Phung
* Optionnel:
25 2 Fabrice Phung
26 1 Fabrice Phung
    * binaires SVN (>= 1.3), pour la consultation des dépôts (doivent être atteignables dans votre PATH)
27 1 Fabrice Phung
    * RMagick (export Gantt dans une image png)
28 1 Fabrice Phung
29 2 Fabrice Phung
Notez que Rails a quelques problèmes de compatibilité avec Ruby 1.8.7. *La version de ruby supportée est 1.8.6*.
30 1 Fabrice Phung
31 1 Fabrice Phung
32 1 Fabrice Phung
h2. Installation
33 1 Fabrice Phung
34 1 Fabrice Phung
1. [[Download|Téléchargez]] et extrayez l'archive ou faites un [[CheckingoutRedmine|checkout]] de Redmine.
35 1 Fabrice Phung
36 1 Fabrice Phung
2. Créez une base de données vide nommée par exemple @redmine@.
37 1 Fabrice Phung
38 1 Fabrice Phung
Pour MySQL:
39 1 Fabrice Phung
40 1 Fabrice Phung
  create database redmine character set utf8;
41 1 Fabrice Phung
42 5 Fabrice Phung
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".
43 1 Fabrice Phung
44 1 Fabrice Phung
Exemple pour une base de données MySQL:
45 1 Fabrice Phung
46 1 Fabrice Phung
  production:
47 1 Fabrice Phung
    adapter: mysql
48 1 Fabrice Phung
    database: redmine
49 1 Fabrice Phung
    host: localhost
50 1 Fabrice Phung
    username: bduser
51 1 Fabrice Phung
    password: bdpasswd
52 1 Fabrice Phung
53 1 Fabrice Phung
4. Créez la structure de base en lançant la commande suivante depuis le répertoire racine de l'application:
54 1 Fabrice Phung
55 1 Fabrice Phung
  rake db:migrate RAILS_ENV="production"
56 1 Fabrice Phung
57 1 Fabrice Phung
Ceci va créer les tables et le compte administrateur.
58 1 Fabrice Phung
59 1 Fabrice Phung
5. Insérez les données de la configuration par défaut dans la base en lançant la commande suivante:
60 1 Fabrice Phung
61 1 Fabrice Phung
  rake redmine:load_default_data RAILS_ENV="production"
62 1 Fabrice Phung
63 1 Fabrice Phung
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.
64 1 Fabrice Phung
65 2 Fabrice Phung
6. Paramétrez les permissions
66 1 Fabrice Phung
67 2 Fabrice Phung
NB: _Les utilisateurs sous Windows doivent sauter cette section._
68 2 Fabrice Phung
69 2 Fabrice Phung
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).
70 2 Fabrice Phung
71 2 Fabrice Phung
A supposer que vous fassiez tourner Redmine avec un utilisateur@redmine@:
72 2 Fabrice Phung
73 2 Fabrice Phung
<pre>
74 2 Fabrice Phung
mkdir tmp
75 2 Fabrice Phung
sudo chown -R redmine:redmine files log tmp
76 2 Fabrice Phung
sudo chmod -R 755 files log tmp
77 2 Fabrice Phung
</pre> 
78 2 Fabrice Phung
79 2 Fabrice Phung
80 2 Fabrice Phung
7. Testez l'installation en lançant le serveur web WEBrick:
81 2 Fabrice Phung
82 1 Fabrice Phung
  ruby script/server -e production
83 1 Fabrice Phung
84 1 Fabrice Phung
Une fois WEBrick démarré, dirigez votre navigateur sur http://localhost:3000/. Vous devriez voir maintenant la page de bienvenue de l'application.
85 1 Fabrice Phung
86 2 Fabrice Phung
8. Utilisez le compte administrateur par défaut pour vous connecter:
87 1 Fabrice Phung
88 1 Fabrice Phung
    * identifiant: admin
89 1 Fabrice Phung
    * mot de passe: admin
90 1 Fabrice Phung
91 2 Fabrice Phung
Vous pouvez aller sur  @Administration@ pour modifier la configuration de l'application.
92 1 Fabrice Phung
93 1 Fabrice Phung
h2. Configuration du serveur SMTP
94 2 Fabrice Phung
95 2 Fabrice Phung
h3. versions 0.8.x
96 2 Fabrice Phung
97 2 Fabrice Phung
Copiez @config/email.yml.example@ vers @config/email.yml@ et éditez ce fichier pour ajuster vos paramètres SMTP. 
98 2 Fabrice Phung
99 2 Fabrice Phung
h3. versions 0.7.x
100 1 Fabrice Phung
101 1 Fabrice Phung
Dans config/environment.rb, vous pouvez configurer les paramètres de votre serveur SMTP:
102 1 Fabrice Phung
103 1 Fabrice Phung
    * config.action_mailer.smtp_settings: configuration du serveur SMTP
104 1 Fabrice Phung
    * config.action_mailer.perform_deliveries: mettre à false pour désactiver l'envoi de messages
105 1 Fabrice Phung
106 1 Fabrice Phung
N'oubliez pas de redémarrer l'application après toute modification.
107 1 Fabrice Phung
108 1 Fabrice Phung
h2. Sauvegarde
109 1 Fabrice Phung
110 1 Fabrice Phung
Les sauvegardes Redmine devraient inclure:
111 1 Fabrice Phung
* les données (stockées dans votre base de données redmine)
112 1 Fabrice Phung
* pièces jointes (stockées dans le répertoire @files@ de votre installation Redmine)
113 1 Fabrice Phung
114 1 Fabrice Phung
Voici un simple script shell pouvant être utilisé pour des sauvegardes quotidiennes (à supposer que vous utilisez une base mysql):
115 1 Fabrice Phung
116 1 Fabrice Phung
<pre>
117 1 Fabrice Phung
# Base
118 1 Fabrice Phung
/usr/bin/mysqldump -u <utilisateur> -p <motdepasse> <base_redmine> | gzip > /chemin/vers/sauvegarde/db/redmine_`date +%y_%m_%d`.gz
119 1 Fabrice Phung
120 1 Fabrice Phung
# Pièces jointes
121 1 Fabrice Phung
rsync -a /chemin/vers/redmine/files /chemin/vers/sauvegarde/files
122 1 Fabrice Phung
</pre>