Upgrading MindTouch 1.9.0 (Itasca) to 8.05 (Jay Cooke) (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

Add the MindTouch repository

Edit the "/etc/apt/sources.list" file to add the following line : 

deb http://repo.mindtouch.com Debian_Etch/

Also in that file, you'll need to find the following lines:

deb http://ftp.debian.org/debian/ etch main 
deb-src http://ftp.debian.org/debian/ etch main 

and edit them to look like this:

deb http://ftp.debian.org/debian/ etch main non-free contrib 
deb-src http://ftp.debian.org/debian/ etch main non-free contrib

Type the following command to update your package indexes:

# apt-get update

Install Dependencies

To enable full functionality in MindTouch, install the dependencies by entering the following commands:

# apt-get install msttcorefonts cabextract html2text poppler-utils
# wget http://www.princexml.com/download/prince_6.0r6-1_i386.deb
# dpkg -i prince_6.0r6-1_i386.deb

Download The New Package

Download the MindTouch 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 The New Package

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

# cd ~/
# tar xfvz Deki_Wiki_8.05_Jay_Cooke_source.tar.gz
# cd Deki_Wiki_8.05_Jay_Cooke_source/
# 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-*

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 8.05.

Rebuild the Index

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