FrRedmineUpgrade » History » Version 8

yannick quenec'hdu, 2010-05-15 21:33

1 1 Fabrice Phung
h1. Mise à jour
2 1 Fabrice Phung
3 5 yannick quenec'hdu
{{>toc}}
4 2 yannick quenec'hdu
5 5 yannick quenec'hdu
h2. Étape 1 - Vérifier les pré-requis
6 1 Fabrice Phung
7 7 yannick quenec'hdu
La première étape pour la mise à jour de Redmine est de vérifier que vous remplissez les [[FrRedmineInstall#Exigence|exigences]] de la version que vous vous apprêtez à installer.
8 1 Fabrice Phung
9 5 yannick quenec'hdu
h2. Étape 2 - Sauvegarde
10 1 Fabrice Phung
11 8 yannick quenec'hdu
Il est recommandé de [[FrRedmineInstall#Sauvegarde|sauvegarder]] vos données et vos fichiers. La plupart des mises à jour sont sans danger, mais il est toujours prudent de réaliser une sauvegarde dans le cas contraire.
12 1 Fabrice Phung
13 5 yannick quenec'hdu
h2. Étape 3 - réaliser la mise à jour
14 5 yannick quenec'hdu
15 5 yannick quenec'hdu
Le processus de mise à jour est dépendant de la manière que vous avez téléchargé Redmine. Vous avez besoin de réaliser seulement une des options suivantes :
16 5 yannick quenec'hdu
17 5 yannick quenec'hdu
h3. Option 1 - Mettre à jour depuis une version téléchargée (fichier tar.gz ou zip)
18 5 yannick quenec'hdu
19 5 yannick quenec'hdu
1. Décompresser la nouvelle archive du programme dans un nouveau répertoire.
20 5 yannick quenec'hdu
21 5 yannick quenec'hdu
2. Copiez vos paramètres de base @config/database.yml@ dans le nouveau répertoire de configuration config.
22 5 yannick quenec'hdu
23 5 yannick quenec'hdu
3. Copiez vos paramètres de mail @config/email.yml@ dans le nouveau répertoire de configuration config.
24 5 yannick quenec'hdu
25 5 yannick quenec'hdu
4.  Copiez le contenu de @RAILS_ROOT/files@ dans le répertoire votre nouvelle installation
26 5 yannick quenec'hdu
27 5 yannick quenec'hdu
5. Copiez le répertoire contenant vos plugin dans le répertoire de votre nouvelle installation
28 5 yannick quenec'hdu
29 5 yannick quenec'hdu
6. Exécturer les commandes suivantes depuis le répertoire Redmine de votre nouvelle installation
30 5 yannick quenec'hdu
31 5 yannick quenec'hdu
   rake config/initializers/session_store.rb
32 5 yannick quenec'hdu
33 5 yannick quenec'hdu
Si vous utilisez une nouvelle version de Redmine, les fichiers indiqués au dessous n'existent pas encore. Pour ces versions, exécuter :
34 5 yannick quenec'hdu
35 5 yannick quenec'hdu
   rake generate_session_store
36 5 yannick quenec'hdu
37 5 yannick quenec'hdu
Cette commande va générer un fichier (@config/initializers/session_store.rb@) avec un secret aléatoire utilisé pour sécuriser les données de session.
38 5 yannick quenec'hdu
39 5 yannick quenec'hdu
7. Vérifier pour tous les thèmes que vous possédez que vous pouvez les installer dans le répertoire "public/themes". Vous pouvez les copier, mais il est préférable de vérifier qu'il y a une version mise à jour.
40 5 yannick quenec'hdu
41 5 yannick quenec'hdu
TRÈS IMPORTANT : Ne pas écraser le fichier config/settings.yml avec l'ancienne version
42 5 yannick quenec'hdu
43 6 yannick quenec'hdu
h3. Option 2 - Mettre à jour depuis un checkout SVN  [[FrRedmineRepositories|Dépot]]
44 5 yannick quenec'hdu
45 1 Fabrice Phung
1. Allez dans le répertoire racine de Redmine et exécutez la commande suivante:
46 1 Fabrice Phung
47 5 yannick quenec'hdu
  <pre>
48 5 yannick quenec'hdu
svn update
49 5 yannick quenec'hdu
</pre>
50 1 Fabrice Phung
51 1 Fabrice Phung
52 5 yannick quenec'hdu
2. Si vous faites une mise à jour depuis une ancienne version vers la 0.8.7 ou supérieur (depuis une version du trunk). Vous devez générer un secret pour le stockage des cookies, avec la commande suivante :
53 1 Fabrice Phung
54 5 yannick quenec'hdu
  rake generate_session_store
55 1 Fabrice Phung
56 5 yannick quenec'hdu
Cette commande va générer un fichier (@config/initializers/session_store.rb@) avec un secret aléatoire utilisé pour sécuriser les données de session.
57 5 yannick quenec'hdu
58 7 yannick quenec'hdu
h2. Étape 4 - Mise à jour de la base de données
59 5 yannick quenec'hdu
60 5 yannick quenec'hdu
Cette étape va modifier le contenu de la base de données. Allez dans le répertoire de votre nouvelle installation de Redmine et effectuez la commande suivante :
61 5 yannick quenec'hdu
62 1 Fabrice Phung
<pre>
63 5 yannick quenec'hdu
rake db:migrate RAILS_ENV=production 
64 1 Fabrice Phung
</pre>
65 1 Fabrice Phung
66 5 yannick quenec'hdu
Si vous avez installé des plugin, vous devrez effectuer une migration de la base de données. Effectuer les commandes suivantes :
67 1 Fabrice Phung
68 5 yannick quenec'hdu
<pre>
69 5 yannick quenec'hdu
rake db:migrate:upgrade_plugin_migrations RAILS_ENV=production 
70 5 yannick quenec'hdu
</pre>
71 1 Fabrice Phung
72 5 yannick quenec'hdu
<pre>
73 5 yannick quenec'hdu
rake db:migrate_plugins RAILS_ENV=production 
74 5 yannick quenec'hdu
</pre>
75 1 Fabrice Phung
76 5 yannick quenec'hdu
h2. Étape 5 - Nettoyage 
77 1 Fabrice Phung
78 5 yannick quenec'hdu
1. Vous devez nettoyer le cache et les sessions existantes, pour ce faire, exécuter les commandes suivantes :
79 1 Fabrice Phung
80 5 yannick quenec'hdu
<pre>
81 5 yannick quenec'hdu
rake tmp:cache:clear
82 5 yannick quenec'hdu
rake tmp:sessions:clear
83 5 yannick quenec'hdu
</pre>
84 1 Fabrice Phung
85 5 yannick quenec'hdu
2. Redémarrez l'application (ex : mongrel, thin, passenger) 
86 1 Fabrice Phung
87 5 yannick quenec'hdu
3. Finalement, lancez votre navigateur et allez dans_"Administration -> Rôles & permissions"_ pour vérifier et/ou paramétrer les permissions sur les nouvelles fonctionnalités, s'il y en a.