Projet

Général

Profil

Wiki » Historique » Version 233

Patrice Nadeau, 2018-08-17 13:13

1 214 Patrice Nadeau
# Redmine
2 6 Patrice Nadeau
3 31 Patrice Nadeau
Logiciel de gestion de projets, sources, bugs et timeline.
4
Contient un module de Wiki, de fichiers.
5
Supporte aussi les systèmes de version de fichier (Git, SVN entre autre).
6
Disponible à http://www.redmine.org/projects/redmine/wiki/Download
7
8
De base, ne fonctionne pas avec Apache
9 1 Patrice Nadeau
10
Sa principale difficulté d’installation est sa dépendance à Ruby.
11
Voir aussi :
12 219 Patrice Nadeau
13 1 Patrice Nadeau
* http://bitnami.com/stack/redmine
14
* http://www.turnkeylinux.org/redmine
15
16 121 Patrice Nadeau
{{lastupdated_at}} {{lastupdated_by}}
17
18 94 Patrice Nadeau
---
19 31 Patrice Nadeau
20 94 Patrice Nadeau
{{toc}}
21
22 214 Patrice Nadeau
## Installation
23 94 Patrice Nadeau
24 32 Patrice Nadeau
Ce guide documente une installation GNU/Linux avec les version suivantes :
25 225 Patrice Nadeau
* openSUSE Leap 15
26 231 Patrice Nadeau
* Redmine 3.4.6
27 32 Patrice Nadeau
28 214 Patrice Nadeau
### Prérequis
29 1 Patrice Nadeau
30
Un serveur *LAMP(Linux, Apache, MySQL, PHP)* [[guides_opensuse:|openSUSE]] *fonctionnel*.
31 56 Patrice Nadeau
32 44 Patrice Nadeau
Les logiciels supplémentaires suivants :
33 207 Patrice Nadeau
34 225 Patrice Nadeau
    zypper install libmysqlclient-devel ruby-2.5 ruby2.5-devel ImageMagick ImageMagick-devel libxml2-devel libxslt-devel libmariadb-devl git gcc make gcc-c++
35 32 Patrice Nadeau
36 214 Patrice Nadeau
### MySQL
37 94 Patrice Nadeau
38 32 Patrice Nadeau
Création de la base de donnés.
39
Substituer les items suivants à votre choix :
40 214 Patrice Nadeau
41 32 Patrice Nadeau
* redmine : Usager pour la base de donnés.
42 224 Patrice Nadeau
* password : Mot de passe de la base de données.
43 32 Patrice Nadeau
* db : Nom de la base de donnés.
44
45 1 Patrice Nadeau
Lancer MySQL :
46 32 Patrice Nadeau
47 219 Patrice Nadeau
    mysql -u root -p
48
49 1 Patrice Nadeau
Commandes MySQL :
50
51 219 Patrice Nadeau
    create database db character set utf8;
52
    create user 'redmine'@'localhost' identified by 'password';
53
    grant all privileges on db.* to 'redmine'@'localhost';
54
    commit;
55
    quit;
56
57
58 32 Patrice Nadeau
### Redmine
59 214 Patrice Nadeau
60 225 Patrice Nadeau
L’installation sera faite dans **\srv\redmine** (exemple avec la version 3.4)
61 189 Patrice Nadeau
62 219 Patrice Nadeau
    cd /srv/
63
    svn co http://svn.redmine.org/redmine/branches/3.1-stable redmine
64
    cd redmine
65
    cp config/database.yml.example config/database.yml
66
    cp config/configuration.yml.example config/configuration.yml
67
    mkdir public/plugin_assets
68
69
70 33 Patrice Nadeau
Si un usager MySQL autre que _root_ ou mot de passe diffèrent est utilisé :
71 219 Patrice Nadeau
Éditer le fichier **config/database.yml**, section *Production* et modifier les lignes :
72 1 Patrice Nadeau
73 219 Patrice Nadeau
* **username**
74
* **password**
75 33 Patrice Nadeau
76 219 Patrice Nadeau
Éditer le fichier **config/configuration.yml** et modifier la configuration SMTP.
77
78 214 Patrice Nadeau
### Ruby
79 33 Patrice Nadeau
80 34 Patrice Nadeau
Installation des gems de Ruby
81 1 Patrice Nadeau
82 219 Patrice Nadeau
    cd redmine
83
    gem install bundler
