FrRedmineInstall » History » Version 9

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