Suponemos que los fuentes de dokuwiki están en /var/lib/dokuwiki

cd /var/lib/dokuwiki/
tar cvzf ~/doku.tgz data/pages/ data/meta/ data/media data/media_meta/ data/attic/ data/media_attic/ conf/

Importante: Si hay cambios en la configuración de la nueva versión de dokuwiki al restaurar la copia se perderán

Descargar de la página web de dokuwiki la versión a instalar (por ejemplo dokuwiki-stable.tgz)

# /etc/init.d/apache2 stop
systemctl stop apache2
 
OLD=/usr/lib/dokuwiki.old
NEW=/usr/lib/dokuwiki
 
cd /var/lib/
 
mv $NEW $OLD
 
tar xvzf dokuwiki-stable.tgz
# Esta orden genera un directorio, en este caso ''dokuwiki-2015-08-10a'', donde están los ficheros fuente. 
 
 
ln -s dokuwiki-2015-08-10a $NEW      # dokuwiki-2015-08-10a será el nuevo direcotrio
# Si el tar se descomprime en un directorio llamado ''dokuwiki'' la orden anterior no hay que ejecutarla
 
cp $OLD/conf/apache.conf $NEW/conf/
chown -R www-data:www-data $NEW/
 
cd $NEW
tar xvzf ~/doku.tgz
chown -R www-data:www-data .

Importante: Si hay cambios en la configuración de la nueva versión de dokuwiki al restaurar la copia se perderán (se escriben los ficheros del anterior conf sobre la nueva instalación

Actualizar los plugins

# Copiar los plugins que se quieran tener en la nueva versión, se muestran algunos a modo de ejemplo
 
for i in color editx latex note numberedheadings odt refnotes tag qna include testing commentsyntax; do
 
  cp -r $OLD/lib/plugins/$i/  lib/plugins/
 
done
 
# o 1 a 1
 
cp -r $OLD/lib/plugins/color/ lib/plugins/
cp -r $OLD/lib/plugins/editx lib/plugins/
cp -r $OLD/lib/plugins/latex lib/plugins/
...
 
 
# Si deja de funcionar el dokuwiki hay que revisar los plugins, porque algunos no son compatibles con versiones más modernas y hacen que no funcione.
 
 
chown -R www-data:www-data lib/plugins/
 
#Copiar los smileys del directorio lib/images/smileys/local (https://github.com/davidjimenez75/dokuwiki-smileys-local)
cp -r $OLD/lib/images/smileys/local lib/images/smileys

Para saber los plugins de la anterior versión y compararlos con la nueva

ls $OLD/lib/plugins/ > /tmp/old.txt
ls $NEW/lib/plugins/ > /tmp/new.txt
meld /tmp/old.txt /tmp/new.txt &

Reiniciar apache

#/etc/init.d/apache2 start
systemctl start apache2

Por último hay que entrar en la administración de plugins y actualizar todos aquellos que indique que están desfasados.

Restaurar el índice de búsqueda como se indica en problemas_con_las_busquedas_de_dokuwiki