Redmine

h1. Mise à jour

{{>toc}}

h2. Étape 1 - Vérifier les pré-requis

La première étape pour la mise à jour de Redmine est de vérifier que vous remplissez les exigences de la version que vous vous apprêtez à installer.

h2. Étape 2 - Sauvegarde

Il est recommandé de 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.

h2. Étape 3 - réaliser la mise à jour

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 :

h3. Option 1 - Mettre à jour depuis une version téléchargée (fichier tar.gz ou zip)

1. Décompresser la nouvelle archive du programme dans un nouveau répertoire.

2. Copiez vos paramètres de base @config/database.yml@ dans le nouveau répertoire de configuration config.

3. Copiez vos paramètres de mail @config/email.yml@ dans le nouveau répertoire de configuration config.

4.  Copiez le contenu de @RAILS_ROOT/files@ dans le répertoire votre nouvelle installation

5. Copiez le répertoire contenant vos plugin dans le répertoire de votre nouvelle installation

6. Exécturer les commandes suivantes depuis le répertoire Redmine de votre nouvelle installation

   rake config/initializers/session_store.rb

Si vous utilisez une nouvelle version de Redmine, les fichiers indiqués au dessous n'existent pas encore. Pour ces versions, exécuter :

   rake generate_session_store

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.

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.

TRÈS IMPORTANT : Ne pas écraser le fichier config/settings.yml avec l'ancienne version

h3. Option 2 - Mettre à jour depuis un checkout SVN  [[FrRedmineRepositories|Dépot]]

1. Allez dans le répertoire racine de Redmine et exécutez la commande suivante:

  <pre>

svn update

</pre>

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 :

  rake generate_session_store

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.

h2. Étape 4 - Mise à jour de la base de données (SVP faites une sauvegarde de la base avant):

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 :

<pre>

rake db:migrate RAILS_ENV=production 

</pre>

Si vous avez installé des plugin, vous devrez effectuer une migration de la base de données. Effectuer les commandes suivantes :

<pre>

rake db:migrate:upgrade_plugin_migrations RAILS_ENV=production 

</pre>

<pre>

rake db:migrate_plugins RAILS_ENV=production 

</pre>

h2. Étape 5 - Nettoyage 

1. Vous devez nettoyer le cache et les sessions existantes, pour ce faire, exécuter les commandes suivantes :

<pre>

rake tmp:cache:clear

rake tmp:sessions:clear

</pre>

2. Redémarrez l'application (ex : mongrel, thin, passenger) 

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.