FrRedmineInstall » History » Version 8

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

1 1 Fabrice Phung
h1. Installer Redmine
2 1 Fabrice Phung
3 1 Fabrice Phung
{{>TOC}}
4 1 Fabrice Phung
5 8 yannick quenec'hdu
h2. Exigences
6 8 yannick quenec'hdu
h3. Système d'exploitation 
7 8 yannick quenec'hdu
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 8 yannick quenec'hdu
|current trunk|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1|
15 8 yannick quenec'hdu
|trunk from r2493 to r2886|ruby 1.8.6, 1.8.7|Rails 2.2.2||
16 8 yannick quenec'hdu
|trunk before r2493|ruby 1.8.6, 1.8.7|Rails 2.1.2||
17 8 yannick quenec'hdu
|0.9.x|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1|
18 8 yannick quenec'hdu
|0.8.x|ruby 1.8.6, 1.8.7|Rails 2.1.2||
19 8 yannick quenec'hdu
|0.7.x|ruby 1.8.6|Rails 2.0.2||
20 8 yannick quenec'hdu
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 1 Fabrice Phung
23 8 yannick quenec'hdu
 gem install rails -v=2.3.5 
24 2 Fabrice Phung
25 8 yannick quenec'hdu
Notes:
26 8 yannick quenec'hdu
* *Ruby 1.9 n'est pas supporté.* Vous _devez_ utiliser Ruby 1.8.x comme indiqué au dessus.
27 8 yannick quenec'hdu
* RubyGems 1.3.1 est obligatoire
28 8 yannick quenec'hdu
* Rake 0.8.3 est obligatoire
29 8 yannick quenec'hdu
30 1 Fabrice Phung
* Une base de données
31 1 Fabrice Phung
32 1 Fabrice Phung
* 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 8 yannick quenec'hdu
 * Le gem Ruby MySQL ne supporte pas actuellement MySQL 5.1
35 8 yannick quenec'hdu
36 1 Fabrice Phung
* PostgreSQL 8
37 8 yannick quenec'hdu
38 8 yannick quenec'hdu
 * 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 8 yannick quenec'hdu
 * 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 8 yannick quenec'hdu
 * Installer l'adapter PosgreSQL pour Ruby. Vous pouvez le faire en utilisant une des techniques suivantes :
41 8 yannick quenec'hdu
 **  @gem install postgres-pr@
42 8 yannick quenec'hdu
 **  @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 8 yannick quenec'hdu
 *** 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 8 yannick quenec'hdu
45 8 yannick quenec'hdu
46 1 Fabrice Phung
* SQLite 3 (svp lisez ceci: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails)
47 1 Fabrice Phung
48 8 yannick quenec'hdu
49 1 Fabrice Phung
* Optionnel:
50 1 Fabrice Phung
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 8 yannick quenec'hdu
      *  (to enable Gantt export to png image)
53 8 yannick quenec'hdu
      * "RMagick":http://rmagick.rubyforge.org/ (pour activer l'export Gantt dans une image au format png)
54 8 yannick quenec'hdu
      * "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 1 Fabrice Phung
57 1 Fabrice Phung
h2. Installation
58 1 Fabrice Phung
59 1 Fabrice Phung
1. [[Download|Téléchargez]] et extrayez l'archive ou faites un [[CheckingoutRedmine|checkout]] de Redmine.
60 1 Fabrice Phung
61 1 Fabrice Phung
2. Créez une base de données vide nommée par exemple @redmine@.
62 1 Fabrice Phung
63 1 Fabrice Phung
Pour MySQL:
64 1 Fabrice Phung
65 8 yannick quenec'hdu
<pre>
66 8 yannick quenec'hdu
create database redmine character set utf8;
67 8 yannick quenec'hdu
create user 'redmine'@'localhost' identified by 'my_password';
68 8 yannick quenec'hdu
grant all privileges on redmine.* to 'redmine'@'localhost';
69 8 yannick quenec'hdu
</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 8 yannick quenec'hdu
<pre>
73 8 yannick quenec'hdu
grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';
74 8 yannick quenec'hdu
</pre>
75 8 yannick quenec'hdu
76 8 yannick quenec'hdu
For PostgreSQL:
77 8 yannick quenec'hdu
78 8 yannick quenec'hdu
<pre>
79 8 yannick quenec'hdu
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
80 8 yannick quenec'hdu
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
81 8 yannick quenec'hdu
</pre>
82 8 yannick quenec'hdu
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 1 Fabrice Phung
85 1 Fabrice Phung
Exemple pour une base de données MySQL:
86 1 Fabrice Phung
87 8 yannick quenec'hdu
<pre>
88 8 yannick quenec'hdu
production:
89 8 yannick quenec'hdu
  adapter: mysql
