Project

General

Profile

FrRedmineInstall » History » Version 8

yannick quenec'hdu, 2010-05-14 19:45

1 1 Fabrice Phung
h1. Installer Redmine
2
3
{{>TOC}}
4
5 8 yannick quenec'hdu
h2. Exigences
6
h3. Système d'exploitation 
7
Redmine devrait fonctionner sur la plupart des Unix, Linux, Mac et systèmes Windows systems aussi longtemps que Ruby est disponible sur cette plate-forme.
8 1 Fabrice Phung
9 8 yannick quenec'hdu
h3. Prérequis
10 1 Fabrice Phung
11 8 yannick quenec'hdu
* Le version de Ruby et Ruby on Rails pour une version donnée de Redmine:
12 1 Fabrice Phung
13 8 yannick quenec'hdu
|_. Version de Redmine|_. Versions de Ruby supportés|_. Version de Rails exigée|_. Version de Rails exigée|
14
|current trunk|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1|
15
|trunk from r2493 to r2886|ruby 1.8.6, 1.8.7|Rails 2.2.2||
16
|trunk before r2493|ruby 1.8.6, 1.8.7|Rails 2.1.2||
17
|0.9.x|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1|
18
|0.8.x|ruby 1.8.6, 1.8.7|Rails 2.1.2||
19
|0.7.x|ruby 1.8.6|Rails 2.0.2||
20
21 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 :
22
23 8 yannick quenec'hdu
 gem install rails -v=2.3.5 
24 2 Fabrice Phung
25 8 yannick quenec'hdu
Notes:
26
* *Ruby 1.9 n'est pas supporté.* Vous _devez_ utiliser Ruby 1.8.x comme indiqué au dessus.
27
* RubyGems 1.3.1 est obligatoire
28
* Rake 0.8.3 est obligatoire
29
30 1 Fabrice Phung
* Une base de données
31
32
* MySQL 4.1 ou plus (recommandé)
33 8 yannick quenec'hdu
* Assurez-vous d'avoir installer les lien sen C pour Ruby qui améliorent considérablement les performances. Vous pouvez les obtenir en exécutant la commande @ gem install mysql @.
34
 * Le gem Ruby MySQL ne supporte pas actuellement MySQL 5.1
35
36 1 Fabrice Phung
* PostgreSQL 8
37 8 yannick quenec'hdu
38
 * Il faut être sur que le format de date (datestyle) de votre base de données est positionnée (Paramètres par défaut). Vous pouvez la positionner avec la commande: @ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";@
