{{tag> dokuwiki actualizar}}

====== Backup y actualización de dokuwiki ======

Suponemos que el dokuwiki está en ''/var/lib/dokuwiki'' que es un enlace simbólico al directorio que contiene los fuentes de dokuwiki.

====== Backup de dokuwiki ======


<code console>
# Copia de datos
cd /var/lib/dokuwiki/
tar cvzf ~/doku.tgz data/pages/ data/meta/ data/media data/media_meta/ data/attic/ data/media_attic/
</code>


<code console>
# Copia de configuración
cd /var/lib/dokuwiki/conf
tar cvzf ~/doku.conf.tgz acl.auth.php local.php users.auth.php apache.conf
</code>


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

FIXME:

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

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

<code console>

# /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 .
</code>

:!: :!: :!: **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

<code console>
# 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 note numberedheadings odt refnotes tag qna include testing commentsyntax gallery mathjax latexcaption; 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/note lib/plugins/
cp -r $OLD/lib/plugins/odt 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</code>

Para saber los plugins de la anterior versión y compararlos con la nueva
<code console>
ls $OLD/lib/plugins/ > /tmp/old.txt
ls $NEW/lib/plugins/ > /tmp/new.txt
meld /tmp/old.txt /tmp/new.txt &
</code>

Reiniciar apache

<code console>
#/etc/init.d/apache2 start
systemctl start apache2
</code>

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

====== Restauración del índice de búsqueda ======
Restaurar el índice de búsqueda como se indica en [[public:recetas:dokuwiki:problemas_con_las_busquedas_de_dokuwiki]]