Mise a jour de Spip

version du 23/11/2011

auteur : Michel Suquet (Collège Jean-Monnet 91640 Briis-sous-Forges)

Cette page concerne particulièrement le passage à SPIP 2 et est désormais obsolète.

Voir la page Mise a jour SPIP3 pour passer à SPIP 3

Vue d'ensemble

Pour mettre à jour un site Spip d'une version à l'autre dans la branche 2.xx, il est prudent de prévoir une sauvegarde avant et après :

• une sauvegarde avant la mise à jour
• la mise à jour qui est un transfert de fichiers
• une sauvegarde après la mise à jour

Si tout se passe bien, la sauvegarde faite avant pourra être supprimée ultérieurement.

Pour un changement de branche, par exemple d'une version 1.9x vers une version 2.10, il y aura des modifications sur certains dossiers à prévoir.

Les exemples sont fournis dans le cas d'une mise à jour de la version 2.010 à la version 2.10 : à vous de les adapter à votre situation.

Sauvegarde avant la mise à jour

cas d'une mise à jour simple

Voici la liste des opérations dans le cas d'une mise à jour simple :

vider le cache de Spip
sauvegarder la base de Spip
récupérer le fichier de sauvegarde pour l'archiver
récupérer certains dossiers pour les archiver

Ces opérations avec quelques détails :

• vider le cache de spip

Survolez le bouton Configuration en haut de l'espace privé et cliquez sur Vider le cache

Cliquez ensuite sur le bouton Vider le cache correspondant aux images calculées ; cela videra les 2 caches.

Une fois le cache vidé, vous devriez avoir l'information suivante :

• par l'interface de sauvegarde de spip, choisir une sauvegarde compressée

Survolez encore le bouton Configuration et cliquez sur Maintenance du site

Choisissez une sauvegarde compressée, l'interface vous proposant ce choix par défaut et un nom du fichier au format .xml.gz qui reprend la date et le nom de votre site, puis cliquez sur Sauvegarder la base

Après une information fugitive, vous obtenez une information sur la sauvegarde effectuée

Cliquez sur le bouton Retour pour revenir à votre espace privé

• récupérer par ftp le fichier obtenu :

tmp/dump/College_Jean_MONNET_20100414.xml.gz

Le fichier au format .xml.gz est disponible dans le répertoire tmp/dump : téléchargez-le pour l'archiver

• Sauvegarder par ftp certains répertoires :

/IMG
/config
/plugins
/squelettes (non nécessaire si le squelette est un plugin comme ScolaSpip)

Archivez ces répertoires de la même manière que le fichier au format .xml.gz

cas d'un changement de branche

Pour une mise à jour d'une version 1.9xx à une version 2.10, la procédure est pratiquement la même, avec la sauvegarde par ftp d'un peu plus de répertoires :

/config
/IMG
/plugins
/squelettes
/dist
/tmp
/ecrire
/oo
/formulaire

Une fois ces répertoires sauvegardés, il faudra vider les répertoires suivants :

/tmp
/ecrire

Et supprimer les répertoires suivants :

/dist
/oo
/formulaires

Mise à jour de la version de Spip

cas d'une mise à jour simple

Voici la liste des opérations à faire :

