Project

General

Profile

FrRedmineInstall » History » Version 4

Fabrice Phung, 2008-12-11 22:54

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