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> |