Project

General

Profile

FrRedmineInstall » History » Version 21

Ame Nomade, 2011-11-17 11:42

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