= Upgrading DokuWiki =

This document covers the upgrade procedure for StartupCTO (which is run with [[http://wiki.splitbrain.org/wiki:dokuwiki|DokuWiki]]). It should be performed whenever a new version of DokuWiki is released.

//**NOTE: 11 Jan 2011** - This is primarily an internal document, but is posted publicly in case it can help someone else upgrade their DokuWiki install. As a commenter notes, the official documentation is at http://www.dokuwiki.org/install:upgrade //

 * Backup the current StartupCTO DokuWiki directory (twice)<code bash>
tar cvfz ~/backup/scto/scto_full_020510.tar.gz scto
cp -Rp scto ~/scto.bak
</code>
 * Get the latest version, and unzip it (it will go in a new directory, e.g. ''dokuwiki-2009-12-25'').
 * In the ''conf'' directory, find all the ''*.dist'' files; you'll notice dokuwiki has auto-generated non ''dist'' versions for you. Copy those to the new site after reviewing them.
 * Make sure there weren't any additions to the language file (and if there were, port them over).<code bash>diff -r scto/inc/lang/en/ /dokuwiki-2009-12-25/inc/lang/en/</code>
 * Now you need to move any code modifications made to DokuWiki to the new codebase. Find the changes with:<code bash>grep -rin SCTO *</code>and port them over by hand. 
 * Do the same thing with the plugin files. You'll probably have to copy some images and a few things as well. You should also consider looking on the dokuwiki site for new versions of available plugins.
 * Delete the existing files in ''scto'', leaving the directories intact (so svn doesn't complain). 
 * Copy the new source (with the patches for SCTO) over to the existing directory:<code bash>cp -Rpfv dokuwiki-2009-12-25/ scto/</code>
 * Test everything