84 227 Patrice Nadeau
    bundle.ruby2.5 install --without development test
85 219 Patrice Nadeau
86 1 Patrice Nadeau
### Initialisation
87 214 Patrice Nadeau
88 1 Patrice Nadeau
Création de la cryptographie, de la structure et des donnés de base :
89
90 233 Patrice Nadeau
```bash
91
cd /srv/redmine
92
rake generate_secret_token
93
RAILS_ENV=production rake db:migrate
94
RAILS_ENV=production rake redmine:load_default_data
95
```
96 219 Patrice Nadeau
97 231 Patrice Nadeau
### Test
98 1 Patrice Nadeau
99 231 Patrice Nadeau
Le serveur inclus _webrick_ n'est pas conçu pour être utilisé en production.
100 1 Patrice Nadeau
101 231 Patrice Nadeau
Ouvrir dans le pare-feu le port TCP 3000 (ou simplement desactiver temporairement le parefeu) :
102 214 Patrice Nadeau
103 232 Patrice Nadeau
```bash
104
yast firewall services add tcpport=3000 zone=EXT
105
```
106 45 Patrice Nadeau
107 231 Patrice Nadeau
Se rendre au `server.tld:3000`
108 45 Patrice Nadeau
109 231 Patrice Nadeau
### Apache
110 45 Patrice Nadeau
111 54 Patrice Nadeau
Information provenant de :
112 219 Patrice Nadeau
113 54 Patrice Nadeau
* web : 
114 219 Patrice Nadeau
    * http://martin-denizet.com/install-redmine-2-5-x-with-git-and-subversion-on-debian-with-apache2-rvm-and-passenger/ 
115
    * http://www.redmine.org/projects/redmine/wiki/HowTo_configure_Apache_to_run_Redmine
116
    * http://www.redmine.org/boards/2/topics/43924
117 214 Patrice Nadeau
* livre : "Mastering Redmine":http://shop.oreilly.com/product/9781849519144.do
118 1 Patrice Nadeau
119 166 Patrice Nadeau
### Modules Apache
120
121 46 Patrice Nadeau
> Apache 2.4
122 45 Patrice Nadeau
123
Ajout
124 1 Patrice Nadeau
125 226 Patrice Nadeau
    zypper install libcurl-devel apache2-devel apache2-mod_perl perl-Apache-DBI subversion-server
126 219 Patrice Nadeau
127 45 Patrice Nadeau
Activation des modules Apache
128
129 219 Patrice Nadeau
    a2enmod ssl
130
    a2enmod perl
131
    a2enmod dav
132
    a2enmod dav_svn
133 1 Patrice Nadeau
    a2enmod dav_fs
134 219 Patrice Nadeau
    a2enmod rewrite
135
    a2enmod headers
136
137 224 Patrice Nadeau
Module _Passenger_
138 45 Patrice Nadeau
139 219 Patrice Nadeau
    cd /srv/redmine
140
    gem install passenger
141
    passenger-install-apache2-module.ruby2.1
142 1 Patrice Nadeau
143 90 Patrice Nadeau
Changer les droits sur le fichiers de log
144
145 219 Patrice Nadeau
    chmod 0666 log/production.log
146
147 90 Patrice Nadeau
Créer le dossier des fichiers temporaire
148 219 Patrice Nadeau
149
> Par défaut les fichiers sont dans _/tmp_ mais se font enlever par le « clean-up » journalier et doivent être refait avec un reload d'Apache
150
151
    mkdir tmp/passenger
152 93 Patrice Nadeau
153 214 Patrice Nadeau
### Activation de la configuration
154 46 Patrice Nadeau
155 216 Patrice Nadeau
Créer le fichier **/etc/apache2/conf.d/passenger.conf** et ajouter la configuration inscrite par l'installation.
156 61 Patrice Nadeau
157 215 Patrice Nadeau
Ajouter dans **/etc/apache2/vhosts.d/vhost.conf**
158 45 Patrice Nadeau
159 215 Patrice Nadeau
	<VirtualHost *:80>
160
		# La ligne suivante est nécessaire seulement si plusieurs site web son présents sur le même serveur.
161
		ServerName redmine.yourdomain.com
162
		DocumentRoot /srv/redmine/public
163 1 Patrice Nadeau
164 215 Patrice Nadeau
		RailsEnv production
165
		PassengerAppRoot /srv/redmine
166
		PassengerTempDir /srv/redmine/tmp/passenger
