{{tag> dokuwiki maj}}

====== Mettre à jour Dokuwiki ======

La procédure de mise à jour n'a rien de complexe. Lorsque l'utilisateur est authentifié, une notification l'informe qu'une mise à jour est disponible. Avant de procéder à la mise à jour, il est conseillé de sauvegarder le répertoire de l'application. Jeter un œil au changelog  pour s'assurer qu'aucune action spécifique n'est nécessaire. 

Télécharger le tarball, changer de groupe et se positionner dans le répertoire de l'application:

<code bash>
newgrp www-data
cd /srv/dokukiwi/web
</code>

Décompresser l'archive dokuwiki-YYYY-MM-DD.tar.gz directement dans le dossier courant:
<code bash>
tar -xvzf /tmp/dokuwiki-rc2013-03-06.tgz --strip-components=1
</code>

L'utilisateur www-data doit avoir le droit d'écriture sur les dossiers:
  * ./conf/
  * ./data/

===== Suppression des fichiers obsolètes =====

Supprimer les fichiers non utilisés par la nouvelle version. Si des fichiers sont obsolètes, ils sont listés dans le fichier ./data/deleted.files

La commande suivante permet de les supprimer définitivement afin de limiter les risques de sécurité et les erreurs lors des changements de version:

<code bash>
grep -Ev '^($|#)' data/deleted.files | xargs -n 1 rm -vfr
</code>

<note tip>
Le chemins des fichiers à supprimer sont relatifs au root applicatif. Pour que la commande de suppression des fichiers obsolètes fonctionne il faut l'exécuter depuis la racine de l'application dokuwiki.
</note>

Grep filtre le fichier data/deleted.files. Il utilise les expression rationnelles (argument -E) pour sélectionner la liste des fichiers obsolètes. L'expression rationnelle '^($|#)' permet de ne sélectionner que les lignes vides ou les commentaires. L'argument -v de grep permet d'inverser la sélection. A la sortie seules les lignes non vides qui ne sont pas des commentaires sont donc sélectionnées et affichée sur la sortie standard. La sortie obtenue est ensuite redirigée sur l'entrée standard de la commande xargs permettant de construire et d’exécuter des commandes à partir de l'entrée standard. Pour chaque nom de fichier fournit par le filtre grep, xargs exécutera la commande rm avec les options -vf 


===== Suppression de la notification =====

Après mise à jour, la notification est encore affichée car les messages de notification sont en cache. Elle devrait normalement disparaître le jour suivant. Il est possible de supprimer plus rapidement l'affichage de la notification en supprimant le fichier en cache stockant les messages:

<code bash>
rm -vf data/cache/messages.txt
</code>


===== Références =====
  * https://www.dokuwiki.org/install:upgrade