Public : migrants.

Après moult consultations entre moi et moi, j’ai décidé de vous donner les instructions de migration définitive dès aujourd’hui. Avec les fêtes de fin d’année, je pense que certains d’entre vous seront plutôt disponibles au début et d’autres à la fin de la période des vacances scolaires. Vous pourrez ainsi planifier tranquillement le temps que vous pouvez y consacrer.

Ce que je propose à ceux qui le souhaitent c’est de fixer un « rendez-vous » ici avec un gentil compère plus aguerri que vous qui se rendra disponible à ce moment-là pour vous répondre au fur et à mesure, ici dans les commentaires ou par mail, téléphone, enfin ce qui vous conviendra le mieux. On se retrouvera tous ici pour un billet dans deux jeudis où on fera le point sur la façon dont s’est déroulée pour vous cette migration, les problèmes restant à résoudre, les étapes que vous avez jugées les plus difficiles, celles où il vous semble que la documentation mériterait d’être étoffée, etc.

On continuera l’accompagnement ici, ou pas, selon les chantiers en cours et leur niveau d’« universalité » et de toutes façons je reste joignable hors blog ;-)

Première étape (facultative)

À part Samantdi, à laquelle la procrastination a bien rendu service, votre version de Dotclear n’est pas la plus récente. Vous pouvez la mettre à jour avant de continuer ou décider de faire ça plus tard. Si vous décidez de la faire maintenant, c’est rapide et facile :

  • si votre admin dc2 est ouverte, déconnectez-vous ; ceci est impératif
  • sauvegardez le fichier inc/config.php sur votre disque dur
  • téléchargez l’archive (zip ou tar.gz) de la dernière version de Dotclear (attention PAS l’installeur automagique) sur votre disque dur
  • la décompresser, renommer le répertoire décompressé dc2 (c’est-à-dire le même nom que vous aviez choisi pour le répertoire lors de l’installation de Dotclear 2)
  • y placer dans le sous-répertoire /inc la copie du config.php qu’on a sauvegardée au premier point ci-dessus
  • dans votre espace web, renommez votre répertoire dc2 en old-dc2
  • envoyez à la place le nouveau dc2 que vous avez préparé sur votre disque dur
  • si votre old-dc2 comportait un fichier @@.htaccess@ recopiez-le dans le nouveau
  • remplacez /newblog/themes/default par une copie de celui du nouveau dc2 (autrement dit vous mettez le nouveau thème par défaut à la place de l’ancien dans newblog.
  • rendez-vous sur votre panel de connexion à votre administration

Un message vous annonce que votre installation a été mise à jour. Après quelques heures, si vous n’avez rencontré aucun souci, vous pourrez supprimer old-dc2.

C’est parti !

Récupérer les contenus à jour

  • Faites un billet sur votre blog Dotclear 1 annonçant que vous fermez les commentaires durant la migration (et faites-le ;-)).
  • Rendez-vous dans votre panel d’administration de dc2, sélectionnez le newblog, importez de nouveau, comme la semaine dernière, votre blog dotclear 1. Cette importation remplacera l’ancien contenu de newblog.
  • Vérifiez que tout va bien, ne vous occupez pas du mauvais affichage des images, c’est normal.

Récupérer l’ancienne adresse

À n’entamer que lorsque vous avez un moment tranquille devant vous pour éviter les fausses manips d’énervement.

C’est l’étape délicate, que je vais traiter de façon générique et nous discuterons (ou avec votre protecteur) des cas particuliers séparément. Elle n’est pas à proprement parler compliquée mais demande de suivre/comprendre attentivement le déroulement des opérations. Je précise donc tout de suite que je partirai du principe que votre ancien blog répondait à l’adresse http://mondomaine.tld/dotclear et que vos urls de billets ressemblaient à http://mondomaine.tld/dotclear/index.php?YYYY/mm/dd/xxx-Titre-du-billet ou http://mondomaine.tld/dotclear/index.php/YYYY/mm/dd/xxx-Titre-du-billet[1]. Si vous n’êtes pas dans ce cas, signalez le dans les commentaires pour une explication adaptée.

Si vous êtes dans le cas de Traou (ses URL sont composées avec /blog au lieu de /dotclear) il suffit de suivre les mêmes instructions que les autres mais en remplaçant dotclear par blog dans les explications qui suivent.

J’anticipe d’ores et déjà quatre questions :

  • Nous n’allons pas détruire le blog dotclear 1 avant quelques semaines le temps d’être sûrs que tout va bien ; il sera donc loisible de retourner en arrière en cas de grosse anicroche ou d’y récupérer des éléments manquants
  • Nous n’allons pas renommer le répertoire du « moteur » (dc2)
  • Nous n’allons pas modifier l’identifiant du blog, qui reste newblog
  • L’adresse pour vous connecter à votre administration est et restera http://mondomaine.tld/dc2/admin
Sur le FTP
  • Renommez le répertoire dotclear (celui de votre blog Dotclear 1) en dc1
  • Renommez le répertoire newblog en dotclear
  • Placez-y le répertoire images qui était dans votre blog Dotclear 1
Dans l’administration
  • Modification : Tableau de bord -> Paramètres du blog -> URL vers le blog : http://mondomaine.tld/dotclear/index.php? si le format des URL était query_string sur votre Dotclear 1, http://mondomaine.tld/dotclear/index.php/ si le format des URL était path_info. Sous la ligne de l’URL vers le blog, vérifiez d’ailleurs que c’est réglé sur le bon format d’URL.
  • Modification : Extensions -> about:config :
    • public_path: ../dotclear/public
    • public_url: /dotclear/public
    • themes_path: ../dotclear/themes
    • themes_url: /dotclear/themes
  • Activation des redirections des billest : si vous ne l’aviez pas encore fait, c’est le moment d’installer le plugin dc1Redirect et de l’activer (l’activation se passe dans le panneau Paramètres du blog (tout en bas).
  • Redirection des flux rss et atom. Avec l’activation des redirections il y a un lien “Redirigez vos flux rss et atom”. Cliquez et suivez les instructions (que je reformule au cas où). Vous allez arriver sur un panneau avec deux champs. Le premier est à copier dans un nouveau fichier que vous nommerez rss.php et le second est à recopier dans un autre nouveau fichier que vous nommerez atom.php. Puis placez ces deux fichiers dans votre répertoire dotclear.

Arrivés là vous pouvez crier victware ! Il reste peut-être des détails à régler, on ne vous laissera pas tomber, mais 95% du boulot est fait et votre blog est opérationnel. Amusez-vous bien dans votre nouvelle maison et mettez-nous du champagne de côté !

Post-scriptum

Je vais faire le tour de vos cahiers des charges et y consacrer un billet spécifique pour ne pas mélanger les cas généraux et les cas particuliers.

Notes

[1] Voyez ce qui différencie ces deux adresses : un point d’interrogation après index.php pour la première et un slash pour la deuxième ; dans le premier cas on dit que le format des URL est query_string, dans le second qu’elles sont en path_info. Notez le bien, on en reparle plus loin.