Académie de Strasbourg Document d accompagnement pour la migration Joomla 1.5 à Joomla 2.5 Version 2012 Stéphan Cammarata
Préambule Prérequis à la migration Migration Phase 1 : Récupérer le site en production Phase 2 : préparation de MovampJ Phase 3 : rendre le site Joomla 1.5 fonctionnel Phase 4 : Installation du composant de migration jupgrade Phase 5 : migration Phase 6 : Travailler le nouveau site Phase 7 : Migration des extensions Phase 8 : Replacer le nouveau site en production sur Eridan Préparer une base de données propre à Joomla 2.5 Exporter les tables de Joomla 2.5 localement et les importer sur Eridan Préparer le fichier de configuration en vue du déplacement sur Eridan Déplacer les fichiers du site sur Eridan Tester le nouveau site en ligne Permutation des sites Mise en production définitive du site 3 4 5 5 6 7 9 10 11 11 12 12 12 14 15 16 16 16 Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 2
Préambule Joomla 1.5 est arrivé en fin de vie en avril 2012. Il est nécessaire d envisager sa migration vers la version 2.5, dite de «long terme». La migration n est pas possible de manière native dans Joomla et nécessite l usage d un composant nommé jupgrade. Ce composant migre le noyau de Joomla ainsi que quelques extensions qui sont listés sur le site du développeur. La migration effectuée nécessite ensuite une vérification du nouveau site et un traitement particulier des extensions. L idée du composant jupgrade est la suivante : créer un site sous Joomla 2.5, dans un sous- dossier du site Joomla 1.5. Il ne s agit donc pas de remplacer le site existant mais bien d en créer un «clone» migré. En théorie, cette migration peut se faire en ligne directement. En pratique, l hébergement académique est trop fermé et l opération peut comporter certains risques. Par conséquent, je propose un principe de migration en 3 étapes : 1. Déplacer le site en production vers un environnement de travail local. 2. Effectuer la migration en local, ajuster le nouveau site. 3. Déplacer le site migré sur l hébergement académique et le mettre en production. Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 3
Prérequis à la migration Avant de décider de migrer votre site, il faudra veiller à plusieurs points liés à Joomla : 1. Faire le ménage sur le site, supprimer tous les éléments inutiles : articles, liens, extensions inutilisées. Plus le site est propre, plus la migration en sera facilitée. 2. Vérifier que toutes les extensions que vous utilisez existent en version compatible avec Joomla 2.5. Il est impossible de faire fonctionner un composant incompatible, il est parfois possible de faire tourner des modules et/ou des plugins développés pour Joomla 1.6 ou 1.7, mais pas ceux fonctionnant sur la 1.5. 3. Le template de Joomla 1.5 ne sera pas compatible avec Joomla 2.5. Il faudra donc envisager le changement de template. 4. Revoir vos notions sur Joomla, il va falloir toucher à des choses que vous vez mis en place il y a longtemps. Il serait peut- être bon de réviser les bases avant si besoin. Pour cela, vous disposez du tutoriel d initiation. Quand les 3 points ci- dessous sont validés, il faudra réunir les éléments suivants : 1. Tous les codes d accès webmaster à l hébergement académique 2. Un logiciel de transfert FTP (Utilisé dans ce tutoriel : Filezilla) 3. Il est conseillé de posséder l éditeur de texte Notepad++ utilisé dans ce tutoriel pour éditer les fichiers php et/ou SQL de manière plus aisée (existe en portatif) 4. Un logiciel de simulation d environnement web Logiciels validés : Mamp (sous MacOS) et MovampJ 1.6.1 (sous Windows/portatif) Logiciels invalidés : Wamp et Xampp (peut- être possible en changeant leur configuration, mais je n y suis pas arrivé) 5. L extension jupgrade (composant de Joomla 1.5) Remarque : la machine utilisée dans ce tutoriel est un XP SP3 avec antivirus Trend. Connexion internet à domicile, le cas échéant vérifier le proxy et la possibilité de réaliser des transferts FTP avec la connexion disponible. Et enfin : si vous travaillez à plusieurs sur le site, prévenez les autres collaborateurs. Tous les éléments créés sous Joomla 1.5 entre les phases de migration et de mise en production n apparaitront plus sur le site migré. Il faut impérativement arrêter d alimenter le site entre ces deux phases. Il est difficile d estimer le temps nécessaire à la migration, car il dépend de la taille et du nombre d extensions de votre site. A titre indicatif, il m a fallu environ 8 heures pour migrer la totalité de mon site, temps qui comprend la création d un nouveau template avec Artisteer. (Site avec 5 extensions effectivement migrées, un seul composant dans ces 5 extensions, le plus long à migrer) Liens pour télécharger MovampJ et jupgrade (au 15 mai 2012) : MovampJ : http://extensions.papounet.fr/telechargement/view.download/9/41 jupgrade : http://www.joomlatutos.com/jupgrade- migration- vers- joomla- 25/extensions- joomla/jupgrade- migration- vers- joomla- 25 Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 4
Migration Phase 1 : Récupérer le site en production Si vous faites des sauvegardes régulières de votre site, il faudra simplement se servir de l une d entre elles (fichiers et base de données) Sinon : Connectez- vous sur l espace web académique avec Filezilla Récupérez l intégralité du contenu du dossier «public_html» que vous placerez dans un dossier identifiable que l on nommera ici Joomla15 Récupérez dans le dossier «sauvegarde_db» le fichier SQL contenant la sauvegarde de base de données la plus récente (ils sont horodatés) Il faudra donc au final posséder un dossier Joomla15 et un fichier SQL tel que le montre la copie d écran ci- dessous : Vérifiez que tous les fichiers ont été transférés avec succès (aucun ne doit être dans l onglet «transferts échoués» de Filezilla, le cas échéant, le remettre en file d attente). Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 5
Phase 2 : préparation de MovampJ Movamp ne nécessite aucune installation, c est un logiciel portatif. Pour ce tutoriel, le dossier Movamp est placé sur le bureau. Ne pas lancer Movamp avant d avoir lu ce qui suit : Pour que la migration soit possible, il faut activer l extension php_curl de Movamp. Pour cela : Avant de lancer Movamp, se rendre dans mnt/usr/local/php et repérer le fichier php.ini : Modifier ce fichier (clique droit modifier avec Notepad++) A la ligne 953, enlever le «;» devant «extension=php_curl.dll», ainsi la ligne change de couleur et devient active comme ci- dessous : Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 6
Copier le dossier Joomla15 (votre site) dans le dossier mnt/var/www : Lancer Movamp, vérifiez que l icône s est placée dans la barre des tâches et que l on peut faire un clique droit dessus : Remarques : Pour l utilisation de Movamp, voir le tutoriel d initiation à Joomla On ne peut pas faire tourner plusieurs serveurs web simultanément sur une machine (sauf s ils fonctionnent sur un autre port que le port 80). Pistes ne cas de dysfonctionnement : Serveur IIS actif sur le poste, pare- feu allergique, antivirus paranoïaque, etc.) Phase 3 : rendre le site Joomla 1.5 fonctionnel Dans Movamp, nous avons placé les fichiers du site, mais pas encore la base de données. Le site a encore un fichier de configuration (configuration.php) paramétré pour un fonctionnement sur le serveur Eridan. Le but de cette partie est d importer la base de données et de corriger le fichier configuration.php Import de la base : Clique- droit sur Movamp et accéder à phpmyadmin Cliquer sur le bouton «Importer» du bandeau : Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 7
Fournir ici le fichier sql récupéré avec Filezilla en phase 1 : Exécuter la requête : appuyer sur le bouton «exécuter» en bas à droite. Si tout se passe bien, un message de confirmation est affiché (le nombre de requêtes dépend de la taille de votre site) : Votre base de données telle qu elle se nommait sur Eridan est présente dans Movamp / phpmyadmin (la mienne s appelle 0681932f_joomla) : Il faut à présent paramétrer le fichier de configuration pour l adapter à ce nouvel environnement. Adaptation du fichier de configuration de Joomla : Rechercher ce fichier dans mnt/var/www/joomla15 : Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 8
Editez- le avec Notepad++, il faut changer plusieurs lignes : Chercher la partie concernant la base de données et remplacer : o A la place de «var $user = 'web0681932f';» mettre «var $user = 'joomla';» o A la place de «var $password = 'monmotdepasse';» mettre «var $password = 'joomla';» Il s agit des identifiants de base de données Chercher le chemin du dossier de logs et du dossier temporaire et remplacer ce qui existe pour mettre : o var $log_path = 'http://localhost/joomla15/logs'; o var $tmp_path = 'http://localhost/joomla15/tmp'; Enregistrez votre fichier et fermez le. Lancez maintenant votre site en local, pour cela : Clique droit sur movamp Choisir «Websites» Un site de démo sous Joomla 2.5 est présent dans la liste (normal car fourni avec cette version de Movamp), notre site est en dessous : Vérifiez le fonctionnement du site dans son état actuel. Phase 4 : Installation du composant de migration jupgrade Si votre site fonctionne correctement, vous pouvez installer jupgrade. Comme tous les composants de Joomla, il s installe par le menu «Extensions- Installer/désinstaller». Fournir à Joomla le fichier zip téléchargé dans les prérequis. Vérifiez que le composant s est bien placé dans la liste des composants disponibles : Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 9
Il est ensuite nécessaire d activer un plugin nommé «Mootools». Rendez- vous dans «Extensions / gestion des plugins» Rechercher le plugin Mootools Activez le : Votre site est prêt à subir une migration. Dans l étape suivante, un nouveau site sera créé, qui se placera dans un dossier nommé «nouveau_site», au milieu du noyau de Joomla 1.5 Phase 5 : migration Allez dans le menu «composants» et cliquez sur jupgrade : Cliquez sur «effectuer la migration» et laissez le faire, plusieurs étapes vont s enchainer. A la fin du procédé (s il s est bien déroulé), on pourra lire ceci : A retenir : Le nouveau site est bien présent au milieu des fichiers de Joomla 1.5 : L ancien site reste fonctionnel Accès au backend du nouveau site : http://localhost/joomla15/nouveau_site/administrator Accès au frontend du nouveau site : http://localhost/joomla15/nouveau_site/ Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 10
Phase 6 : Travailler le nouveau site Lorsque vous allez accéder au frontend de votre site migré, vous risquez de prendre une petite frayeur. Il vaut mieux aller dans le backend pour se rassurer et constater que le plupart des éléments sont là. Conseil : Se reporter au tutoriel d initiation en cas de doutes sur les notions qui suivent. Il va maintenant falloir : Mettre le template que vous avez prévu pour cette version de Joomla dans les prérequis. Apprivoiser les positions de ce template et replacer correctement vos modules (dans le gestionnaire de modules). Une fois ces deux étapes passées, votre frontend devrait ressembler à quelque chose. Il sera alors temps de vérifier tous vos liens de menu et le comportement général du site. Phase 7 : Migration des extensions Concernant les modules et/ou les plugins indépendants : Il suffira d installer la nouvelle version du module (ou du plugin) écrite spécifiquement pour Joomla 2.5 et de régler leurs paramètres dans la console de gestion appropriée. Exemples d extensions rentrant dans ce cadre présentés en formation : Lof Article Scroller (Module qui affiche les news du site) Very Simple Image Galery (Plugin permettant d afficher une galerie d images) Concernant les composants (et leurs dépendances) : Il n y a malheureusement pas de méthode «canonique» pour gérer le cas des composants. Le principe étant qu un composant écrit dans la base de données et stocke éventuellement des choses dans le noyau (fichiers joints). Le mieux est de suivre le tutoriel de migration de l auteur du composant (s il existe). Le principe théorique de migration étant : Récupérer les tables de la base qui concernent le composant sous Joomla 1.5 Modifier éventuellement ces tables et les rendre disponibles dans Joomla 2.5 Récupérer les fichiers de l extension (images, vidéo, fichiers ) et les copier dans un dossier du même nom sur le nouveau site. Réinstaller le composant en lui précisant bien que certaines tables existent déjà et qui ne doit pas les écraser (si cette option est prévue) Installer ses dépendances (module/plugin associé, fichier de langue ) Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 11
Phase 8 : Replacer le nouveau site en production sur Eridan On part du principe que les phases 6 et 7 se sont déroulées correctement et que l on dispose maintenant d un site sous Joomla 2.5 qui fonctionne de manière satisfaisante. Il faut maintenant le replacer sur l hébergement académique. La méthode décrite ici n est pas la seule possible. Préparer une base de données propre à Joomla 2.5 Aller sur la console de gestion de Eridan (https://eridan.ac- strasbourg.fr) Se connecter en tant que webmaster Créer une base de données, par exemple Joomla25, qui s appellera finalement RNE_Joomla25 : Exporter les tables de Joomla 2.5 localement et les importer sur Eridan Notre «nouveau_site» possède des tables de base de donnée dans Movamp. Elles commencent toutes par le préfixe «jnew_». Le but de cette partie est d exporter ces tables de Movamp/PhpMyAdmin et de les importer dans Eridan/PhpMyAdmin dans la base de données créée à l étape précédente. Se connecter à Movamp/phpmyadmin (clique droit sur Movamp) Cliquer sur le bandeau de droite sur votre base de données créée lors de la phase 3 : Sur cette copie d écran il s agit de 0681932f_joomla Cette base contient des tables dont le préfixe est «jos_» et d autres dont le préfixe est «jnew_». Il ne faut exporter que les tables dont le préfixe est «jnew_» Cliquer sur «Exporter» dans le contexte suivant : Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 12
Sur l écran suivant, vous prendrez soin de sélectionner TOUTES les tables commençant par «jnew_» tout en laissant les autres non sélectionnées : Copie d écran partielle Sur le même écran, plus bas, vérifier que la case «transmettre» est cochée et cliquer sur «Exécuter» : Le navigateur vous proposera alors d enregistrer un fichier sql que vous prendrez soin de placer sur votre bureau et de renommer en «tables_a_importer.sql» (attention à l extension!) Nous allons maintenant nous rendre sur Eridan/phpmyadmin. Pour cela, dans la console web d Eridan cliquer sur «accès à phpmyadmin» : Veiller à sélectionner la base de données créée précédemment sur Eridan, à savoir dans notre exemple 0681932f_joomla25 (cliquer dessus) : Cliquer ensuite sur «Importer» en vérifiant bien que vous êtes dans la base vide : Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 13
Indiquez ensuite le fichier «tables_a_importer» extrait de Movamp et que vous aviez stocké sur le bureau : Exécuter la requête, un message de confirmation que tout s est bien passé devrait s afficher et vérifiez que vos tables «jnew_» sont maintenant présentes dans la colonne de gauche. La base de données du nouveau_site est prête et dissociée de l ancien site. Nous aurions pu tout mettre dans la même base, étant donné que les préfixes de table sont distincts, mais c est moins propre. Préparer le fichier de configuration en vue du déplacement sur Eridan Le dossier «nouveau_site» va être remis sur un serveur web en production (Eridan). Il faut que nous ajustions ses paramètres afin de le rendre fonctionnel. Attention : il faut ici éditer le fichier configuration.php qui se trouve dans le dossier «nouveau_site» A l aide de notepad++ éditer le fichier configuration.php du nouveau site : R Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 14
Remplacer les lignes suivantes du fichier par vos informations, vérifiez notamment la mention mysql et non mysqli : Remplacer ensuite les informations sur le dossier tmp et le dossier de logs : Enregistrer le fichier Votre fichier de configuration est prêt à être mis en place. Déplacer les fichiers du site sur Eridan Dans cette partie, nous allons à nouveau agir avec prudence. Afin de réduire le temps d indisponibilité du site, nous allons commencer par copier notre nouveau Joomla 2.5 dans un sous- dossier du serveur Eridan. Cette astuce nous permettra aussi de vérifier son fonctionnement avant de remplacer définitivement notre vieux Joomla 1.5 Avec Filezilla transférer le dossier «nouveau_site» en tant que sous- dossier de public_html sur Eridan : Vérifiez que tous les fichiers ont été transférés (aucun ne doit être dans «transferts échoués», le cas échéant, remettez les en file d attente). Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 15
Tester le nouveau site en ligne Vérifiez maintenant que votre site est accessible en ligne en tapant l adresse de votre sous- domaine suivi de «nouveau_site» : Par exemple : Frontend : www.col- ill- illfurth.ac- strasbourg.fr/nouveau_site Backend : www.col- ill- illfurth.ac- strasbourg.fr/nouveau_site/administrator Si tout s est bien passé, le site devrait fonctionner sous Joomla 2.5. Permutation des sites Le site sera indisponible durant cette manipulation. En temps normal, elle dure quelques minutes si le serveur n est pas saturé et répond normalement. Il est conseillé d effectuer cette permutation à une heure de faible trafic. Avec Filezilla : Créer un dossier «ancien_site» Déplacer dans «ancien_site» TOUS les fichiers du noyau de Joomla 1.5, c est à dire TOUT SAUF le dossier «nouveau_site». (Avec la souris, glisser) A ce point, «public_html» doit être composé de : o «ancien_site» qui contient le noyau de Joomla 1.5 o «nouveau_site» qui contient le noyau de Joomla 2.5 A présent, déplacer le CONTENU de «nouveau_site» à la racine de «public_html». Vérifier après le déplacement que «nouveau_site» est bien vide. Supprimer «nouveau_site» Garder «ancien_site» quelques semaines (pas trop quand même) au cas où il y a un souci, il sera toujours possible de permuter à nouveau les sites. Mise en production définitive du site Après quelques semaines en production avec votre Joomla 2.5, il faudra se résoudre à détruire l ancien site. Pour cela : Avec Filezilla, effacer le dossier «ancien_site» Dans la console de gestion des sites d Eridan, supprimer l ancienne base de données (dans notre exemple, elle s appelle 0681932f_joomla) Attention : ne vous trompez pas de base de données, manoeuvre irréversible! Stéphan Cammarata Tutoriel Migration de Joomla (v12-01) Page 16