Upgrading Deki 1.9.0 & greater (non-VM)

Backup your attachments

mkdir ~/deki_backup
cd /var/www/dekiwiki/
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 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 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.

Rename the old /var/www/dekiwiki base directory (this will be deleted later after the upgrade is verified as successful).

mv /var/www/dekiwiki /var/www/dekiwiki_8.05

Download new package

Download the Deki Wiki Itasca 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_8.05.1_Jay_Cooke_source.tar.gz") will be different depending on which version of Deki Wiki you are upgrading.

cd ~/
tar xfvz Deki_Wiki_8.05.1_Jay_Cooke_source.tar.gz
cd Deki_Wiki_8.05.1_Jay_Cooke_source/
mkdir /var/www/dekiwiki
cp -r web/* /var/www/dekiwiki

Restore files

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

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

cp mindtouch.host.bat /var/www/dekiwiki/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/dekiwiki/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. 

cd /var/www/dekiwiki/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 dekiwiki

/etc/init.d/dekiwiki restart

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

Final Steps

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

Next go to 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 wiki to be sure that everything is working correctly before letting users start making changes.

Go to top