télécharger la nouvelle version de Spip
décompresser l'archive téléchargée et renommer le répertoire en spip210
désactiver les plugins. Il est même conseillé de supprimer tous vos plugins pour repartir sur de bonnes bases. 
Pour cela, renommer le dossier plugins et vous le supprimerez plus tard.
transfert par ftp des répertoires et fichiers contenus dans spip210
mise à niveau de la base (se connecter sur l'interface rédacteur avec un compte administrateur)
réactiver les plugins (ou les réinstaller)
mettre à jour les plugins (ou les réinstaller). Dans spip on peut les installer un à un dans l'interface  à condition d'avoir créer un dossier « auto » dans « plugins ».
vérifier que le site fonctionne (éventuellement, vider le cache)
En cas d'erreur, vider tout le contenu de tmp (fichiers et dossiers) sauf éventuellement « dump », « sessions », « upload » et « visites ».

Quelques détails pour ces opérations :

• télécharger la nouvelle version de Spip

Téléchargez la nouvelle version de Spip pour obtenir une archive spip.zip. La version disponible à la date de rédaction de cet article est la spip2.1.0.

• décompresser l'archive téléchargée et renommer le répertoire en spip210

L'archive décompressée donne un répertoire nommé spip, ce qui n'est pas très pratique pour repérer rapidement de quelle version il s'agit. Le mieux est de renommer ce répertoire spip210.

• désactiver les plugins

Survolez le bouton Configuration et cliquez sur Gestion des plugins

Décochez tous les plugins actifs puis cliquez sur Valider pour les désactiver

Remarque : il est fortement possible que l'accès au site et à la partie privée ne soit plus possible
et  qu'à la place vous ayez une page d'erreur.
Pas de panique, il suffit, par ftp, de supprimer, dans le  répertoire tmp, les répertoires /tmp/cache
et /tmp/couteau-suisse (évidemment, pour ce   dernier répertoire, si le plugin couteau-suisse est installé).

• transfert par ftp des répertoires et fichiers contenus dans spip210

Transférez par ftp l'ensemble du contenu du répertoire spip210 à la racine de votre site (cela dépend bien sûr de l'organisation de votre site)

Au début de ce transfert, il vous sera demandé la validation du remplacement d'un premier fichier : cochez toujours utiliser cette action avant de cliquer sur Valider ; cela vous évitera de le faire à chaque remplacement de fichier ;-)

• mise à niveau de la base (se connecter sur l'interface rédacteur avec un compte administrateur)

Remarque : cette opération n'est pas toujours nécessaire et il se peut que vous n'ayez pas à la faire.

Une fois le transfert des fichiers terminé, connectez-vous sur l'espace privé avec un compte administrateur pour la mise à niveau éventuelle de la base de spip. Si cette mise à niveau est nécessaire, vous devriez obtenir la page suivante :

Après avoir Cliqué sur Cliquer sur ce lien, vous obtenez cette page

Vous copiez le nom du répertoire à créer, par ftp, dans le dossier /tmp

après avoir collé admin_99f882d888 que vous aviez copié précédemment, vous cliquez sur Valider pour créer le dossier /tmp/admin_99f882d888.

Dans l'espace privé, cliquez maintenant sur Recharger cette page pour lancer la mise à niveau de la base de spip.

• réactiver les plugins

En revenant sur la page de gestion des plugins, vous observerez une modification de cette page.

Cliquez sur Liste de plugins et cochez les plugins à réactiver puis cliquez sur Enregistrer

• mettre à jour les plugins (option automatique par le couteau suisse)

Une option (à paramétrer) du plugin couteau suisse vous indiquera quels sont les plugins dont une mise à jour est disponible et vous permettra de procéder à cette mise à jour assez simplement.

• vérifier que le site fonctionne (éventuellement, vider le cache)

Regardez les pages suivantes :

la page d'accueil
quelques articles
quelques rubriques

N'oubliez pas non plus de vider le cache de votre butineur…

cas d'un changement de branche

Après la réalisation des opérations listées ci-dessus, rajouter un répertoire /plugins/auto et un répertoire /lib :

• création par ftp du répertoire /plugins/auto
• création par ftp du répertoire /lib

Sauvegarde après la mise à jour

Voici la liste des opérations à faire dans tous les cas :

vider le cache de spip
choisir une sauvegarde compressée (via l'interface de sauvegarde de spip)
récupérer par ftp le fichier compressé et l'archiver

En cas de problème

Si lors de la vérification du fonctionnement du site des problèmes apparaissent, le mieux est de les décrire en détails sur le forum web de l'académie de Versailles.

Avant de soumettre votre problème, n'hésitez pas à regarder sur ce forum si une autre personne a déjà écrit un message le décrivant ;-)

Notamment, si vous n'arrivez plus à accéder à l'espace privé du site, pensez à supprimer les
sous-répertoires du répertoire tmp sauf les sous-répertoires dump, sessions visites et upload.

Documentation

• des articles sur le site de Spip : Sauvegardez vos données, Effectuer une mise à jour.