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

:

Importante: En el tar solo habría que copiar del directorio conf los ficheros acl.auth.php, local.php, y users.auth.php (no se si alguno mas !!!!) para tener la configuración de la nueva versión de dokuwiki con las adaptaciones del antiguo

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=dokuwiki-2023-04-04a/
NEW=dokuwiki-2024-02-06a/
 
# dokuwiki es un enlace simbólico al directorio que contiene el código
rm dokuwiki
 
cd /var/lib/
 
 
tar xvzf dokuwiki-stable.tgz
# Esta orden genera un directorio, en este caso ''dokuwiki'', donde están los ficheros fuente. 
 
 
ln -s dokuwiki $NEW    # dokuwiki-2024-02-06a/ será el nuevo directorio con el código a ejecutar del dokuwiki
 
# Copiar la antigua configuración de apache en el nuevo directorio
cp $OLD/conf/apache.conf $NEW/conf/
chown -R www-data:www-data $NEW/
 
# Descomprimir la copia de los datos hecha previamente
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

Se puede comparar antes con meld !!!

Actualizar los plugins

# Copiar los plugins que se quieran tener en la nueva versión, se muestran algunos a modo de ejemplo
 
cd /var/lib/
 
for i in color editx latex note numberedheadings odt refnotes tag qna include testing commentsyntax; do
 
  cp -r $OLD/lib/plugins/$i/  $NEW/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 $NEW/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 $NEW/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