167 1 Patrice Nadeau
168 215 Patrice Nadeau
		<Directory "/srv/redmine/public">
169
			Options Indexes ExecCGI FollowSymLinks
170
			AllowOverride None
171
			Order deny,allow
172
			Require all granted
173
		</Directory>
174
	</VirtualHost>
175
176
177 65 Patrice Nadeau
Relancer Apache :
178 215 Patrice Nadeau
179
    systemctl reload apache2
180 45 Patrice Nadeau
181 214 Patrice Nadeau
## Post-installation
182 1 Patrice Nadeau
183 68 Patrice Nadeau
A partir d’un navigateur web, se brancher à :
184 1 Patrice Nadeau
185 220 Patrice Nadeau
* Webrick : http://server:3000
186 71 Patrice Nadeau
* Apache : http://server
187 1 Patrice Nadeau
188 69 Patrice Nadeau
Utiliser l’usager *admin* avec le mot de passe *admin*.
189 1 Patrice Nadeau
Vérifier la configuration dans *Administration*, *Information*.
190
191 224 Patrice Nadeau
Si un avertissement apparaît pour l’écriture des répertoires, changer les droits :
192 1 Patrice Nadeau
> Semble être nécessaire que pour Apache
193 82 Patrice Nadeau
194 220 Patrice Nadeau
    cd /srv/redmine
195
    chmod -R 0777 public/plugin_assets
196
    chmod -R 0777 files
197
    chown -R wwwrun:www tmp
198
    # Pour la macro "thumbnails" du wiki, le plugin "redmine_people" nécessite au moins 0775
199
    chmod -R 0777 tmp/thumbnails
200
201 1 Patrice Nadeau
## Personnalisation
202
203
### Ajout d’un logo
204 29 Patrice Nadeau
205 187 Patrice Nadeau
> Cette étape sera à refaire lors d'une mise à jour.
206 1 Patrice Nadeau
207 187 Patrice Nadeau
Les informations viennent de : http://www.redmine.org/projects/redmine/wiki/Howto_add_a_logo_to_your_Redmine_banner
208 36 Patrice Nadeau
209 224 Patrice Nadeau
* Copier le logo dans **/srv/redmine/public/images/logo.png**
210 1 Patrice Nadeau
211 224 Patrice Nadeau
* Modifier le fichier **/srv/redmine/app/views/layouts/base.html.erb**
212 220 Patrice Nadeau
213
* Si on ne veux plus afficher le titre, mettre en commentaire :
214 1 Patrice Nadeau
215 220 Patrice Nadeau
    <!--<h1><%= page_header_title %></h1>-->
216 186 Patrice Nadeau
217
* Ajouter en dessous la ligne 
218 220 Patrice Nadeau
219
    <img src="<%= Redmine::Utils.relative_url_root %>/images/logo.png" style="top-margin: 15px; left-margin: 15px;"/>
