Project

General

Profile

FrRedmineInstall » History » Version 32

Hugues C., 2016-11-07 16:42
Color coded syntax for SQL and YAML

1 22 Alexis Supiot
h1. Installer Redmine facilement
2 1 Fabrice Phung
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 23 Pierre Labrie
h3. Ruby, Ruby on Rails, RubyGem
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
16 23 Pierre Labrie
|_. Version de Redmine|_. Versions de Ruby supportées|_. Version de Rails exigée|_. Version de RubyGems exigée|
17 31 Thomas Godard
|current trunk 	|ruby 1.8.7, 1.9.2, 1.9.3, 2.0.0, jruby-1.6.7, jruby-1.7.2|Rails 3.2.13 ||
18
|2.3.0  |ruby 1.8.7, 1.9.2, 1.9.3, 2.0.0, jruby-1.6.7, jruby-1.7.2|Rails 3.2.13 ||
19
|2.2.4  |ruby 1.8.7, 1.9.2, 1.9.3, 2.0.0, jruby-1.6.7, jruby-1.7.2|Rails 3.2.13 ||
20 23 Pierre Labrie
|2.1.0 	|ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 	|Rails 3.2.8 	|RubyGems <= 1.8|
21
|2.0.3 	|ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 	|Rails 3.2.6 	|RubyGems <= 1.8|
22
|2.0.2 	|ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 	|Rails 3.2.5 	|RubyGems <= 1.8|
23
|2.0.0, 2.0.1 	|ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 	|Rails 3.2.3 	|RubyGems <= 1.8|
24
|1.4.x 	|ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 	|Rails 2.3.14 	|RubyGems <= 1.8|
25 18 yannick quenec'hdu
26 8 yannick quenec'hdu
27
28 19 Jean-Baptiste Barth
h3. Base de données
29 1 Fabrice Phung
30
* MySQL 5.0 ou plus (recommandé)
31 24 Pierre Labrie
** 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 mysql2@. Si vous rencontrez des problèmes lors de l'installation de cette gem, consultez la "page dédiée de Ruby on Rails":http://wiki.rubyonrails.org/fr/database-support/mysql
32 19 Jean-Baptiste Barth
** les versions Mysql 4.1 et 4.X supérieurs peuvent poser des problèmes
33 1 Fabrice Phung
34 24 Pierre Labrie
* PostgreSQL 8 ou plus (8.2 ou plus à partir de Redmine 2.0.0)
35 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";@
36 8 yannick quenec'hdu
** 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
37
38 1 Fabrice Phung
39 24 Pierre Labrie
* SQLite 3
40 8 yannick quenec'hdu
41 20 Jean-Baptiste Barth
h3. Composants optionnels
42 11 yannick quenec'hdu
43 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.
44
* "RMagick":http://rmagick.rubyforge.org/ (pour activer l'export Gantt dans une image au format png)
45 30 Pierre Labrie
* "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; la version 2 ou supérieure est obligatoire.
46 1 Fabrice Phung
47
h2. Installation
48
49 20 Jean-Baptiste Barth
1. [[Download|Téléchargez (en)]] et extrayez l'archive ou faites un [[CheckingoutRedmine|checkout (en)]] de Redmine.
50 1 Fabrice Phung
51 27 Pierre Labrie
2. Depuis la version 1.4.0, Redmine utilise Bundler pour gérer les dépendances de _gems_. Vous devez installer Bundler en premier:
52 1 Fabrice Phung
53 25 Pierre Labrie
<pre>
54
gem install bundler
55
</pre>
56
57
Après vous pouvez installer tous les _gems_ requis avec la commande suivante:
58
59
<pre>
60
bundle install --without development test
61
</pre>
62
63
Si ImageMagick n'est pas installé sur votre système, vous pouvez retirer l'installation du _gem rmagick_ avec cette commande:
64
<pre>
65
bundle install --without development test rmagick
66
</pre>
67
68
Note concernant l'installation de rmagick sur Windows:
69 27 Pierre Labrie
>Au moment d'écrire ces lignes, il se peut que l'installation du @gem rmagick@ fonctionne mal avec la commande @bundle install@ si elle n'est pas déjà installée. Vous pouvez trouver de l'aide "ici":http://www.redmine.org/projects/redmine/wiki/HowTo_install_rmagick_gem_on_Windows 
70 25 Pierre Labrie
> 
71 27 Pierre Labrie
Vous pouvez aussi retirer l'installation des adapteurs que vous n'utilisez pas. Par exemple si vous utilisez MySql, vous pouvez retirer les @gems postgresql et sqlite@ avec la commande `bundle install --without development test postgresql sqlite`.
72 25 Pierre Labrie
73
Si vous avez besoin de _gems_ non requis par le noyau Redmine (eg. puma,fcgi), créez un fichier nommé Gemfile.local à la racine de votre répertoire de Redmine et il sera chargé automatiquement au lancement de la commande `bundle install`. Exemple:
74
75
<pre>
76
# Gemfile.local
77
gem 'puma'
78
</pre>
79
80
81
3. Créez une base de données vide nommée par exemple @redmine@.
82
83 1 Fabrice Phung
Pour MySQL:
84
85 32 Hugues C.
<pre><code class="sql">
86 8 yannick quenec'hdu
create database redmine character set utf8;
87
create user 'redmine'@'localhost' identified by 'my_password';
88 1 Fabrice Phung
grant all privileges on redmine.* to 'redmine'@'localhost';
89 32 Hugues C.
</code></pre>
90 20 Jean-Baptiste Barth
91 8 yannick quenec'hdu
Pour les versions de MySQL antérieures à la 5.0.2 - passez l'étape 'create user' et optez plutôt pour cette commande :
92 32 Hugues C.
<pre><code class="sql">
93 8 yannick quenec'hdu
grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';
94 32 Hugues C.
</code></pre>
95 20 Jean-Baptiste Barth
96 8 yannick quenec'hdu
Pour PostgreSQL:
97
98 32 Hugues C.
<pre><code class="sql">
99 8 yannick quenec'hdu
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
100 1 Fabrice Phung
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
101 32 Hugues C.
</code></pre>
102 8 yannick quenec'hdu
103 25 Pierre Labrie
4. Copiez @config/database.yml.example@ dans @config/database.yml@ et éditez ce fichier pour configurer vos paramètres de base dans l'environnement "production".
104 1 Fabrice Phung
105
Exemple pour une base de données MySQL:
106
107 32 Hugues C.
<pre><code class="yaml">
108 8 yannick quenec'hdu
production:
109
  adapter: mysql
