Comment mettre à jour DokuWiki

Ce billet, va vous expliquer la procédure, que je suis, pour mettre à jour notre wiki (DokuWiki).

Avant de faire une mise à jour, pensez à faire une sauvegarde de vos données.

1. Connexion au serveur

Chez TuxFamily, nous avons la chance d'avoir un accès SSH.

2. Sauvegarde des dossiers importants

Je sauvegarde uniquement les dossiers qui contiennent des données (le contenu des pages du wiki).

Les plus importants sont :

  • pages/
  • media/
cd data/
tar -cJf pages-20140821.tar.xz pages/
tar -cJf media-20140821.tar.xz media/

Je compresse avec l'algorithme LZMA2.

Je les exporte sur un autre ordinateur avec scp.

3. Téléchargement de l'archive

Nous utilisons uniquement des versions stables. Elles sont disponibles ici.

Par exemple pour la mise à jour de sécurité de la version 2014-05-05, voici l'URL.

wget http://download.dokuwiki.org/src/dokuwiki/dokuwiki-2014-05-05a.tgz

4. Décompression

Au préalable, j'aime bien parcourir le contenu de l'archive (on est jamais trop prudent, et on a aucune information, comment l'archive est constituée).

Visualisation du contenu

tar -tzf dokuwiki-2014-05-05a.tgz
[...]

Décompression

tar -xzf dokuwiki-2014-05-05a.tgz

5. Mise à jour (à proprement parlé)

On écrase tout.

cd htdocs/
cp -R dokuwiki-2014-05-05a/* .

6. Suppression des fichiers inutiles

Je suis cette procédure

cd htdocs/
grep -Ev '^($|#)' data/deleted.files | xargs -n 1 rm -vf

À ce stade, je me connecte au wiki, pour constater, qu'il est bien fonctionnel. Puis je supprime les fichiers superflus.

rm -Rf dokuwiki-2014-05-05a/
rm -f dokuwiki-2014-05-05a.tgz
rm -f data/deleted.files

J'utilise l'option -f, car sinon la commande rm est interactive.

Je regarde également si, le template doit être mis à jour, il est situé dans le dossier lib/tpl/.