90 8 yannick quenec'hdu
  database: redmine
91 8 yannick quenec'hdu
  host: localhost
92 8 yannick quenec'hdu
  username: redmine
93 8 yannick quenec'hdu
  password: my_password
94 8 yannick quenec'hdu
</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 8 yannick quenec'hdu
production:
100 8 yannick quenec'hdu
  adapter: mysql
101 8 yannick quenec'hdu
  database: redmine
102 8 yannick quenec'hdu
  host: localhost
103 8 yannick quenec'hdu
  port: 3307
104 8 yannick quenec'hdu
  username: redmine
105 8 yannick quenec'hdu
  password: my_password
106 8 yannick quenec'hdu
</pre>
107 8 yannick quenec'hdu
108 8 yannick quenec'hdu
109 8 yannick quenec'hdu
Exemple pour la base de données PostgreSQL (port par défaut):
110 8 yannick quenec'hdu
111 8 yannick quenec'hdu
<pre>
112 8 yannick quenec'hdu
production:
113 8 yannick quenec'hdu
  adapter: postgresql
114 8 yannick quenec'hdu
  database: <le nom de votre base de données>
115 8 yannick quenec'hdu
  host: <nom de la machine de la DB>
116 8 yannick quenec'hdu
  username: <identifiant postgres>
117 8 yannick quenec'hdu
  password: <mot de passe postgres>
118 8 yannick quenec'hdu
  encoding: utf8
119 8 yannick quenec'hdu
  schema_search_path: <schéma de la base de données> (par défaut - public)
120 8 yannick quenec'hdu
</pre>
121 8 yannick quenec'hdu
122 8 yannick quenec'hdu
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 8 yannick quenec'hdu
124 8 yannick quenec'hdu
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 8 yannick quenec'hdu
126 8 yannick quenec'hdu
   RAILS_ENV=production rake config/initializers/session_store.rb
127 8 yannick quenec'hdu
128 8 yannick quenec'hdu
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 8 yannick quenec'hdu
130 8 yannick quenec'hdu
   rake generate_session_store
131 8 yannick quenec'hdu
132 8 yannick quenec'hdu
133 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:
134 8 yannick quenec'hdu
135 1 Fabrice Phung
  rake db:migrate RAILS_ENV="production"
136 1 Fabrice Phung
137 1 Fabrice Phung
Ceci va créer les tables et le compte administrateur.
138 1 Fabrice Phung
139 1 Fabrice Phung
5. Insérez les données de la configuration par défaut dans la base en lançant la commande suivante:
140 1 Fabrice Phung
141 1 Fabrice Phung
  rake redmine:load_default_data RAILS_ENV="production"
142 1 Fabrice Phung
143 8 yannick quenec'hdu
Si vous obtenez l'erreur suivante: 
144 8 yannick quenec'hdu
<pre>
145 8 yannick quenec'hdu
Rake aborted!
146 8 yannick quenec'hdu
no such file to load -- net/https
147 8 yannick quenec'hdu
</pre>
148 8 yannick quenec'hdu
149 8 yannick quenec'hdu
Vous devez installer la librairie libopenssl-ruby1.8, depuis ubuntu, executer la commande suivante : apt-get install libopenssl-ruby1.8
150 8 yannick quenec'hdu
151 8 yannick quenec'hdu
6. Insérer les données de configuration par default dans la base de données, en exécutant la commande suivante:
152 8 yannick quenec'hdu
153 8 yannick quenec'hdu
  RAILS_ENV=production rake redmine:load_default_data
