Upgrading MindTouch Deki 1.9.0 (Itasca) to 8.05 (Jay Cooke) (non-VM)

Upgrading MindTouch Deki 1.9.0 (Itasca) to 8.05 (Jay Cooke) (non-VM)

Upgrading MindTouch Deki 1.9.0 (Itasca) to 8.05 (Jay Cooke) (non-VM)

This guide assumes you are upgrading a source code-installed MindTouch Deki from v.1.9.0 to v.8.05 on the Debian operating system (some components may differ on other operating systems). If you are upgrading from an earlier version, please visit http://wiki.opengarden.org/Deki_Wiki/Installation_and_Upgrade to find your appropriate guide.

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

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 Deki, 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 Deki Itasca build from one of the following sources:

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.

Powered by MindTouch Deki v.8.08.1a