SPIP

[ar] [ast] [bg] [br] [ca] [co] [cpf] [cs] [da] [de] [en] [eo] [es] [eu] [fa] [fon] [fr] [gl] [id] [it] [ja] [lb] [nl] [oc] [pl] [pt] [ro] [ru] [sk] [sv] [tr] [vi] [zh] Espace de traduction

Télécharger

Effectuer une mise à jour

Novembre 2001 — mis à jour le : Septembre 2010

Toutes les versions de cet article :

Effectuer une mise à jour de SPIP est très simple. Cependant, voici une méthode pas à pas, recommandée pour éviter les erreurs.


La procédure, décrite en détail ci-après, peut sembler compliquée. En réalité, nous entrons volontairement dans le détail de chaque opération pour vous éviter certaines erreurs ; mais dans la pratique, la mise-à-jour de SPIP se réalise en quelques minutes et est d’une grande simplicité.

1. Sauvegardez votre base de données.

Avant toute modification importante d’un système informatique, il est toujours conseillé d’effectuer une sauvegarde de précaution.
Notez bien : il s’agit uniquement d’une précaution. Vous n’êtes pas obligé de l’effectuer, et le fichier de cette sauvegarde ne vous servira probablement à rien, puisque la mise à jour de SPIP se déroulera certainement sans aucun problème !

C’est la même logique que lorsque vous modifiez le système d’exploitation de votre ordinateur (installer une nouvelle version de Windows, de MacOS ou de Linux...) : vous sauvegardez vos documents importants, mais vous savez très bien que, si la mise-à-jour s’est bien déroulée, vous n’aurez pas besoin de réinstaller ces documents.

La procédure est expliquée dans cet article : « Sauvegarder vos données ».

Ce point est important : sauvegardez votre base de données avant la mise-à-jour, mais ne la restaurez pas ensuite ! En effet, nous avons constaté que de nombreux utilisateurs sauvegardaient leur base de données, effectuaient la mise-jour, puis réinstallaient leurs documents à partir de cette sauvegarde ; c’est une erreur, et leurs sites présentaient alors des dysfonctionnements. 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 restaurez 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.) Cette sauvegarde n’est donc utilisable qu’avec la bonne version de SPIP : pensez à la noter avant et à télécharger une ancienne version de SPIP pour pouvoir tout retrouver comme avant en cas de problème.

Si votre site est sensible à une perte de service d’une heure à un jour ou deux, il est important de faire la mise à jour en local d’abord, de manière à régler les problèmes avant la mise en ligne. C’est mieux s’il s’agit de la même configuration que sur votre espace Web mais c’est déjà bien si vous avez pu voir que c’est faisable sans gros bug avec vos squelettes et vos ajouts.

2. Installez la nouvelle version de SPIP

L’organisation des fichiers et répertoires ayant beaucoup changé entre les versions SPIP 1.8 et SPIP 1.9 et entre les versions SPIP 1.9 et SPIP 2.0 (ou SPIP 2.1), les procédures de mise à jour spécifiques sont détaillées dans les articles « Migration vers SPIP 1.9 » et « Mise à jour 1 .9 .x vers 2 .0 .x ».

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. Soit avec « spip_loader » qui effectue l’installation automatique des fichiers, soit plus traditionnellement en décompactant SPIP sur votre propre disque dur et en envoyant tous les fichiers par FTP chez votre hébergeur.

Notez bien : 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...

3. Déclenchez la mise à niveau de votre site

Une fois tous les fichiers réinstallés (par FTP, ou automatiquement avec « spip_loader »), rendez vous dans l’espace privé de votre site.

Notez bien : attendez que tous les fichiers soient bien installés chez votre hébergeur. Inutile d’essayer d’intervenir sur votre site pendant le transfert des fichiers, vous obtiendriez des résultats incohérents...

Dans votre espace privé, vous pouvez alors obtenir (cela dépend du « saut de version » effectué) 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. » :

En tant qu’administrateur, suivez le lien pour pouvoir déclencher la mise-à-jour de SPIP. Si vous êtes administrateur du site sans en être le webmestre, vous arrivez sur un écran d’authentification par FTP, exactement similaire à la procédure de sauvegarde de la base) :

image 420 x 225

Cette page vous indique un dossier et un nom à recopier, de la forme « 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 indiqué par la page (sous SPIP < 1.9 c’était ecrire/data, à présent c’est tmp sauf configuration spéciale ; mais ces changements de nom sont sans importance pour vous). Dans ce dossier, créez un nouveau dossier dont le nom est celui copié tout à l’heure (votre nouveau dossier aura donc un nom de la forme « admin_xxxxx »).

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

Voilà, l’opération de mise-à-jour est terminée.

Répétons ce conseil, car c’est une erreur très classique : ne réinstallez pas la base de données à partir de la sauvegarde effectuée précédemment. Cette sauvegarde correspond désormais à une ancienne structure des données, elle est donc plus ou moins inutilisable. Si l’opération s’est bien déroulée, vous pouvez même détruire cette ancienne sauvegarde.

En cas de pépin !

-  À certains endroits de l’espace privé (et parfois sur le site public), j’obtiens des messages d’erreur du type « file not found », « file missing », ou d’autres messages indiquant un problème de fichier incomplet ou manquant.

Il y a peut-être eu des problèmes lors du téléchargement des fichiers par FTP ; avec votre logiciel-client FTP, vérifiez la taille des fichiers incriminés ; notamment, si un fichier a une taille de 0 ko, réinstallez ce fichier.

-  J’obtiens beaucoup de messages d’erreur.

Réinstallez à nouveau l’intégralité des fichiers par FTP. On ne sait jamais...

-  Mon site fonctionne à peu près correctement, mais certaines fonctionnalités ne fonctionnent pas bien, les rédacteurs rencontrent des problèmes alors que cela fonctionne bien pour les administrateurs, etc.

Rendez-vous sur la liste de diffusion des utilisateurs de SPIP. Dans un premier temps, consultez les archives de cette liste, ou le forum pour voir si votre problème n’a pas été déjà abordé.

Exposez votre question en étant le plus précis possible : quel hébergeur, à partir de quelle version avez-vous effectué la mise à jour ; n’oubliez pas de signaler si ce problème apparaissait déjà ou non dans la version précédente.

Si votre problème est un bug encore inconnu, les développeurs travailleront très rapidement sur la question pour livrer une version corrigée.

Quelques liens complémentaires :
-  FAQ de spip
-  FAQ Spikini
-  Mettre à jour son site SPIP

P.-S.

Pensez également à vérifier la compatibilité des contributions et des plugins que vous utilisez avec la nouvelle version de SPIP, et à les mettre à jour au besoin.


Voir le squelette de cette page Site réalisé avec SPIP | Espace de traduction | Espace privé