154 8 yannick quenec'hdu
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 2 Fabrice Phung
157 8 yannick quenec'hdu
7. Paramétrez les permissions
158 1 Fabrice Phung
159 1 Fabrice Phung
NB: _Les utilisateurs sous Windows doivent sauter cette section._
160 1 Fabrice Phung
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 1 Fabrice Phung
<pre>
166 8 yannick quenec'hdu
mkdir tmp public/plugin_assets
167 8 yannick quenec'hdu
sudo chown -R redmine:redmine files log tmp public/plugin_assets
168 8 yannick quenec'hdu
sudo chmod -R 755 files log tmp public/plugin_assets
169 8 yannick quenec'hdu
</pre>
170 1 Fabrice Phung
171 1 Fabrice Phung
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 2 Fabrice Phung
180 2 Fabrice Phung
    * identifiant: admin
181 2 Fabrice Phung
    * mot de passe: admin
182 2 Fabrice Phung
183 2 Fabrice Phung
Vous pouvez aller sur  @Administration@ pour modifier la configuration de l'application.
184 2 Fabrice Phung
185 2 Fabrice Phung
h2. Configuration du serveur SMTP
186 2 Fabrice Phung
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 8 yannick quenec'hdu
191 8 yannick quenec'hdu
Ne pas oublier de redémarrer l'application après avoir effectuer les modifications 
192 8 yannick quenec'hdu
193 8 yannick quenec'hdu
194 8 yannick quenec'hdu
h3. Sauvegarde
195 8 yannick quenec'hdu
196 8 yannick quenec'hdu
Une sauvegarde Redmine inclue les élements suivants:
197 8 yannick quenec'hdu
* data (stored in your redmine database)
198 8 yannick quenec'hdu
* attachments (stored in the @files@ directory of your Redmine install)
199 8 yannick quenec'hdu
200 8 yannick quenec'hdu
Here is a simple shell script that can be used for daily backups (assuming you're using a mysql database):
201 8 yannick quenec'hdu
202 8 yannick quenec'hdu
<pre>
203 8 yannick quenec'hdu
# Database
204 8 yannick quenec'hdu
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz
205 8 yannick quenec'hdu
206 8 yannick quenec'hdu
# Attachments
207 8 yannick quenec'hdu
rsync -a /path/to/redmine/files /path/to/backup/files
208 8 yannick quenec'hdu
</pre>
209 1 Fabrice Phung
210 1 Fabrice Phung
h3. versions 0.7.x
211 1 Fabrice Phung
212 1 Fabrice Phung
Dans config/environment.rb, vous pouvez configurer les paramètres de votre serveur SMTP:
213 1 Fabrice Phung
214 1 Fabrice Phung
    * config.action_mailer.smtp_settings: configuration du serveur SMTP
215 1 Fabrice Phung
    * config.action_mailer.perform_deliveries: mettre à false pour désactiver l'envoi de messages
216 1 Fabrice Phung
217 1 Fabrice Phung
N'oubliez pas de redémarrer l'application après toute modification.
218 1 Fabrice Phung
219 1 Fabrice Phung
h2. Sauvegarde
220 1 Fabrice Phung
221 1 Fabrice Phung
Les sauvegardes Redmine devraient inclure:
222 1 Fabrice Phung
* les données (stockées dans votre base de données redmine)
223 1 Fabrice Phung
* pièces jointes (stockées dans le répertoire @files@ de votre installation Redmine)
224 1 Fabrice Phung
225 1 Fabrice Phung
Voici un simple script shell pouvant être utilisé pour des sauvegardes quotidiennes (à supposer que vous utilisez une base mysql):
226 1 Fabrice Phung
227 1 Fabrice Phung
<pre>
228 1 Fabrice Phung
# Base
229 1 Fabrice Phung
/usr/bin/mysqldump -u <utilisateur> -p <motdepasse> <base_redmine> | gzip > /chemin/vers/sauvegarde/db/redmine_`date +%y_%m_%d`.gz
230 1 Fabrice Phung
231 1 Fabrice Phung
# Pièces jointes
232 1 Fabrice Phung
rsync -a /chemin/vers/redmine/files /chemin/vers/sauvegarde/files
233 1 Fabrice Phung
</pre>