Formations et ressources pour les TICE - ESPE Aix-Marseille          
[webmestre] Réaliser une copie locale d’un SPIP distant

Le but de l’opération consiste à récupérer les contenus de son SPIP d’établissement (= SPIP distant installé sur le serveur du rectorat) pour les transférer sur un SPIP installé en local.
On traitera le cas d’un SPIP local installé sur une machine Windows avec le serveur Easyphp. Ce SPIP local (téléchargement) est celui proposé spécifiquement pour ce stage dans la page Applications web "portables", à consulter pour plus de détails pour son "installation" et son utilisation.
Pour mémoire, l’arborescence des dossiers d’un SPIP (1.9.2 ici) est présentée sur l’image ci-contre (le dossier /www correspond au répertoire du serveur dans lequel est installé le SPIP)

Principe de la sauvegarde d’un SPIP

Un site dynamique sous SPIP stocke les informations permettant de générer les pages sous 2 formes :
 les éléments "textuels" (articles, brèves, mots clés...) et d’organisation (arborescence des rubriques, comptes utilisateurs....) sont enregistrés dans une base de données (généralement de type MySQL).
Cette base de données sera sauvegardées sous forme d’un "fichier de dump" en utilisant l’outil intégré de SPIP.
 tous les fichiers liés aux articles, brèves et rubriques (documents liés, images, fichiers médias...) sont stockés dans une arborescence organisée par types (/jpg, /pdf...) dans le sous-dossier /IMG du SPIP.
La sauvegarde de ces fichiers se fera par copie de l’ensemble de ce dossier /IMG.

1ère étape : sauvegarde de la base de données du SPIP distant

 se connecter dans la partie privée du SPIP en ligne avec un compte administrateur général puis ouvrir l’outil de sauvegarde : Configuration > Maintenance du site
  dans le cadre Sauvegarder le contenu de la base, cocher l’option Sauvegarde compressée, choisir un nom de fichier explicite (avec la date !!) puis valider.

  la liste des tables de la base de données apparaît au fur et à mesure qu’elles ont exportées dans le dump. Une fois finie un message vous informe que tout s’est bien passé : votre fichier de sauvegarde est disponible dans le sous-dossier /tmp/dump du SPIP distant.

2ème étape : récupérer le fichier de dump et le dossier /IMG sur le SPIP distant

 à l’aide d’un logiciel de FTP (File Transfert Protocol) connectez vous sur le SPIP distant. Vous aurez, bien sûr !, besoin des identifiants de connexion FTP de votre site : adresse du serveur, login et mot de passe, type de connexion (normale ou sécurisée). Ces informations vous ont étés fournies par les services en ligne (ou votre hébergeur privé) lors de la création de votre hébergement.
N.B : il est conseillé d’utiliser le logiciel FTP libre FileZilla Client : téléchargement / Documentation pour le paramétrage et l’utilisation

Pour un site sur le serveur du rectorat, le paramétrage devrait être le suivant :

• "Fichier" - "Gestionnaire de sites"
• sélectionner un site existant ou en créer un nouveau
• dans la partie "Détails du site" :
  • Hôte : webpedago.ac-aix-marseille.fr (zone B)
  • laisser le port par défaut il sera changé automatiquement par la suite
  • Type de serveur : sélectionner "SFTP - SSH File Transfer Protocol" pour Filezilla Client 3.0.x ou "SFTP en utilisant SSH2" pour Filezilla 2.2.x
  • Type d’authentification : Normal
  • Utilisateur : le nom d’utilisateur communiqué
  • Mot de passe : mot de passe communiqué
• dans la fenêtre de gauche (Site local), naviguez pour afficher le contenu du dossier /www de votre Easyphp (= SPIP local).
   une fois connecté, vous devez :
• récupérer le fichier xxxx-20090401.xml.gz de sauvegarde dans /tmp/dump et le passer dans le dossier /tmp/dump de votre SPIP local par un "glisser" entre les 2 fenêtres.
• de la même manière glissez le dossier /IMG de la fenêtre de droite ("Site distant") vers le dossier /www du site local. Un message vous demande si vous souhaitez remplacer les contenus existant : répondez que oui, vous souhaitez "écraser" "Toujours...".
  A ce point du processus les fichiers liés existant dans le SPIP local sont remplacés par ceux du site distant.

1ère + 2ème étape simplifiées : utilisation du plugin "Mes Fichiers"

Le plugin Mes Fichiers permet de réaliser automatiquement une archive zip contenant la sauvegarde de la base de données de SPIP + le dossier IMG. Cette archive zip est ensuite téléchargeable par le webmestre via un lien dans l’espace privé ce qui permet de ne pas nécessiter un accès FTP sur le serveur à cloner.

Manipulation :

• Ouvrir le menu "Configuration" > "Maintenance du site"
  
• Sauvegarder la base
  
• Utiliser le lien "poursuivre par la création du fichier..." pour générer le zip du dossier IMG
  
• Une fois cette étape faite, le retour à la page de maintenance propose un lien de téléchargement du zip obtenu
  
• enregistrer puis dézipper ce zip dans un dossier de son ordinateur permet de disposer des même éléments que dans la manipulation classique :
  • le fichier de sauvegarde de la base de données (mes_fichiers_xxxx_20150317.xml dans le sous-dossier xxxx__mes_fichiers_20150317_0003.zip\spip\tmp\dump\
  • le dossier IMG

3ème étape : gestion des plugins du site local

Pour éviter les embrouilles lors de la restauration, il est vivement conseillé d’installer et d’activer exactement les mêmes plugins dans le site local que ceux qui étaient présents dans le site distant avant de commencer la restauration. En effet, la restauration ne prendra en compte que les tables de données des plugins qui sont actifs sur le SPIP.

4ème étape : restaurer la base de données à partir du fichier importé

 connectez vous dans la partie privée de votre SPIP local (si nécessaire après avoir lancé le serveur Easyphp.exe) : http://127.0.0.1/ecrire/ et passez dans la page de gestion des sauvegardes/restaurations : Configuration > Maintenance du site
  votre sauvegarde devrait apparaitre dans la liste des sauvegardes utilisables pour une restauration (si ce n’est pas le cas, vérifier le contenu de votre dossier .../www/tmp/dump). Sélectionnez le fichier puis validez.

  à ce stade un message apparait pour vérifier que vous êtes bien webmestre du site :

• copiez le code proposé (Ctrl+C)
• rendez-vous dans le dossier /tmp de votre SPIP local et créez un sous-dossier dont le nom est le code copié juste avant. Validez en cliquant sur "Rechargez cette page".

 un cadre rouge apparait dans lequel les informations de restauration s’affichent au fur et à mesure du déroulement du processus. Une fois l’opération terminée vous êtes rebasculé dans la page d’accueil de l’espace privé : en principe le SPIP local dans lequel vous êtes est une copie à l’identique du SPIP distant...