Tabla de Contenidos
Actualización
Ántes de actualizar debes leer siempre el changelog para comprobar si ha cambiado algo que debas tener en cuenta en la actualización.
Para ver qué versión tienes, mira la fuente HTML de una página de DokuWiki - será algo como <meta name=“generator” content=“DokuWiki 2005-02-06” />.
La forma más sencilla de actualizar es siguiendo los siguientes pasos:
- Haz una copia de seguridad de todo el wiki (mejor asegurarse)
- Si has hecho cambios al archivo .htaccess que viene en el paquete de DokuWiki (por ejemplo para rewrite) asegúrate de hacer una copia de seguridad.
cp -a /path/to/wiki/* /path/to/wikibackup
-
tar xzvf dokuwiki-xxxx-xx-xx.tgz
- Copia o sube todos los archivos sobre el DokuWiki viejo sobreescribiendo todos los archivos existentes.
- Si el comando “cp” no funciona es porque estará relacionado en linux a “cp -i” lo que fuerza el modo interactivo incluso usando “cp -rf”. Puedes romper la relación de “cp”, sal y entra de nuevo y se habrá restaurado.
unalias cp cp -rf dokuwiki-xxxx-xx-xx/* /path/to/wiki/
- Borra los archivos viejos que ya no se usan (Revisa la lista de archivos que se ofrece más adelante).
- Comprueba el .htaccess por si necesita cambios (ver el paso 1)
- Actualiza los plugins
Los pasos indicados son seguros cuando se sigue el consejo de cambiar sólo versiones locales de los archivos de configuración (como conf/local.php en lugar de conf/dokuwiki.php). DokuWiki no sobreescribirá estos archivos locales. Si siempre usas el gestor de configuración, trabajas sobre seguro, porque siempre guarda en local.php. Los datos de usuario y la información de ACL nunca se sobreescriben porque DokuWiki sólo lleva ejemplos (con la extensión .dist).
Archivos a borrar
Aquí está la lista de archivos que se han borrado en los últimos releases. Debes comprobar si aún existen en tu instalación. Si están, bórralos.
# borrado en rc2008-03-31 inc/aspell.php inc/geshi/css-gen.cfg inc/lang/fr/admin_acl.txt lib/exe/spellcheck.php lib/images/toolbar/spellcheck.png lib/images/toolbar/spellnoerr.png lib/images/toolbar/spellstop.png lib/images/toolbar/spellwait.gif lib/plugins/acl/lang/ar/intro.txt lib/plugins/acl/lang/bg/intro.txt lib/plugins/acl/lang/ca/intro.txt lib/plugins/acl/lang/cs/intro.txt lib/plugins/acl/lang/da/intro.txt lib/plugins/acl/lang/de/intro.txt lib/plugins/acl/lang/el/intro.txt lib/plugins/acl/lang/en/intro.txt lib/plugins/acl/lang/es/intro.txt lib/plugins/acl/lang/et/intro.txt lib/plugins/acl/lang/eu/intro.txt lib/plugins/acl/lang/fi/intro.txt lib/plugins/acl/lang/fr/intro.txt lib/plugins/acl/lang/gl/intro.txt lib/plugins/acl/lang/he/intro.txt lib/plugins/acl/lang/id/intro.txt lib/plugins/acl/lang/it/intro.txt lib/plugins/acl/lang/ja/intro.txt lib/plugins/acl/lang/ko/intro.txt lib/plugins/acl/lang/lt/intro.txt lib/plugins/acl/lang/lv/intro.txt lib/plugins/acl/lang/nl/intro.txt lib/plugins/acl/lang/no/intro.txt lib/plugins/acl/lang/pl/intro.txt lib/plugins/acl/lang/pt/intro.txt lib/plugins/acl/lang/ru/intro.txt lib/plugins/acl/lang/sk/intro.txt lib/plugins/acl/lang/sr/intro.txt lib/plugins/acl/lang/sv/intro.txt lib/plugins/acl/lang/tr/intro.txt lib/plugins/acl/lang/uk/intro.txt lib/plugins/acl/lang/vi/intro.txt lib/plugins/acl/lang/zh/intro.txt lib/plugins/acl/lang/zh-tw/intro.txt lib/scripts/spellcheck.js lib/styles/spellcheck.css # borrado en 2007-06-26 inc/parser/wiki.php lib/images/interwiki/bug.gif lib/plugins/base.php lib/plugins/plugin/inc lib/plugins/plugin/inc/tarlib.class.php lib/plugins/plugin/inc/zip.lib.php lib/scripts/domLib.js lib/scripts/domTT.js # borrado en 2006-11-06 inc/admin_acl.php inc/lang/lt/stopwords.txt inc/magpie inc/magpie/rss_cache.inc inc/magpie/rss_fetch.inc inc/magpie/rss_parse.inc inc/magpie/rss_utils.inc lib/exe/media.php lib/tpl/default/mediaedit.php lib/tpl/default/media.php lib/tpl/default/mediaref.php # borrado en 2006-03-09 data/pages/wiki/playground.txt inc/auth/ldap.php inc/auth/mysql.php inc/auth/pgsql.php inc/auth/plain.php inc/lang/ca/admin_acl.txt inc/lang/cs/admin_acl.txt inc/lang/da/admin_acl.txt inc/lang/de/admin_acl.txt inc/lang/en/admin_acl.txt inc/lang/et/admin_acl.txt inc/lang/eu/admin_acl.txt inc/lang/fr/admin_acl.txt inc/lang/it/admin_acl.txt inc/lang/ja/admin_acl.txt inc/lang/lt/admin_acl.txt inc/lang/lv/admin_acl.txt inc/lang/nl/admin_acl.txt inc/lang/no/admin_acl.txt inc/lang/pl/admin_acl.txt inc/lang/pt/admin_acl.txt inc/lang/vi/admin_acl.txt inc/lang/zh-tw/admin_acl.txt inc/parser/spamcheck.php lib/images/favicon.ico lib/images/thumbup.gif lib/images/toolbar/code.png lib/images/toolbar/empty.png lib/images/toolbar/extlink.png lib/images/toolbar/fonth1.png lib/images/toolbar/fonth2.png lib/images/toolbar/fonth3.png lib/images/toolbar/fonth4.png lib/images/toolbar/fonth5.png lib/images/toolbar/list.png lib/images/toolbar/list_ul.png lib/images/toolbar/rule.png lib/tpl/default/images/interwiki.png
Quien tenga acceso por consola a su servidor puede copiar el texto anterior y pegarlo en un archivo, ejecutar los siguientes comandos para comprobar y borrar todos esos archivos. Sólo se borrarán los que existan. Un nombre para el archivo puede ser /tmp/removeold.txt.
for f in `cat /tmp/removeold.txt`
do
if [ -f $f ] ; then
ls -l $f
rm $f
fi
done
También, se puede usar esta línea de comando. Si eres un paranoico, cambia “rm -rf” por “ls -la” para ver qué archivos se borrarán. Puedes dejar comentarios o líneas vacías, pero se producirán errores/avisos.
cat /tmp/removeold.txt | xargs -n 1 rm -rf
Errores
Si encuentras inconsistencias en el comportamiento de DokuWiki después de actualizar, debes borrar la cache en data/cache/. Debes asegurarte que el navegador no está cacheando CSS o JavaScript viejos (fuerza una recarga con Shift-F5 o Shift-R en la mayoría de navegadores).
Páginas relacionadas:
- updatecheck – si la notificación de actulaización persiste
- toolbar – para problemas con los botones y el JavaScript
Alternativas
Aquí hay diferentes opciones de actualización descritas por los usuario. Pueden estar desactualizadas.