Upgrading MindTouch Deki (non-VM)

Backup your attachments

mkdir ~/deki_backup
cd /var/www/deki-hayes/
tar cvzpf ~/deki_backup/attachments.tar.gz attachments

Note that your Deki base directory may be different from /var/www/deki-hayes/.  Later installations of Deki use /var/www/dekiwiki/ as a base directory.  You will have to do this for each wiki database if they use different directories for attachments.

Backup your LocalSettings.php and AdminSettings.php files

cp LocalSettings.php AdminSettings.php ~/deki_backup

Note: Deki installations from and after 1.9.0 do not use AdminSettings.php and it may be missing from your Deki base directory.  This is not a problem.  If it exists, copy it.

In the event that you have any customizations such as favicons, icons, images, etc. that you wish to install in the upgraded installation you should also copy them at this time since the entire dekiwiki base directory is being replaced by the upgrade.

Backup your mindtouch.host.sh script and mindtouch.deki.startup.xml

cp ./bin/mindtouch.host.sh ~/deki_backup
cp ./config/mindtouch.deki.startup.xml ~/deki_backup

NOTE: If you're running on Windows the dekihost startup script is named mindtouch.host.bat

cp mindtouch.host.bat ~/deki_backup

Backup your MySQL Database

mysqldump -u<user> -p<pass> <dbname> > ~/deki_backup/wikidb.sql

Note:  If you have multiple wiki databases make sure to backup each database.

Delete old code

rm -rf /var/www/deki-hayes

Download new package

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

• RECOMMENDED: http://sourceforge.net/projects/dekiwiki (tarballs)
• http://wiki.opengarden.org/Source_Code (includes SVN enlistment info)

Install new package

Note that the filename used ("Deki_Wiki_1.9.0_Itasca_source.tar.gz") will be different depending on which version of MindTouch Deki you are upgrading.

cd ~/
tar xfvz Deki_Wiki_1.9.0_Itasca_source.tar.gz
cd Deki_Wiki_1.9.0_Itasca_source/
mkdir /var/www/deki-hayes
cp -r web/* /var/www/deki-hayes

Restore files

cd ~/deki_backup
cp LocalSettings.php AdminSettings.php /var/www/deki-hayes/
tar xvzpf attachments.tar.gz -C /var/www/deki-hayes/
cp mindtouch.host.sh /var/www/deki-hayes/bin/
cp mindtouch.deki.startup.xml /var/www/deki-hayes/
chown -R www-data /var/www/deki-hayes/

NOTE: If you're running on Windows the dekihost startup script is named mindtouch.host.bat

cp mindtouch.host.bat /var/www/deki-hayes/bin/

In the event that you have any customizations such as favicons, icons, images, etc. that you wish to install in the upgraded installation you should also restore them at this time.

Run DB update script

cd /var/www/deki-hayes/maintenance
php update-db.php

NOTE: For Windows, if 'php' is not a defined win program, find where your 'php.exe' is, and then use it to run update-db.php file.  If you are hosting multiple wikis each database needs to be updated.  The update-db.php program will automatically update multiple databases using the information in the LocalSettings.php file. Watch the update process carefully and be sure that it completes successfully for all databases.

Clean up the skins cache folder

Please make sure your skins/common/cache folder can be written by the apache user (depending upon your Linux distribution this may be www-data, nobody, etc.)

cd /var/www/deki-hayes/skins/common/cache/
rm -rf cache-*

Update Apache mod_rewrite Rules

The Itasca release needs an additional mod_rewrite rule to support the new editor dialogs.  Edit your apache configuration and make sure you have the following rules:

      RewriteEngine On
	RewriteCond %{REQUEST_URI} ^/$
	RewriteRule ^/$ /index.php?title= [L,NE]

	RewriteCond %{REQUEST_URI} ^/@gui/[^.]+$
	RewriteRule ^/@gui/(.*)$ /proxy.php?path=$1 [L,QSA,NE] 

	RewriteCond %{REQUEST_URI} !^/(@api|editor|skins|config|@gui)/
	RewriteCond %{REQUEST_URI} !^/index\.php
	RewriteCond %{REQUEST_URI} !^/favicon\.ico$
	RewriteCond %{REQUEST_URI} !^/robots\.txt$
	RewriteCond %{QUERY_STRING} ^$ [OR] %{REQUEST_URI} ^/Special:Search
	RewriteRule ^/(.*)$ /index.php?title=$1 [L,QSA,NE]

Restart Apache

/etc/init.d/apache2 restart

Restart dekihost

/etc/init.d/dekihost restart

NOTE: If you're running windows, launch the mindtouch.host.bat script instead of the command above

Final Steps

Before you attempt to open MindTouch Deki in your browser you should clear your browser cache.  If any users report problems with the newly upgraded MindTouch Deki have them flush their browser cache and try again.  Surprisingly this will fix many initial problems.

Next go to MindTouch Deki in your browser and log in as a user with administrator privileges.  Go to Control Panel/Site Settings and "rebuild search Index".  If you have multiple wiki databases do this for each wiki.

Verify

It is suggested that you check out your upgraded MindTouch Deki to be sure that everything is working correctly before letting users start making changes.

Go to top