Project

General

Profile

FrRedmineInstall » History » Version 15

Nav XRay, 2010-06-01 09:28

1 1 Fabrice Phung
h1. Installer Redmine
2
3
{{>TOC}}
4
5 8 yannick quenec'hdu
h2. Exigences
6 9 yannick quenec'hdu
7 8 yannick quenec'hdu
h3. Système d'exploitation 
8 9 yannick quenec'hdu
9 11 yannick quenec'hdu
Redmine devrait fonctionner sur la plupart des Unix, Linux, Mac et systèmes Windows aussi longtemps que Ruby est disponible sur ces plates-formes.
10 1 Fabrice Phung
11 8 yannick quenec'hdu
h3. Prérequis
12 1 Fabrice Phung
13 15 Nav XRay
* La version de Ruby et *Ruby* on Rails pour une version donnée de Redmine:
14 1 Fabrice Phung
15 11 yannick quenec'hdu
|_. Version de Redmine|_. Versions de Ruby supportées|_. Version de Rails exigée|_. Version de Rails exigée|
16 8 yannick quenec'hdu
|current trunk|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1|
17
|trunk from r2493 to r2886|ruby 1.8.6, 1.8.7|Rails 2.2.2||
18
|trunk before r2493|ruby 1.8.6, 1.8.7|Rails 2.1.2||
19
|0.9.x|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1|
20
|0.8.x|ruby 1.8.6, 1.8.7|Rails 2.1.2||
21
|0.7.x|ruby 1.8.6|Rails 2.0.2||
22
23 1 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 :
24
25 8 yannick quenec'hdu
 gem install rails -v=2.3.5 
26 2 Fabrice Phung
27 8 yannick quenec'hdu
Notes:
28
* *Ruby 1.9 n'est pas supporté.* Vous _devez_ utiliser Ruby 1.8.x comme indiqué au dessus.
29
* RubyGems 1.3.1 est obligatoire
30
* Rake 0.8.3 est obligatoire
31
32 1 Fabrice Phung
* Une base de données
33
34
* MySQL 4.1 ou plus (recommandé)
35 11 yannick quenec'hdu
* 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 mysql @.
36 8 yannick quenec'hdu
 * Le gem Ruby MySQL ne supporte pas actuellement MySQL 5.1
37
38 1 Fabrice Phung
* PostgreSQL 8
39 8 yannick quenec'hdu
40 11 yannick quenec'hdu
 * Il faut être sur que le format de date (datestyle) de votre base de données est positionné (Paramètres par défaut). Vous pouvez la positionner avec la commande: @ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";@
41
 * 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
42 8 yannick quenec'hdu
 * Installer l'adapter PosgreSQL pour Ruby. Vous pouvez le faire en utilisant une des techniques suivantes :
43
 **  @gem install postgres-pr@
44
 **  @gem install pg@ (fonctionne avec une connexion SSL, peut nécessiter les librairies de développement libraries/packages pour votre OS avant la compilation)
45
 *** Ubuntu OS: La librairie de développement peut être installée de la manière suivante (ou similaire): @sudo aptitude install libdbd-pg-ruby1.8@
