Project

General

Profile

FrRedmineInstall » History » Version 3

Fabrice Phung, 2008-12-11 22:53
traduction du guide version 2008-12-07

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