FrRedmineInstall » History » Version 24

Pierre Labrie, 2012-09-21 18:22

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
50 1 Fabrice Phung
h2. Installation
51 1 Fabrice Phung
52 20 Jean-Baptiste Barth
1. [[Download|Téléchargez (en)]] et extrayez l'archive ou faites un [[CheckingoutRedmine|checkout (en)]] de Redmine.
53 1 Fabrice Phung
54 1 Fabrice Phung
2. Créez une base de données vide nommée par exemple @redmine@.
55 1 Fabrice Phung
56 1 Fabrice Phung
Pour MySQL:
57 1 Fabrice Phung
58 1 Fabrice Phung
<pre>
59 8 yannick quenec'hdu
create database redmine character set utf8;
60 8 yannick quenec'hdu
create user 'redmine'@'localhost' identified by 'my_password';
61 8 yannick quenec'hdu
grant all privileges on redmine.* to 'redmine'@'localhost';
62 1 Fabrice Phung
</pre>
63 1 Fabrice Phung
64 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 :
65 8 yannick quenec'hdu
<pre>
66 8 yannick quenec'hdu
grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';
67 8 yannick quenec'hdu
</pre>
68 8 yannick quenec'hdu
69 20 Jean-Baptiste Barth
Pour PostgreSQL:
70 8 yannick quenec'hdu
71 8 yannick quenec'hdu
<pre>
72 8 yannick quenec'hdu
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
73 8 yannick quenec'hdu
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
74 8 yannick quenec'hdu
</pre>
75 8 yannick quenec'hdu
76 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".
77 1 Fabrice Phung
78 1 Fabrice Phung
Exemple pour une base de données MySQL:
79 1 Fabrice Phung
80 8 yannick quenec'hdu
<pre>
81 8 yannick quenec'hdu
production:
82 8 yannick quenec'hdu
  adapter: mysql
83 8 yannick quenec'hdu
  database: redmine
84 8 yannick quenec'hdu
  host: localhost
85 8 yannick quenec'hdu
  username: redmine
86 8 yannick quenec'hdu
  password: my_password
87 8 yannick quenec'hdu
</pre>
88 1 Fabrice Phung
89 8 yannick quenec'hdu
Si votre serveur ne fonctionne pas sur le port standard (3306), utiliser plutôt cette configuration:
90 1 Fabrice Phung
91 8 yannick quenec'hdu
<pre>
92 8 yannick quenec'hdu
production:
93 8 yannick quenec'hdu
  adapter: mysql
94 8 yannick quenec'hdu
  database: redmine
95 8 yannick quenec'hdu
  host: localhost
96 8 yannick quenec'hdu
  port: 3307
97 8 yannick quenec'hdu
  username: redmine
98 8 yannick quenec'hdu
  password: my_password
99 8 yannick quenec'hdu
</pre>
100 8 yannick quenec'hdu
101 8 yannick quenec'hdu
102 8 yannick quenec'hdu
Exemple pour la base de données PostgreSQL (port par défaut):
103 8 yannick quenec'hdu
104 8 yannick quenec'hdu
<pre>
105 8 yannick quenec'hdu
production:
106 8 yannick quenec'hdu
  adapter: postgresql
107 1 Fabrice Phung
  database: <le nom de votre base de données>
108 1 Fabrice Phung
  host: <nom de la machine de la DB>
109 8 yannick quenec'hdu
  username: <identifiant postgres>
110 8 yannick quenec'hdu
  password: <mot de passe postgres>
111 1 Fabrice Phung
  encoding: utf8
112 8 yannick quenec'hdu
  schema_search_path: <schéma de la base de données> (par défaut - public)
113 8 yannick quenec'hdu
</pre>
114 8 yannick quenec'hdu
115 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.
116 11 yannick quenec'hdu
117 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:
118 8 yannick quenec'hdu
119 8 yannick quenec'hdu
   RAILS_ENV=production rake config/initializers/session_store.rb
120 11 yannick quenec'hdu
121 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
122 8 yannick quenec'hdu
123 8 yannick quenec'hdu
   rake generate_session_store
124 8 yannick quenec'hdu
125 8 yannick quenec'hdu
5. Créez la structure de base en lançant la commande suivante depuis le répertoire racine de l'application:
126 8 yannick quenec'hdu
127 1 Fabrice Phung
  rake db:migrate RAILS_ENV="production"
128 1 Fabrice Phung
129 1 Fabrice Phung
Ceci va créer les tables et le compte administrateur.
130 1 Fabrice Phung
131 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:
132 8 yannick quenec'hdu
133 8 yannick quenec'hdu
  rake redmine:load_default_data RAILS_ENV="production"
