Basic upgrade

This example assumes:

• The Apache username and group are www-data, i.e. Debian
• The tiki is installed as a subdirectory of /var/www/TikiWiki
• The version to be installed in tikiwiki-1.8.2
• Tiki is installed in a subdirectory named tiki
• I only used the procedure on a tiki with basic features enabled. It might not work for some features if those features happen to store or otherwise modify files within the tiki file tree.

cd /var/www/TikiWiki
wget http://aleron.dl.sourceforge.net/sourceforge/tikiwiki/tikiwiki-1.8.2.tar.gz
gunzip  -c tikiwiki-1.8.2.tar.gz | tar xvf -
chown www-data:www-data tikiwiki-1.8.2
cd tikiwiki-1.8.2
chown -R www-data:www-data *
./setup.sh www-data www-data
cd ..
diff tiki/db/tiki-1.8-mysql.sql tikiwiki-1.8.2/db/tiki-1.8-mysql.sql

• Stop here if the diff produces any output. Any output different from simple comment changes, of course. Use your common sense. (avgasse) This page does not yet contain information for how to deal with database migration issues.

/etc/init.d/apache stop
cd /var/www/TikiWiki
mv tiki tiki.bak
mv tikiwiki-1.8.2 tiki
cp tiki.bak/db/local.php tiki/db/local.php
cp tiki.bak/img/wiki_up/* tiki/img/wiki_up
/etc/init.d/apache start

When a database upgrade is needed

When is a DB upgrade needed

Usually only upgrades between major versions (1.7 to 1.8 for example) needs a DB upgrade. It could happen that a bugfix upgrade needs a database change, but this will be mentioned in the release notes. Currently, the only bugfix upgrade requiring DB upgrade is from 1.7.3 to 1.7.4.

What to do

This is similiar to the upgrading process described earlier. After installing the replacement tiki, You will need to update your database's structure. Scripts needed to do so are locate in tiki/db/. You must run them in order, proceesing by steps. Since there is no README, the steps are provided below. All the files needed to upgrade from one version to another are provided in any Tiki distribution, even if you don't need them. This means you can perform a basic upgrade, and then run all the scripts needed.

Assuming you have:

• mysql running on localhost
• wiki stored in database mydb
• user myuser

This is the specific command order you need to *safely* upgrade your database from 1.7.x to 1.8.x:

mysql -u myuser mydb -p -f < tiki_1.7to1.8.sql 
mysql -u myuser mydb -p -f < structure_fix_1.7to1.8.sql 
mysql -u myuser mydb -p -f < comments_fix_1.7to1.8.sql