220
221 224 Patrice Nadeau
* Relancer Redmine
222 1 Patrice Nadeau
223
### Plugins
224 214 Patrice Nadeau
225 1 Patrice Nadeau
Modules supplémentaires pour ajouter des fonctionnalités à Redmine.
226
227
> Source de problème lors de mise à jour si incompatibilité.
228 172 Patrice Nadeau
229 1 Patrice Nadeau
#### Redmine Rouge
230 209 Patrice Nadeau
231 1 Patrice Nadeau
Permet le support de langage supplémentaire pour l'affichage de la syntaxe d'un code source.
232
233
[Langage supporté](http://rouge.jayferd.us/demo)
234
235 13 Patrice Nadeau
https://github.com/ngyuki/redmine_rouge
236 1 Patrice Nadeau
237 224 Patrice Nadeau
* Installation
238
  
239
        cd /srv/redmine/plugins
240 1 Patrice Nadeau
241 217 Patrice Nadeau
Enlever l'ancienne version (si présente)
242 1 Patrice Nadeau
243 224 Patrice Nadeau
        rm -r redmine_rouge
244 1 Patrice Nadeau
245
Télécharger la nouvelle avec git
246
247 224 Patrice Nadeau
        git clone https://github.com/ngyuki/redmine_rouge.git
248
        cd ..
249
        bundle.ruby2.1 install
250 218 Patrice Nadeau
251 224 Patrice Nadeau
* Relancer redmine
252 218 Patrice Nadeau
253
#### Code Highlight
254 1 Patrice Nadeau
255 74 Patrice Nadeau
http://www.redmine.org/plugins/codehightlight_button
256 5 Patrice Nadeau
257 1 Patrice Nadeau
Bouton permettant de sélectionner du code et d'activer la syntaxe selon un langage.
258 9 Patrice Nadeau
259 224 Patrice Nadeau
* Installation
260 9 Patrice Nadeau
261 224 Patrice Nadeau
        cd /srv/redmine/plugins
262
        git clone https://github.com/mediatainment/redmine_codebutton.git
263
        cd ..
264
        rake redmine:plugins
265
        rake redmine:plugins:migrate RAILS_ENV=production
266 1 Patrice Nadeau
267 224 Patrice Nadeau
* Relancer Redmine
268 218 Patrice Nadeau
    
269 224 Patrice Nadeau
        rcredmine restart
270 10 Patrice Nadeau
271 224 Patrice Nadeau
* Ajout des langages supplémentaires supportées par le « plug-in » _Redmine Rouge_. 
272 220 Patrice Nadeau
273 224 Patrice Nadeau
> Voir [ici](https://github.com/mediatainment/redmine_codebutton/issues/2)
274
275
* Éditer le fichier **/srv/redmine/plugins/redmine_codebutton/assets/javascripts/wiki-codehighlight.js**
276
277 220 Patrice Nadeau
* Ajouter les langages voulus dans la variable *codeRayLanguages*
278 95 Patrice Nadeau
279 224 Patrice Nadeau
* Relancer Apache
280 1 Patrice Nadeau
281 224 Patrice Nadeau
        systemctl reload apache2.service
282 95 Patrice Nadeau
283 98 Patrice Nadeau
#### Wiki Extensions
284 97 Patrice Nadeau
285 214 Patrice Nadeau
Voir #52
286 113 Patrice Nadeau
287 1 Patrice Nadeau
Ajoute des macros au Wiki de Redmine
288 224 Patrice Nadeau
289 1 Patrice Nadeau
> La dernière version est disponible à https://bitbucket.org/haru_iida/redmine_wiki_extensions/downloads
290 115 Patrice Nadeau
291 114 Patrice Nadeau
Parmi les macros ajoutées:
292 118 Patrice Nadeau
293 220 Patrice Nadeau
* Emoticons : Un bouton apparait pour ajouter des « smilley » qui seront afficher en graphique
294 118 Patrice Nadeau
* !{{lastupdated_by}} : affiche le nom de la dernière personne à avoir modifier la page
295 1 Patrice Nadeau
* !{{lastupdated_at}} : affiche la date de la dernière modification de la page
296 118 Patrice Nadeau
* Liste complète à http://www.r-labs.org/projects/r-labs/wiki/Wiki_Extensions_en
297 1 Patrice Nadeau
298 177 Patrice Nadeau
> Des « smilley » non voulus peuvent apparaîtrent dans les wiki déjà en place. L'utilisation de *<notextile><notextile> </notextile></notextile>* seras alors nécessaire.
299 133 Patrice Nadeau
300 130 Patrice Nadeau
Étapes :
301 224 Patrice Nadeau
302 220 Patrice Nadeau
* Installation sur le serveur :
303 114 Patrice Nadeau
304 224 Patrice Nadeau
        cd /srv/redmine/
305
        wget https://bitbucket.org/haru_iida/redmine_wiki_extensions/downloads/redmine_wiki_extensions-0.8.0.zip
306
        unzip redmine_wiki_extensions-0.8.0.zip -d plugins/
307
        rake redmine:plugins:migrate RAILS_ENV=production
308
        systemctl reload apache2.service
309
        rm -r redmine_wiki_extensions-0.8.0.zip
310 220 Patrice Nadeau
311
* Activer le module dans le ou les projets voulus
312
313 224 Patrice Nadeau
* Retrait d'un plug-in
314 220 Patrice Nadeau
315 223 Patrice Nadeau
        cd /srv/redmine
316
        rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production
317
        rm -r plugins/plugin_name
318
        rake db:migrate_plugins RAILS_ENV=production
319 220 Patrice Nadeau
320 214 Patrice Nadeau
## Mise à jour
321 1 Patrice Nadeau
322 228 Patrice Nadeau
> Version 3.4.2 -> 3.4.6
323 101 Patrice Nadeau
324 139 Patrice Nadeau
S’assurer d'avoir les dernières versions des plugins ET qu'il sont compatibles avec la version de Redmine à installer.
325 1 Patrice Nadeau
326 101 Patrice Nadeau
Disponible à http://www.redmine.org/projects/redmine/wiki/Download 
327 1 Patrice Nadeau
328 101 Patrice Nadeau
Mise à jour de Redmine à partir d'une version stable
329
> http://www.redmine.org/projects/redmine/wiki/RedmineUpgrade
330 1 Patrice Nadeau
331 220 Patrice Nadeau
* Arrêter Redmine
332
* Renommer le répertoire actuel
333 1 Patrice Nadeau
334 221 Patrice Nadeau
        cd /srv/
335
        mv redmine redmine.old
336 220 Patrice Nadeau
337
* Télécharger la nouvelle version
338
339 229 Patrice Nadeau
        wget http://www.redmine.org/releases/redmine-3.4.6.tar.gz
340 220 Patrice Nadeau
341
* Décompresser le fichier
342
343 229 Patrice Nadeau
        tar xvf redmine-3.4.6.tar.gz
344
        mv redmine-3.4.6 redmine
345 220 Patrice Nadeau
346
* Copier les anciens fichiers de configurations
347
348 221 Patrice Nadeau
        cp redmine.old/config/configuration.yml redmine/config
349
        cp redmine.old/config/database.yml redmine/config
350
        cp -r redmine.old/files redmine
351 220 Patrice Nadeau
352
* Refaire la sécurité
353
354 221 Patrice Nadeau
        chown -R root:root redmine
355
        # Les commandes suivantes sont nécessaire seulement si Apache est utilisé
356
        # Le même owner que config.ru doit être utiliser pour plusieurs dossier
357
        chown wwwrun:www redmine/config.ru
358
        mkdir redmine/tmp/passenger
359
        chown -R wwwrun:www redmine/tmp
360
        chmod 0777 redmine/public/plugin_assets
361
        chmod -R 0777 redmine/files
362 220 Patrice Nadeau
363
* Ne copier que les « plugins » qui ne sont pas fournis par la nouvelle version de Redmine
364
365 221 Patrice Nadeau
        cp -r redmine.old/plugins/* redmine/plugins
366 220 Patrice Nadeau
367
* Installer les « gems »
368
369 221 Patrice Nadeau
        cd redmine
370 229 Patrice Nadeau
        bundle.ruby2.5 install --without development test
371 220 Patrice Nadeau
372
* Mise à jour (base de donnés, « plugins ») et ménage :
373
374 229 Patrice Nadeau
        bundle.ruby2.5 exec rake generate_secret_token
375
        bundle.ruby2.5 exec rake db:migrate RAILS_ENV=production
376
        bundle.ruby2.5 exec rake redmine:plugins:migrate RAILS_ENV=production
377
        bundle.ruby2.5 exec rake tmp:cache:clear tmp:sessions:clear
378 220 Patrice Nadeau
379
* Remettre le logo (facultatif)
380
381 221 Patrice Nadeau
        cd ..
382
        cp redmine.old/public/images/logo.png redmine/public/images/
383
        cp redmine.old/app/views/layouts/base.html.erb redmine/app/views/layouts/
384 220 Patrice Nadeau
385
* Réinstaller le module « Passenger » (voir plus haut)
386
* Relancer Redmine 
387
* Vérifier 
388
    * Administration
389
        * Informations
390
        * Plugins
391
        * Projects
392
        * Users
393
        * Roles & permissions
394
    * Essayer d'attacher un fichier à un projet
395
    * Essayer d’accéder au calendrier d'un projet
396
397 214 Patrice Nadeau
## Copie de sécurité
398 40 Patrice Nadeau
399 163 Patrice Nadeau
[[Copie de sécurité]]
400
401 5 Patrice Nadeau
402 39 Patrice Nadeau
403 214 Patrice Nadeau
## Dépannage
404 1 Patrice Nadeau
405 214 Patrice Nadeau
### Mot de passe perdu
406 1 Patrice Nadeau
407
Le mot de passe admin par défaut est en _hash Sha1_ : *da3174755c5e82a436b6c7ff87c873ee50d6654b* et est *admin.*
408
409 214 Patrice Nadeau
### Le service tombe « DEAD » à chaque fois (webrick)
410 1 Patrice Nadeau
411 220 Patrice Nadeau
Effacer le fichier **/srv/redmine/tmp/pids/server.pid**.