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