Upgrading MindTouch 8.08 (Kilen Woods) to 9.02 (Lyons) (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 Deki 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 Deki Lyons build from one of the following sources:

• RECOMMENDED: http://sourceforge.net/project/showfiles.php?group_id=173074&package_id=198184(tarballs)
• http://wiki.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 Lyons, 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 9.02 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 version 9.02.

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

• Non-VM users must update your rewrite rules for this release. This is the last rewrite rule change we anticipate for Deki. Read how.
• 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.
• The email notifications feature does not use the PHP front-end to send email, but instead uses a .NET/Mono library. You will have to configure your startup XML with your email settings to enable email notifications for Lyons.
• MindTouch is forking the open source LDAP module to focus on developing enterprise-grade features for the LDAP module. The open source LDAP connector will remain available in the open source for users who upgrade with the same SID as the past - future installs will all utilize the new commercial LDAP module. Read more on why happened.