La historia ya la conté en el post anterior, así que voy a ir directo al grano: cómo migrar dokuwiki.

En este petit tutorial no tendré en cuenta incompatibilidades entre diferentes versiones de dokuwiki, y obviamente daré por sentado que se está corriendo en un sistema POSIX

Comenzamos por obtener la última versión de dokuwiki desde su sitio oficial:

Parados dentro del directorio de nuestro wiki:

• [mento]$ wget “http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2008-05-05.tgz?id=projects%3Adokuwiki_and_cache=cache”

Renombramos para que sea más legible:

• [mento]$ mv dokuwiki-2008-05-05.tgz?id=projects%3Adokuwiki_and_cache=cache dokuwiki-2008-05-05.tgz

Luego descomprimimos:

• [mento]$ tar -zxvf dokuwiki-2008-05-05.tgz

Eso nos deja un directorio dokuwiki-2008-05-05

Lo más práctico es coipar paso a paso toda la estructura de nuestro wiki a este nuevo wiki que hemos “instalado”. De esta forma no romperemos nada, y si algo sale mal siempre podremos volver a empezar. Demás está decir que es bueno respaldar antes de comenzar el proceso.

Toda la configuración de dokuwiki (al menos si se lo usa como viene por omisión) se encuentra en el directorio conf, contenido en archivos de texto plano.

Usaremos la herramienta vimdiff para comparar las nuevas versiones de los archivos de configuración, con las versiones antiguas. No podemos simplemente copiar la vieja configuración en lugar de la nueva, porque probablemente las nuevas y maravillosas funcionalidades que dokuwiki nos brinda versión tras versión requieran de nuevos parámetros y valores.

Como sólo descomprimimos dokuwiki, pero no corrimos el instalador, los archivos de configuración aún no estarán creados. Por eso nos moveremos al directorio conf, y copiaremos los siguientes archivos:

• [mento]$ cp local.php.dist local.php
• [mento]$ cp words.aspell.dist words.aspell

A continuación analizaremos cuidadosamente el principal archivo de configuración, comparandolo con el anterior:

• [mento]$ vimdiff local.php ../../conf/local.php

La idea es que de los dos hagamos uno. Siempre conviene revisar el changelog y las notas de instalación, para saber si algún parámetro cambió de nombre.

Luego de tener lista la configuración, copiaremos los plugins. Los mismos se encuentran en lib/plugins/

• [mento]$ cp -r lib/plugins/blog/ dokuwiki-2008-05-05/lib/plugins/

Repetimos el paso anterior con todos los plugins. Eso ya copiará la configuración correspondiente.

Luego copiaremos los usuarios, y las acl:

• [mento]$ cp conf/acl.auth.php dokuwiki-2008-05-05/conf/
• [mento]$ cp conf/users.auth.php dokuwiki-2008-05-05/conf/

La última “configuración” que va faltando es el template:

• [mento]$ cp -r lib/tpl/incognitek dokuwiki-2008-05-05/lib/tpl/

Ahora sólo nos faltan los datos:

• [mento]$ cp -r data/ dokuwiki-2008-05-05/

Algo que suele suceder es que el mensaje de actualización de dokuwiki sigue apareciendo. Para que no aparezca más, debemos esperar un día, o simplemente:

• [mento]$ rm -f dokuwiki-2008-05-05/data/cache/messages.txt

Ahora ya tenemos nuestro wiki funcionando, el cuál podemos probar apuntando al directorio creado de nuestro dominio:

http://dklight.info/dokuwiki-2008-05-05

Para dejarlo funcional, simplemente movemos todo al raíz del dominio (luego de borrar o mover todo el viejo wiki):

• [mento]$ mv * ../

Los tips, y lo que sea que quede mal, lo dejo para la próxima… :D