46
47
48 1 Fabrice Phung
* SQLite 3 (svp lisez ceci: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails)
49
50 8 yannick quenec'hdu
51 1 Fabrice Phung
* Optionnel:
52
53 11 yannick quenec'hdu
    * binaires SCM (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.
54 8 yannick quenec'hdu
      *  (to enable Gantt export to png image)
55
      * "RMagick":http://rmagick.rubyforge.org/ (pour activer l'export Gantt dans une image au format png)
56
      * "Ruby OpenID Library":http://openidenabled.com/ruby-openid/ (Pour activer le support  OpenID) [seulement sur pour le trunck de Redmine / 0.9-dev]  La version 2 ou supérieure est obligatoire.
57 1 Fabrice Phung
58
59
h2. Installation
60
61
1. [[Download|Téléchargez]] et extrayez l'archive ou faites un [[CheckingoutRedmine|checkout]] de Redmine.
62
63
2. Créez une base de données vide nommée par exemple @redmine@.
64
65
Pour MySQL:
66
67 8 yannick quenec'hdu
<pre>
68
create database redmine character set utf8;
69
create user 'redmine'@'localhost' identified by 'my_password';
70
grant all privileges on redmine.* to 'redmine'@'localhost';
71
</pre>
72 1 Fabrice Phung
73 8 yannick quenec'hdu
Pour les versions de MySQL antérieures à la 5.0.2 - passer l'étape 'create user' et opter plutôt pour cette commande :
74
<pre>
75
grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';
76
</pre>
77
78
For PostgreSQL:
79
80
<pre>
81
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
82
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
83
</pre>
84
85 1 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".
86
87
Exemple pour une base de données MySQL:
88
89 8 yannick quenec'hdu
<pre>
90
production:
91
  adapter: mysql
92
  database: redmine
93
  host: localhost
94
  username: redmine
95
  password: my_password
96
</pre>
97 1 Fabrice Phung
98 8 yannick quenec'hdu
Si votre serveur ne fonctionne pas sur le port standard (3306), utiliser plutôt cette configuration:
99 1 Fabrice Phung
100 8 yannick quenec'hdu
<pre>
101
production:
102
  adapter: mysql
103
  database: redmine
104
  host: localhost
105
  port: 3307
106
  username: redmine
107
  password: my_password
108
</pre>
109
110
111
Exemple pour la base de données PostgreSQL (port par défaut):
112
113
<pre>
114
production:
115
  adapter: postgresql
116
  database: <le nom de votre base de données>
117
  host: <nom de la machine de la DB>
118
  username: <identifiant postgres>
119
  password: <mot de passe postgres>
120
  encoding: utf8
121
  schema_search_path: <schéma de la base de données> (par défaut - public)
122
</pre>
123
124 11 yannick quenec'hdu
4. Générer un secret de session. Il est obligatoire depuis le trunck r2493 ou pour les versions de Redmine released 0.8.7 et supérieure.
125 8 yannick quenec'hdu
126 11 yannick quenec'hdu
Redmine stocke les données de session dans un cookie par défaut, ce qui nécessite un secret pour être généré. Ceci peut être fait en exécutant:
127 8 yannick quenec'hdu
128
   RAILS_ENV=production rake config/initializers/session_store.rb
129
130 11 yannick quenec'hdu
Si vous utilisez une version de Redmine postérieur à r3055, le fichier ci-dessus n'existe plus, il était obsolète sur le r3054. Sur ces versions, exécutez
131 8 yannick quenec'hdu
132
   rake generate_session_store
133
134
135
5. Créez la structure de base en lançant la commande suivante depuis le répertoire racine de l'application:
136
137 1 Fabrice Phung
  rake db:migrate RAILS_ENV="production"
138
139
Ceci va créer les tables et le compte administrateur.
140
141 13 yannick quenec'hdu
6. Insérez les données de la configuration par défaut dans la base en lançant la commande suivante:
142 1 Fabrice Phung
143
  rake redmine:load_default_data RAILS_ENV="production"
144
145 8 yannick quenec'hdu
Si vous obtenez l'erreur suivante: 
146
<pre>
147
Rake aborted!
148
no such file to load -- net/https
149
</pre>
150
151 11 yannick quenec'hdu
Vous devez installer la librairie libopenssl-ruby1.8, depuis ubuntu, exécuter la commande suivante : apt-get install libopenssl-ruby1.8
152 8 yannick quenec'hdu
153 13 yannick quenec'hdu
7. Insérer les données de configuration par defaut dans la base de données, en exécutant la commande suivante:
154 8 yannick quenec'hdu
155
  RAILS_ENV=production rake redmine:load_default_data
156
157 11 yannick quenec'hdu
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.
158 2 Fabrice Phung
159 14 yannick quenec'hdu
8. Paramétrez les permissions
160 1 Fabrice Phung
161
NB: _Les utilisateurs sous Windows doivent sauter cette section._
162
163 8 yannick quenec'hdu
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).
164 1 Fabrice Phung
165 8 yannick quenec'hdu
A supposer que vous fassiez fonctionner Redmine avec un utilisateur@redmine@:
166 1 Fabrice Phung
167
<pre>
168 8 yannick quenec'hdu
mkdir tmp public/plugin_assets
169
sudo chown -R redmine:redmine files log tmp public/plugin_assets
170
sudo chmod -R 755 files log tmp public/plugin_assets
171
</pre>
172 1 Fabrice Phung
173
174 14 yannick quenec'hdu
9. Testez l'installation en exécutant le serveur web WEBrick:
175 1 Fabrice Phung
176 8 yannick quenec'hdu
  ruby script/server webrick -e production
