Cette page décrit l'upgrade d'une installation de SourceML en version 1 vers une version 2.

Vue d'ensemble 

L'upgrade se fait en installant la dernière version de SourceML et en important dedans les données de l'ancienne installation :

• faire un backup de l'ancienne installation
• installer SourceML avec la nouvelle version
• copier les dossiers content et mw de l'ancienne installation sur la nouvelle
• lancer le script import.previous.version.php en ligne de commande
• effacer l'ancienne installation

Attention

Les plugins et les templates développés sur une version 1 de SourceML ne sont pas compatibles avec la version 2.

Les développements se font maintenant via les mécanisme proposés par Symfony.

Faire un backup

Commencez par faire une sauvegarde complète de votre site. Sauvegardez les fichiers, ainsi qu'un export de votre base si vous utilisez MySql.

Installer la nouvelle version de SourceML 

Enlevez de votre site les dossiers et les fichiers de l'ancienne installation.

Si vous utilisez MySql, laissez les tables dans la base.

Puis installez sur votre site la nouvelle version (voir la documentation sur l'installation).

Copier les données de l'ancienne installation

Lorsque la nouvelle version est installée, copiez dans son dossier web les dossiers content et mw de l'ancienne installation.

Lancer le script d'import

Attention

La méthode de cryptage des mots de passe change dans la version 2.

Comme les informations de sources et d'auteurs, les utilisateurs seront aussi importés dans la nouvelle version, mais leur mots de passe seront regénérés, pour être compatibles avec la nouvelle méthode de cryptage.

Notifier les utilisateurs de leur nouveau mot de passe 

Vous pouvez configurer le script d'upgrade pour qu'un email automatique soit envoyé aux utilisateurs avec leur nouveau mot de passe.

Dans ce cas indiquez l'email de l'expéditeur dans ce fichier :

web/previous.version.pathes.php

Voir les commentaires dans ce fichier pour plus de détails sur l'envoi des nouveaux mots de passe.

Lancer le script

Rendez-vous en ligne de commande dans le dossier web de votre installation et lancez le script avec la commande :

php import.previous.version.php

Le script est assez bavard et affiche au fur et à mesure les données qu'il importe.

Si l'import se passe bien, la dernière ligne affichée par le script devrait ressembler à :

 [YYYY-MM-DD HH MM SS] import done

Si vous ne voyez pas cette ligne à la fin, c'est qu'une erreur a du se produire pendant l'upgrade. Les dernières lignes devraient alors donner plus d'informations sur le problème.

effacer l'ancienne installation 

Lorsque l'upgrade est terminé, effacez les dossier mw et content du dossier web, ainsi que les tables de l'ancienne base si vous utilisiez MySql dans l'ancienne installation.