110
  database: redmine
111
  host: localhost
112 1 Fabrice Phung
  username: redmine
113
  password: my_password
114 32 Hugues C.
</code></pre>
115 8 yannick quenec'hdu
116
Si votre serveur ne fonctionne pas sur le port standard (3306), utiliser plutôt cette configuration:
117
118 32 Hugues C.
<pre><code class="yaml">
119 8 yannick quenec'hdu
production:
120
  adapter: mysql
121
  database: redmine
122 1 Fabrice Phung
  host: localhost
123
  port: 3307
124 8 yannick quenec'hdu
  username: redmine
125 1 Fabrice Phung
  password: my_password
126 32 Hugues C.
</code></pre>
127 8 yannick quenec'hdu
128
129 20 Jean-Baptiste Barth
Exemple pour la base de données PostgreSQL (port par défaut):
130 11 yannick quenec'hdu
131 32 Hugues C.
<pre><code class="yaml">
132 8 yannick quenec'hdu
production:
133
  adapter: postgresql
134 11 yannick quenec'hdu
  database: <le nom de votre base de données>
135 20 Jean-Baptiste Barth
  host: <nom de la machine de la DB>
136 8 yannick quenec'hdu
  username: <identifiant postgres>
137
  password: <mot de passe postgres>
138 1 Fabrice Phung
  encoding: utf8
139
  schema_search_path: <schéma de la base de données> (par défaut - public)
140 32 Hugues C.
</code></pre>
141 1 Fabrice Phung
142 25 Pierre Labrie
5. Générer un secret de session.
143 1 Fabrice Phung
144 25 Pierre Labrie
* Avec Redmine 1.4.x:
145 1 Fabrice Phung
146 25 Pierre Labrie
<pre>
147
rake generate_session_store
148
</pre>
149 1 Fabrice Phung
150 25 Pierre Labrie
* Avec Redmine 2.x:
151 1 Fabrice Phung
152 25 Pierre Labrie
<pre>
153
rake generate_secret_token
154
</pre>
155 1 Fabrice Phung
156
157 25 Pierre Labrie
6. Créez la structure de base en lançant la commande suivante depuis le répertoire racine de l'application:
158 1 Fabrice Phung
159 25 Pierre Labrie
<pre>
160
RAILS_ENV=production rake db:migrate
161
</pre>
162
163 1 Fabrice Phung
Ceci va créer les tables et le compte administrateur.
164
165 25 Pierre Labrie
Si vous obtenez cette erreur:
166 13 yannick quenec'hdu
<pre>
167 8 yannick quenec'hdu
Rake aborted!
168
no such file to load -- net/https
169 1 Fabrice Phung
</pre>
170 8 yannick quenec'hdu
171 25 Pierre Labrie
Vous devez installer libopenssl-ruby1.8 dans Ubuntu avec cette commande: @apt-get install libopenssl-ruby1.8@
172 8 yannick quenec'hdu
173 25 Pierre Labrie
174
7. Insérez les données de la configuration par défaut dans la base en lançant la commande suivante:
175
176
<pre>
177
RAILS_ENV=production rake redmine:load_default_data
178
</pre>
179
180 14 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.
181 1 Fabrice Phung
182
8. Paramétrez les permissions
183
184
NB: _Les utilisateurs sous Windows doivent sauter cette section._
185
186
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).
187
188
A supposer que vous fassiez fonctionner Redmine avec un utilisateur @redmine@:
189
190
<pre>
191
mkdir tmp public/plugin_assets
192
sudo chown -R redmine:redmine files log tmp public/plugin_assets
193
sudo chmod -R 755 files log tmp public/plugin_assets
194
</pre>
195 8 yannick quenec'hdu
196 1 Fabrice Phung
9. Testez l'installation en exécutant le serveur web WEBrick:
197 8 yannick quenec'hdu
198 25 Pierre Labrie
* Avec Redmine 1.4.x:
199
200
<pre>
201
ruby script/server webrick -e production
202
</pre>
203
204
* Avec Redmine 2.x:
205
206
<pre>
207
ruby script/rails server webrick -e production
208
</pre>
209
210 11 yannick quenec'hdu
211 1 Fabrice Phung
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.
212 14 yannick quenec'hdu
213 2 Fabrice Phung
10. Utilisez le compte administrateur par défaut pour vous connecter:
214
215
    * identifiant: admin