134 1 Fabrice Phung
135 8 yannick quenec'hdu
Si vous obtenez l'erreur suivante: 
136 8 yannick quenec'hdu
<pre>
137 8 yannick quenec'hdu
Rake aborted!
138 11 yannick quenec'hdu
no such file to load -- net/https
139 8 yannick quenec'hdu
</pre>
140 8 yannick quenec'hdu
141 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@
142 8 yannick quenec'hdu
143 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.
144 2 Fabrice Phung
145 14 yannick quenec'hdu
8. Paramétrez les permissions
146 1 Fabrice Phung
147 1 Fabrice Phung
NB: _Les utilisateurs sous Windows doivent sauter cette section._
148 8 yannick quenec'hdu
149 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).
150 8 yannick quenec'hdu
151 20 Jean-Baptiste Barth
A supposer que vous fassiez fonctionner Redmine avec un utilisateur @redmine@:
152 1 Fabrice Phung
153 8 yannick quenec'hdu
<pre>
154 8 yannick quenec'hdu
mkdir tmp public/plugin_assets
155 8 yannick quenec'hdu
sudo chown -R redmine:redmine files log tmp public/plugin_assets
156 8 yannick quenec'hdu
sudo chmod -R 755 files log tmp public/plugin_assets
157 1 Fabrice Phung
</pre>
158 1 Fabrice Phung
159 14 yannick quenec'hdu
9. Testez l'installation en exécutant le serveur web WEBrick:
160 1 Fabrice Phung
161 8 yannick quenec'hdu
  ruby script/server webrick -e production
162 1 Fabrice Phung
163 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.
164 1 Fabrice Phung
165 14 yannick quenec'hdu
10. Utilisez le compte administrateur par défaut pour vous connecter:
166 2 Fabrice Phung
167 2 Fabrice Phung
    * identifiant: admin
168 2 Fabrice Phung
    * mot de passe: admin
169 2 Fabrice Phung
170 2 Fabrice Phung
Vous pouvez aller sur  @Administration@ pour modifier la configuration de l'application.
171 2 Fabrice Phung
172 2 Fabrice Phung
h2. Configuration du serveur SMTP
173 2 Fabrice Phung
174 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.
175 1 Fabrice Phung
176 8 yannick quenec'hdu
Consulter les exemples de configuration [[frRedmineConfigurationEmail|Exemple de configuration de mail]].
177 8 yannick quenec'hdu
178 11 yannick quenec'hdu
Ne pas oublier de redémarrer l'application après avoir effectué les modifications 
179 8 yannick quenec'hdu
180 8 yannick quenec'hdu
181 8 yannick quenec'hdu
h3. Sauvegarde
182 8 yannick quenec'hdu
183 11 yannick quenec'hdu
Une sauvegarde Redmine inclue les éléments suivants:
184 10 yannick quenec'hdu
* Les données (stockées dans votre base de données Redmine)
185 11 yannick quenec'hdu
* Les fichiers (Stockés dans le répertoire @files@ de votre installation de Redmine)
186 8 yannick quenec'hdu
187 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)
188 8 yannick quenec'hdu
189 8 yannick quenec'hdu
<pre>
190 10 yannick quenec'hdu
# Base de données
191 8 yannick quenec'hdu
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz
192 8 yannick quenec'hdu
193 10 yannick quenec'hdu
# Fichiers
194 1 Fabrice Phung
rsync -a /path/to/redmine/files /path/to/backup/files
195 1 Fabrice Phung
</pre>
196 1 Fabrice Phung
197 12 yannick quenec'hdu
h2. Notes à propos de l'installation sur Windows
198 1 Fabrice Phung
199 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@ 
200 1 Fabrice Phung
201 10 yannick quenec'hdu
Depuis la console les commandes suivantes :
202 1 Fabrice Phung
203 10 yannick quenec'hdu
<pre>
204 10 yannick quenec'hdu
RAILS_ENV=production rake db:migrate
205 10 yannick quenec'hdu
RAILS_ENV=production rake redmine:load_default_data
206 10 yannick quenec'hdu
</pre>
207 1 Fabrice Phung
208 10 yannick quenec'hdu
Doivent être changées par les commandes suivantes :
209 1 Fabrice Phung
210 10 yannick quenec'hdu
<pre>
211 10 yannick quenec'hdu
set RAILS_ENV=production
212 10 yannick quenec'hdu
rake db:migrate
213 10 yannick quenec'hdu
rake redmine:load_default_data
214 10 yannick quenec'hdu
</pre>  
215 1 Fabrice Phung
216 10 yannick quenec'hdu
Vous pouvez avoir besoin d'installer mysql gem, avec la commande
217 1 Fabrice Phung
218 1 Fabrice Phung
<pre>
219 10 yannick quenec'hdu
gem install mysql
220 1 Fabrice Phung
</pre>
221 10 yannick quenec'hdu
222 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.
223 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
224 10 yannick quenec'hdu
225 10 yannick quenec'hdu
h3. Les Problèmes avec MySQL 5.1 et Rails 2.2+
226 10 yannick quenec'hdu
227 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 :
228 10 yannick quenec'hdu
229 10 yannick quenec'hdu
Télécharger le fichier DLL depuis le projet InstantRails:
230 10 yannick quenec'hdu
231 10 yannick quenec'hdu
http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll
232 10 yannick quenec'hdu
233 10 yannick quenec'hdu
Copier ce fichier dans le répertoire  \Ruby\bin directory et essayer d'effectuer une nouvelle fois votre commande rake.
234 10 yannick quenec'hdu
235 21 Ame Nomade
h2. Alternative à l'installation manuelle 
236 10 yannick quenec'hdu
237 10 yannick quenec'hdu
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]].