Mettre à jour son SPIP

Transcription

1 Mettre à jour son SPIP Mai 2004 par Xavier Lecocq

2 SOMMAIRE Préambule ) Solution 1 : Utilisation de SPIP_loader ) Solution 2 : Ecraser les anciens fichiers ) Sauvegarde de la base de données ) Installer la nouvelle version de SPIP ) Déclenchez la mise à jour.... 6

3 Préambule Ce document a pour but de présenter la manière de procéder pour être à jour sa SPIP avec la nouvelle distribution. Attention, malgré ceci, il se peut que cela ne se passe pas comme prévu. Il y a 2 méthodes pour mettre à jour SPIP. La première consiste à utiliser spip_loader.php3 par FTP, alors que la seconde méthode consiste à écraser tous les anciens fichiers par les nouveaux.

4 1) Solution 1 : Utilisation de SPIP_loader Dans un premier temps, il vous faut télécharger le fichier spip_loader.php3 à la racine (ou dans le dossier contenant tous les fichiers et dossiers SPIP). Dans la fenêtre d'adresse de la fenêtre SPIP, ajouter /spip.loader.php3 à l'url de votre site, puis OK ou valider. Ceci a pour effet de lancer ce fichier. Voici les étapes à suivre : - Entrer le login et le mot de passe. - Action : téléchargement de la dernière version Authentification (par FTP). Arrangez-vous pour laisser visible bien en haut le nom du dossier admin_xxxxxxxxxx. - Avec votre logiciel FTP, ouvrer s'il existe le dossier spip, puis le dossier «ecrire» et enfin le dossier «data». Il vous faut maintenant créer un dossier nommé «admin_xxxxxxxxxx» en remplaçant les xxxxxxxxxx par le code indiqué dans la fenêtre SPIP. Dans la fenêtre SPIP, cliquer sur «recharger cette page», patientez quelques secondes... et la mise à jour sera effectuée. 2) Solution 2 : Ecraser les anciens fichiers. Dans un premier temps, il est important que vous prenez soin de sauvegarder la base de données, les fichiers de votre version actuelle de SPIP et également le dossier IMG. 2.1) Sauvegarde de la base de données. Il est important de sauvegarder votre base de données avant la mise à jour, mais ne la réinstallez pas si tout à fonctionner! La sauvegarde est une simple précaution en cas de gros problème lors de la mise à jour, mais si l opération se déroule bien (ce qui est presque toujours le cas!), vous ne devez pas réinstaller cette sauvegarde. La sauvegarde est réalisée avec une structure des données correspondant à la version précédente de SPIP ; si vous installez ces données après la mise à jour, vous les réinstallez dans une structure qui a évolué, provoquant ainsi l apparition de problèmes. Pour réaliser la sauvegarde de votre base de données (c est-à-dire de l intégralité de vos documents réalisés avec SPIP), rendez-vous dans la page «Sauvegarde/restauration de la base» de l espace privé, et cliquez sur le bouton «Sauvegarder la base».

5 Figure 1 : sauvegarder la base La procédure d authentification par FTP démarre : Figure 2 : authentification par FTP La nouvelle page vous indique un nom à recopier, du type «admin_xxxxx». Copiez ce nom, et démarrez votre logiciel-client FTP. Rendez-vous sur votre compte FTP correspondant à votre site, et placez-vous dans le dossier «/data» qui se trouve à l intérieur du dossier «/ecrire». Dans ce dossier «/data», créez un nouveau dossier auquel vous donnez le nom indiqué ci-dessus (votre nouveau dossier aura donc un nom de la forme «admin_xxxx»). Une fois ce dossier créé, revenez à la page de votre butineur, et cliquez sur le bouton «recharger cette page». La sauvegarde est alors effectuée. Si vous le désirez, vous pouvez vérifier dans votre logiciel FTP que le document «dump.xml» (ou «dump.xml.gz») a été créé : ce document est la sauvegarde de votre site. Vous pouvez la laisser sur votre compte FTP, ou la télécharger sur votre propre ordinateur.

6 2.2) Installer la nouvelle version de SPIP. La véritable procédure de mise-à-jour commence ici. Le principe est très simple : il suffit d installer les fichiers de SPIP une nouvelle fois, exactement comme vous l aviez fait lors de la première installation, en décompactant SPIP sur votre propre disque dur et en envoyant tous les fichiers par FTP chez votre hébergeur. Il n est pas nécessaire de supprimer les fichiers de la version précédente. Cela n est ni nécessaire ni conseillé : en effet, si vous supprimez les anciens fichiers, vous devrez certainement procéder à nouveau au paramétrage de SPIP (indiquer les données de connexion à la base de données, etc.), procédure inutile si vous vous contentez d écraser les anciens fichiers avec les nouveaux. En effaçant les anciens fichiers, vous risquez même d effacer les images contenues dans vos articles! Donc : restez simple : inutile d effacer quoi que ce soit avant d installer les nouveaux fichiers ; les nouveaux écraseront les anciens automatiquement ) Déclenchez la mise à jour. Une fois tous les fichiers réinstallés, rendez vous dans l espace privé de votre site. Dans votre espace privé, vous obtenez invariablement le message : «Message technique : la procédure de mise à jour doit être lancée afin d adapter la base de données à la nouvelle version de SPIP. Si vous êtes administrateur du site, veuillez cliquer sur ce lien.» : Figure 3 : Lancement de la mise à jour En tant qu administrateur, suivez le lien pour pouvoir déclencher la mise à jour de SPIP. Vous arrivez sur un écran d authentification par FTP, exactement similaire à la procédure décrite plus haut (pour la sauvegarde de la base) : Figure 4 : Authentification par FTP Une nouvelle fois, copiez le mot indiqué par cet écran et, avec votre logiciel-client FTP, créez un nouveau répertoire dans «ecrire/data», et donnez-lui le nom que vous

7 venez de copier. Cliquez sur «recharger cette page», ce qui déclenche la mise à jour de la base de données de SPIP.