Mise à jour d'une version 1.8 (non-VM) vers une version 1.9

Sauvegarder les fichiers attachés

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

Notez que votre répertoire de base Deki peut être différent de /var/www/deki-hayes/.  Les installations récentes de Deki utilisent /var/www/dekiwiki/ comme répertoire de base.  Vous aurez à faire ceci pour chaque base de wiki si différents répertoires sont utilisés pour les fichiers attachés.

Sauvegarder les fichiers LocalSettings.php et AdminSettings.php

cp LocalSettings.php AdminSettings.php ~/deki_backup

Note: Les installations de Deki installations à partir de 1.9.0 n'utilisent pas AdminSettings.php et il peut donc être absent de votre répertoire de base. Ceci n'est pas un problème. Par contre, s'il existe, copiez-le.

Si vous avez fait des personalisations comme les favicons, les icones, les images, etc. et que vous souhaitez les installer dans la version mise à jour, alors vous devez aussi les sauvegarder ici car la totalité du répertoire de base est remplacé lors de cette mise à jour.

Sauvegarder le script mindtouch.host.sh et mindtouch.deki.startup.xml

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

cp mindtouch.host.bat ~/deki_backup

Sauvegarder votre base MySQL

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

Note:  Si vous avez plusieurs bases de wiki, assurez-vous de bien toutes les sauvegarder individuellement.

Supprimer le vieux code de l'application

rm -rf /var/www/deki-hayes

Télécharger le nouveau paquetage

Téléchargez le projet MindTouch Deki depuis l'une des sources suivantes :

• RECOMMANDÉ : http://sourceforge.net/projects/dekiwiki (tarballs)
• http://wiki.opengarden.org/Source_Code (inclus les infos SVN)

Installer le nouveau paquetage

Il est à noter que le nom utilisé ici ("Deki_Wiki_1.9.0_Itasca_source.tar.gz") pourra être différent, selon la version de MindTouch Deki que vous mettez à jour.

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

Restaurer les fichiers

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: Si vous êtes sur Windows le script de démarrarrage de deki s'appelle mindtouch.host.bat

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

Si vous avez fait des personalisations comme les favicons, les icones, les images, etc. et que vous souhaitiez les installer dans la version mise à jour vous devez les restaurer maintenant.

Exécuter le script de mise à jour de la base

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

NOTE: Pour Windows, si 'php' n'est pas une application windows connue, trouvez où est stocké 'php.exe', et utilisez-le pour exécuter le fichier update-db.php.  Si vous hébergez de multiples wikis, chaque base de données doit être mise à jour. Le programme update-db.php mettra à jour automatiquement plusieurs bases de données dont les informations sont stockées dans le fichier LocalSettings.php. Regardez le processus de mise à jour attentivement et assurez-vous qu'il se termine avec succès pour toutes les bases de données.

Nettoyer le cache dédié aux habillages

Veuillez vous assurer que le répertoire skins/common/cache comporte des droits d'écriture pour l'utilisateur apache (selon votre distribution Linux ce peut être www-data, nobody, etc.)

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

Mettre à jour les règles Apache mod_rewrite

La version Itasca nécessite une règle mod_rewrite additionnelle pour supporter  les nouveaux dialogues de l'éditeur.  Modifiez votre configuration apache et assurez-vous d'avoir les règles suivantes :

      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]

Redémarrer Apache

/etc/init.d/apache2 restart

Redémarrer le serveur deki

/etc/init.d/dekihost restart

NOTE: Si vous exécutez Windows, exécutez le script mindtouch.host.bat au lieu de la commande ci-dessus

Etapes finales

Avant d'essayer d'ouvrir MindTouch Deki dans votre navigateur vous devrez effacer le cache du navigateur. Si des utilisateurs font état de problèmes avec la version mise à jour, demandez-leur de vider leur cache et de ré-essayer à nouveau. De façon inattendue, ceci résoudra de nombreux problèmes.

Aller ensuite dans MindTouch Deki avec votre navigateur et connectez-vous en tant qu'utilisateur ayant des privilèges d'administrateur. Allez dans Configuration/Paramétrage du site puis faites "Reconstruire index de recherche". Si vous avez plusieurs base de données wiki répétez ceci pour chacune d'entre elles.

Vérification

Il est conseillé de consulter votre MindTouch Deki mis à jour pour s'assurer que tout fonctionne correctement avant de laisser les utilisateurs faire des modifications.