177 1 Fabrice Phung
178 11 yannick quenec'hdu
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.
179 1 Fabrice Phung
180 14 yannick quenec'hdu
10. Utilisez le compte administrateur par défaut pour vous connecter:
181 2 Fabrice Phung
182
    * identifiant: admin
183
    * mot de passe: admin
184
185
Vous pouvez aller sur  @Administration@ pour modifier la configuration de l'application.
186
187
h2. Configuration du serveur SMTP
188
189 8 yannick quenec'hdu
Copier le fichier @config/email.yml.example@ en @config/email.yml@ et éditer le fichier pour adapter les paramètres SMTP.
190 1 Fabrice Phung
191 8 yannick quenec'hdu
Consulter les exemples de configuration [[frRedmineConfigurationEmail|Exemple de configuration de mail]].
192
193 11 yannick quenec'hdu
Ne pas oublier de redémarrer l'application après avoir effectué les modifications 
194 8 yannick quenec'hdu
195
196
h3. Sauvegarde
197
198 11 yannick quenec'hdu
Une sauvegarde Redmine inclue les éléments suivants:
199 10 yannick quenec'hdu
* Les données (stockées dans votre base de données Redmine)
200 11 yannick quenec'hdu
* Les fichiers (Stockés dans le répertoire @files@ de votre installation de Redmine)
201 8 yannick quenec'hdu
202 10 yannick quenec'hdu
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)
203 8 yannick quenec'hdu
204
<pre>
205 10 yannick quenec'hdu
# Base de données
206 8 yannick quenec'hdu
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz
207
208 10 yannick quenec'hdu
# Fichiers
209 1 Fabrice Phung
rsync -a /path/to/redmine/files /path/to/backup/files
210
</pre>
211
212 12 yannick quenec'hdu
h2. Notes à propos de l'installation sur Windows
213 1 Fabrice Phung
214 10 yannick quenec'hdu
Récupérer et installer  rubyinstaller depuis le site http://rubyforge.org. Depuis le menu démarrer, exécuter la console @cmd@ 
215 1 Fabrice Phung
216 10 yannick quenec'hdu
Depuis la console les commandes suivantes :
217 1 Fabrice Phung
218 10 yannick quenec'hdu
<pre>
219
RAILS_ENV=production rake db:migrate
220
RAILS_ENV=production rake redmine:load_default_data
221
</pre>
222 1 Fabrice Phung
223 10 yannick quenec'hdu
Doivent être changées par les commandes suivantes :
224 1 Fabrice Phung
225 10 yannick quenec'hdu
<pre>
226
set RAILS_ENV=production
227
rake db:migrate
228
rake redmine:load_default_data
229
</pre>  
230 1 Fabrice Phung
231 10 yannick quenec'hdu
Vous pouvez avoir besoin d'installer mysql gem, avec la commande
232 1 Fabrice Phung
233
<pre>
234 10 yannick quenec'hdu
gem install mysql
235 1 Fabrice Phung
</pre>
236 10 yannick quenec'hdu
237
Et dans certains cas, il peut être nécessaire de copier le fichier  libmysql.dll file dans votre répertoire ruby/bin.
238
Toutes les librairies ne semblent pas fonctionner, récupérer sur  http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll
239
240
h3. Les Problèmes avec MySQL 5.1 et Rails 2.2+
241
242
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 :
243
244
Télécharger le fichier DLL depuis le projet InstantRails:
245
246
http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll
247
248
Copier ce fichier dans le répertoire  \Ruby\bin directory et essayer d'effectuer une nouvelle fois votre commande rake.
249
250
h2. Alternative : installation manuelle 
251
252
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]].