216
    * mot de passe: admin
217
218
Vous pouvez aller sur  @Administration@ pour modifier la configuration de l'application.
219
220 28 Pierre Labrie
h2. Configuration
221 8 yannick quenec'hdu
222 28 Pierre Labrie
Depuis la version 1.2.0, les configurations de Redmine sont définies dans le fichier @config/configuration.yml@.
223 1 Fabrice Phung
224 28 Pierre Labrie
Copier le fichier @config/configuration.yml.example@ en @config/configuration.yml@ et éditer le fichier pour adapter les paramètres SMTP et surcharger les configuration par défaut; le fichier est bien documenté par lui-même et devrait vous guider facilement.
225 8 yannick quenec'hdu
226 28 Pierre Labrie
Les configurations peuvent être définies par environnements _Rails_(production/development/test).
227
228 29 Pierre Labrie
Ne pas oublier de redémarrer l'application après avoir effectué les modifications
229 1 Fabrice Phung
230 28 Pierre Labrie
h3. Configuration du serveur SMTP
231 8 yannick quenec'hdu
232 29 Pierre Labrie
La configuration du SMTP fait l'objet d'un article distinct. Consultez les  [[frRedmineConfigurationEmail|exemples de configuration de mail]].
233 28 Pierre Labrie
234 8 yannick quenec'hdu
h3. Sauvegarde
235 11 yannick quenec'hdu
236 10 yannick quenec'hdu
Une sauvegarde Redmine inclue les éléments suivants:
237 11 yannick quenec'hdu
* Les données (stockées dans votre base de données Redmine)
238 8 yannick quenec'hdu
* Les fichiers (Stockés dans le répertoire @files@ de votre installation de Redmine)
239 10 yannick quenec'hdu
240 8 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)
241
242 10 yannick quenec'hdu
<pre>
243 8 yannick quenec'hdu
# Base de données
244
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz
245 10 yannick quenec'hdu
246 1 Fabrice Phung
# Fichiers
247
rsync -a /path/to/redmine/files /path/to/backup/files
248
</pre>
249 28 Pierre Labrie
250
Pour Windows, Robocopy fonctionne efficacement pour les fichiers avec sa fonctionnalité mirroir.
251
<pre>
252
Robocopy /path/to/redmine/files /path/to/backup/files /MIR
253
</pre>
254
255 12 yannick quenec'hdu
256 1 Fabrice Phung
h2. Notes à propos de l'installation sur Windows
257 10 yannick quenec'hdu
258 1 Fabrice Phung
Récupérer et installer  rubyinstaller depuis le site http://rubyforge.org. Depuis le menu démarrer, exécuter la console @cmd@ 
259 10 yannick quenec'hdu
260 1 Fabrice Phung
Depuis la console les commandes suivantes :
261 10 yannick quenec'hdu
262
<pre>
263
RAILS_ENV=production rake db:migrate
264
RAILS_ENV=production rake redmine:load_default_data
265 1 Fabrice Phung
</pre>
266 10 yannick quenec'hdu
267 1 Fabrice Phung
Doivent être changées par les commandes suivantes :
268 10 yannick quenec'hdu
269
<pre>
270
set RAILS_ENV=production
271
rake db:migrate
272
rake redmine:load_default_data
273 1 Fabrice Phung
</pre>  
274 10 yannick quenec'hdu
275 1 Fabrice Phung
Vous pouvez avoir besoin d'installer mysql gem, avec la commande
276
277 10 yannick quenec'hdu
<pre>
278 1 Fabrice Phung
gem install mysql
279 10 yannick quenec'hdu
</pre>
280
281
Et dans certains cas, il peut être nécessaire de copier le fichier  libmysql.dll file dans votre répertoire ruby/bin.
282
Toutes les librairies ne semblent pas fonctionner, récupérer sur  http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll
283
284
h3. Les Problèmes avec MySQL 5.1 et Rails 2.2+
285
286
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 :
287
288
Télécharger le fichier DLL depuis le projet InstantRails:
289
290
http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll
291
292
Copier ce fichier dans le répertoire  \Ruby\bin directory et essayer d'effectuer une nouvelle fois votre commande rake.
293 21 Ame Nomade
294 10 yannick quenec'hdu
h2. Alternative à l'installation manuelle 
295
296 1 Fabrice Phung
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]].