Upgrading a Web-hosted installation via FTP

This article gives you a rough overview how to upgrade a Web-hosted DokuWiki installation using FTP. The main focus is on preserving Last modified dates for all pages. In this example, I will show you how to upgrade from version 2006-03-09b to 2006-11-06.

The versatile Total Commander file manager was a real lifesaver to me, but other tools should work as well.

1. Rename these folders/files online:
   • folder /bin → /bin_old
   • folder /conf → /conf_old
   • folder /inc → /inc_old
   • folder /lib → /lib_old
   • file /.htaccess → /.htaccess_old
   • file /doku.php → /doku_old.php
   • file /feed.php → /feed_old.php
   • file /index.php → /index_old.php
   • file /VERSION → /VERSION-old
2. Clear the /data/cache folder to reduce download traffic.
3. Use your favourite FTP client to fully backup the complete DokuWiki folder to your local PC.

1. Get the dokuwiki-2006-11-06.tgz archive at the Download Page.
2. Extract these folders/files from dokuwiki-2006-11-06.tgz to your local DokuWiki backup folder:
   • folders: /bin, /conf, /data/media/wiki, /data/pages/playground, /data/pages/wiki, /inc, /lib
   • files: /.htaccess, /doku.php, /feed.php, /index.php, /VERSION
3. Remove unnecessary language files from these folders to reduce upload traffic.
4. Copy any existing acl.auth.php, local.php, users.auth.php, *.local.conf (acronyms, entities, interwiki, …) from /conf_old to /conf.
5. Copy any additional plugins from /lib_old/plugins to /lib/plugins or reinstall later
6. Copy any additional templates from /lib_old/tpl to /lib/tpl

1. Upload these folders/files to the web server:
   • folders: /bin, /conf, /data/media/wiki, /data/pages/playground, /data/pages/wiki, /inc, /lib
   • files: /.htaccess, /doku.php, /feed.php, /index.php, /VERSION

1. Test the new installation carefully!
2. Delete any /*_old* folders/files created in previous steps.