FrRedmineInstall » History » Version 25

Pierre Labrie, 2012-09-21 18:54

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