Mise à jour : passer d'une version à une autre

Si vous avez installé une version d’Iconito et que vous souhaitez utiliser une version supérieure, cette page est faite pour vous !

ATTENTION : les indications de cette page ne sont pas valables pour passer la version 1 à la version 2. Pour cette procédure, reportez-vous à la page spéciale majv1v2.

Pour pouvoir faire un “upgrade” d’Iconito, il faut :

• connaître la version de l’Iconito installé
• avoir un accès au code source (il y aura quelques fichiers à modifier)
• télécharger la version d’Iconito souhaitée (s’il y a le choix, ne prenez que les versions stables)

Il est conseillé de procéder à la mise à jour à un moment où le site est peu utilisé.

1. Faire une sauvegarde de l’Iconito installé (code source et base de données). Ca ne coûte rien et peut rapporter gros...
2. Décompresser l’archive du nouveau Iconito à l’endroit où est installé l’Iconito utilisé. Normalement, le système doit vous signaler qu’un grand nombre de fichiers/dossiers existe déjà et vous demander s’il faut les écraser. Répondez “oui” pour tous les écraser. Les fichiers de configuration ne seront pas affectés.
3. Rendez-vous dans le dossier www, et repérer les fichiers de type upgrade-0.x-to-0.y.php. Chacun de ces fichiers comprend les requêtes et les éventuels tests+instructions à faire pour passer d’une version à une autre. Ces fichiers étant situés dans le dossier web et pour que n’importe qui ne puisse pas les exécuter, ils sont protégés par la commande PHP die qui bloque leur exécution.
   1. Repérer le (ou les fichiers) qui vous concerne. Si vous avez la version 0.8 et que vous souhaitez passer à la version 0.9, seul le fichier upgrade-0.8-to-0.9.php vous intéresse. Pour passer de la version 0.7 à la 1.0, vous allez avoir besoin des fichiers upgrade-0.7-to-0.8.php, upgrade-0.8-to-0.9.php, upgrade-0.9-to-1.0.php, upgrade-1.0rc2-to-1.0.php et upgrade-1.0rc3-to-1.0.php (pour passer à la V1 il peut y avoir plusieurs fichiers de type upgrade-1.0rcX-to-1.0.php en raison des versions RC précédent la sortie de la V1 finale)
   2. Les opérations suivantes sont à répéter pour chacun de ces fichiers, mais uniquement sur ceux qui vous concernent et dans l’ordre croissant (upgrade-0.7-to-0.8.php avant upgrade-0.8-to-0.9.php etc.).
   3. Editer le fichier upgrade-X-to-Y.php, et modifier la ligne n°2 en la mettant en commentaire :

      die('Réservé à l\'admin !');

      devient

      //die('Réservé à l\'admin !');

   4. Prenez votre navigateur web et rendez-vous à la page http://www.votreiconito.com/upgrade-X-to-Y.php
   5. La page procède à la mise à jour, en exécutant des requêtes dans la BDD et en vous affichant des éventuelles instructions (c’est rare, mais ça arrive s’il faut ajouter une ligne dans un fichier de configuration). Un message “OK” indique que tout s’est bien passé.
   6. Re-éditer le fichier upgrade-X-to-Y.php, et modifier la ligne n°2 en enlevant le commentaire pour bloquer la page :

      //die('Réservé à l\'admin !');

      devient

      die('Réservé à l\'admin !');

   7. Si vous faites un saut de plusieurs versions, retourner à l’étape III avec le fichier suivant