39
 * Certaines anomalies dans PostgreSQL 8.4.0 et 8.4.1 affecte le comportement de Redmine (#4259, #4314), elles sont corrigées dans PostgreSQL 8.4.2
40
 * Installer l'adapter PosgreSQL pour Ruby. Vous pouvez le faire en utilisant une des techniques suivantes :
41
 **  @gem install postgres-pr@
42
 **  @gem install pg@ (fonctionne avec une connexion SSL, peut nécessiter les librairies de développement libraries/packages pour votre OS avant la compilation)
43
 *** 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@
44
45
46 1 Fabrice Phung
* SQLite 3 (svp lisez ceci: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails)
47
48 8 yannick quenec'hdu
49 1 Fabrice Phung
* Optionnel:
50
51 8 yannick quenec'hdu
    * binaires SCM  (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.
52
      *  (to enable Gantt export to png image)
53
      * "RMagick":http://rmagick.rubyforge.org/ (pour activer l'export Gantt dans une image au format png)
54
      * "Ruby OpenID Library":http://openidenabled.com/ruby-openid/ (Pour activer le support  OpenID) [seulement sur pour le trunck de Redmine / 0.9-dev]  La version 2 ou supérieure est obligatoire.
55 1 Fabrice Phung
56
57
h2. Installation
58
59
1. [[Download|Téléchargez]] et extrayez l'archive ou faites un [[CheckingoutRedmine|checkout]] de Redmine.
60
61
2. Créez une base de données vide nommée par exemple @redmine@.
62
63
Pour MySQL:
64
65 8 yannick quenec'hdu
<pre>
66
create database redmine character set utf8;
67
create user 'redmine'@'localhost' identified by 'my_password';
68
grant all privileges on redmine.* to 'redmine'@'localhost';
69
</pre>
70 1 Fabrice Phung
71 8 yannick quenec'hdu
Pour les versions de MySQL antérieures à la 5.0.2 - passer l'étape 'create user' et opter plutôt pour cette commande :
72
<pre>
73
grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';
74
</pre>
75
76
For PostgreSQL:
77
78
<pre>
79
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
80
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
81
</pre>
82
83 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".
84
85
Exemple pour une base de données MySQL:
86
87 8 yannick quenec'hdu
<pre>
88
production:
89
  adapter: mysql
90
  database: redmine
91
  host: localhost
92
  username: redmine
93
  password: my_password
94
</pre>
95 1 Fabrice Phung
96 8 yannick quenec'hdu
Si votre serveur ne fonctionne pas sur le port standard (3306), utiliser plutôt cette configuration:
97 1 Fabrice Phung
98 8 yannick quenec'hdu
<pre>
99
production:
100
  adapter: mysql
101
  database: redmine
102
  host: localhost
103
  port: 3307
104
  username: redmine
105
  password: my_password
106
</pre>
107
108
109
Exemple pour la base de données PostgreSQL (port par défaut):
110
111
<pre>
112
production:
113
  adapter: postgresql
114
  database: <le nom de votre base de données>
115
  host: <nom de la machine de la DB>
116
  username: <identifiant postgres>
117
  password: <mot de passe postgres>
118
  encoding: utf8
119
  schema_search_path: <schéma de la base de données> (par défaut - public)
120
</pre>
121
122
4. Générer une secret de session. Il est obligatoire depuis le trunck r2493 ou pour les versions de Redmine released 0.8.7 et supérieure.
123
124
Redmine stocke les données de session dans un cookie par défaut, ce qui nécessite un secret pour être générées. Ceci peut être fait en exécutant:
125
126
   RAILS_ENV=production rake config/initializers/session_store.rb
127
128
Si vous utilisez une version de Redmine postérieur à r3055, le fichier ci-dessus n'existent plus, il était obsolète sur le r3054. Sur ces versions, exécutez
129
130
   rake generate_session_store
131
132
133
5. Créez la structure de base en lançant la commande suivante depuis le répertoire racine de l'application:
134
135 1 Fabrice Phung
  rake db:migrate RAILS_ENV="production"
136
137
Ceci va créer les tables et le compte administrateur.
138
139
5. Insérez les données de la configuration par défaut dans la base en lançant la commande suivante:
140
141
  rake redmine:load_default_data RAILS_ENV="production"
142
143 8 yannick quenec'hdu
Si vous obtenez l'erreur suivante: 
144
<pre>
145
Rake aborted!
146
no such file to load -- net/https
147
</pre>
148
149
Vous devez installer la librairie libopenssl-ruby1.8, depuis ubuntu, executer la commande suivante : apt-get install libopenssl-ruby1.8
150
151
6. Insérer les données de configuration par default dans la base de données, en exécutant la commande suivante:
152
153
  RAILS_ENV=production rake redmine:load_default_data
154
155 2 Fabrice Phung
Cette étape est optionnelle mais *fortement recommandée*, sauf si vous définissez votre propre configuration depuis rien. Elle va charger les rôles par défaut, les trackers, statuts, workflows et énumérations.
156
157 8 yannick quenec'hdu
7. Paramétrez les permissions
158 1 Fabrice Phung
159
NB: _Les utilisateurs sous Windows doivent sauter cette section._
160
161 8 yannick quenec'hdu
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).
162 1 Fabrice Phung
163 8 yannick quenec'hdu
A supposer que vous fassiez fonctionner Redmine avec un utilisateur@redmine@:
164 1 Fabrice Phung
165
<pre>
166 8 yannick quenec'hdu
mkdir tmp public/plugin_assets
167
sudo chown -R redmine:redmine files log tmp public/plugin_assets
168
sudo chmod -R 755 files log tmp public/plugin_assets
169
</pre>
170 1 Fabrice Phung
171
172 8 yannick quenec'hdu
8. Testez l'installation en exécutant le serveur web WEBrick:
173 1 Fabrice Phung
174 8 yannick quenec'hdu
  ruby script/server webrick -e production
175 1 Fabrice Phung
176 8 yannick quenec'hdu
Une fois WEBrick démarré, saisir l'URL dans votre navigateur http://localhost:3000/. Vous devriez voir apparaitre la page de bienvenue de Redmine.
177 1 Fabrice Phung
178 2 Fabrice Phung
8. Utilisez le compte administrateur par défaut pour vous connecter:
179
180
    * identifiant: admin
181
    * mot de passe: admin
182
183
Vous pouvez aller sur  @Administration@ pour modifier la configuration de l'application.
184
185
h2. Configuration du serveur SMTP
186
187 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.
188 1 Fabrice Phung
189 8 yannick quenec'hdu
Consulter les exemples de configuration [[frRedmineConfigurationEmail|Exemple de configuration de mail]].
190
191
Ne pas oublier de redémarrer l'application après avoir effectuer les modifications 
192
193
194
h3. Sauvegarde
195
196
Une sauvegarde Redmine inclue les élements suivants:
197
* data (stored in your redmine database)
198
* attachments (stored in the @files@ directory of your Redmine install)
199
200
Here is a simple shell script that can be used for daily backups (assuming you're using a mysql database):
201
202
<pre>
203
# Database
204
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz
205
206
# Attachments
207
rsync -a /path/to/redmine/files /path/to/backup/files
208
</pre>
209 1 Fabrice Phung
210
h3. versions 0.7.x
211
212
Dans config/environment.rb, vous pouvez configurer les paramètres de votre serveur SMTP:
213
214
    * config.action_mailer.smtp_settings: configuration du serveur SMTP
215
    * config.action_mailer.perform_deliveries: mettre à false pour désactiver l'envoi de messages
216
217
N'oubliez pas de redémarrer l'application après toute modification.
218
219
h2. Sauvegarde
220
221
Les sauvegardes Redmine devraient inclure:
222
* les données (stockées dans votre base de données redmine)
223
* pièces jointes (stockées dans le répertoire @files@ de votre installation Redmine)
224
225
Voici un simple script shell pouvant être utilisé pour des sauvegardes quotidiennes (à supposer que vous utilisez une base mysql):
226
227
<pre>
228
# Base
229
/usr/bin/mysqldump -u <utilisateur> -p <motdepasse> <base_redmine> | gzip > /chemin/vers/sauvegarde/db/redmine_`date +%y_%m_%d`.gz
230
231
# Pièces jointes
232
rsync -a /chemin/vers/redmine/files /chemin/vers/sauvegarde/files
233
</pre>