Upgrading MindTouch 8.08 (Kilen Woods) to MindTouch 2009 (non-VM)

Back Up Attachments

Type the following commands to create the backup directory and back up your attachments: 

# mkdir ~/deki_backup
# cd /var/www/dekiwiki/
# tar cvzpf ~/deki_backup/attachments.tar.gz /var/www/dekiwiki/attachments

Back Up Settings Files

Enter the following commands to back up the files that MindTouch uses to determine settings: 

# cp /var/www/dekiwiki/LocalSettings.php ~/deki_backup # cp /etc/dekiwiki/mindtouch.deki.startup.xml ~/deki_backup # cp /etc/dekiwiki/mindtouch.host.conf ~/deki_backup

Note: If you have any site modifications such as custom skins, CSS, or resource file modifications, they must be backed up now as well and restored after the upgrade.

Backup your MySQL Database

Use the following line to back up the MySQL database: 

# mysqldump -u<user> -p<password> wikidb > ~/deki_backup/wikidb.sql

Download The New Package

Download the MindTouch 2009 build from one of the following sources:

• RECOMMENDED: http://sourceforge.net/projects/dekiwiki (tarballs)
• http://developer.mindtouch.com/Source_Code (includes SVN enlistment info)

Install The New Package

Type the following lines to expand and move the files to their correct location:

# cd ~/
# tar xfvz deki-09.02.00.tar.gz
# cd deki-09.02.00
# rm -rf /var/www/dekiwiki
# mkdir /var/www/dekiwiki
# cp -r web/* /var/www/dekiwiki

Restore Files

Type the following commands to restore the attachments and settings files: 

# cd ~/deki_backup
# cp LocalSettings.php /var/www/dekiwiki/
# tar xvzpf attachments.tar.gz -C /var/www/dekiwiki/
# cp mindtouch.deki.startup.xml /etc/dekiwiki/
# chown -R www-data /var/www/dekiwiki/

Run DB Update Script

# cd /var/www/dekiwiki/maintenance
# php update-db.php

Clean Up The Skins Cache Folder

Enter the following lines to clear the skins cache:

# cd /var/www/dekiwiki/skins/common/cache/
# rm -rf cache-*

Update Apache Rewrite Rules

For MindTouch 2009, the deki folder must be added a RewriteRule exclusion. Be sure that your RewriteRule exclusions look like this: 

RewriteCond %{REQUEST_URI} !^/(@api|editor|skins|config|deki)/

You can also remove any references to /@gui/ in your rewrite rules. When in doubt, refer to our Apache configuration for MindTouch 2009 and try to match it up as closely as possible.

Then restart apache:

/etc/init.d/apache2 restart

Start Dekihost

# /etc/init.d/dekiwiki restart

Launch a web browser, and clear the cache. Connect to your wiki by typing in http://IP_ADDRESS, where IP_ADDRESS is the IP of your linux machine. Click on Tools, then About to verify that  you are using MindTouch 2009.

Rebuild the Index

In the wiki, click on Tools, then Control Panel, and then Site Settings. Click Rebuild Index to re-index the wiki.

Important Notes

• The syntax highlighter service was moved into a DekiScript extension - please check out our FAQ on how to re-enable this service.
• ThinkFree is no longer providing free access to their Viewer API - we have now removed this functionality in MindTouch.