Mettre à jour Lizmap Web Client

Upgrading from 3.0 to the 3.1 version

Depuis la version 3.0 et supérieur, voici comment faire la mise à jour

Sauvegarde des données

Sauvegardez vos données dans un répertoire (ex : /tmp) avec le script lizmap/install/backup.sh, afin que vous puissiez les réinstaller si l’installation échoue.

lizmap/install/backup.sh /tmp

Si vous voulez sauvegarder manuellement, vous devriez sauvegarder au moins ces fichiers :

var/jauth.db
var/logs.db
var/config/installer.ini.php
var/config/liveConfig.ini.php (si il existe)
var/config/lizmapConfig.ini.php
var/config/localconfig.ini.php
var/config/profiles.ini.php

Remplacez les fichiers Lizmap

Récupérez l’archive Lizmap (en téléchargeant une archive ou en effectuant un git clone/pull)

Vous devriez

remplacez le répertoire lib/ par le nouveau répertoire lib/
remplacez les fichiers dans le répertoire lizmap/ par les nouveaux fichiers dans lizmap/
Si le remplacement a effacé des fichiers que vous avez sauvegardé, restaurez-les avec « lizmap/install/restore.sh /tmp »

Démarrez l’installeur

Vous devez lancer le programme d’installation, il mettra à jour certaines choses: tables de base de données, configuration, etc.

sudo lizmap/install/clean_vartmp.sh
php lizmap/install/installer.php
sudo lizmap/install/clean_vartmp.sh

Upgrading from Lizmap 2.x to Lizmap 3.0

Tout d’abord, assurez vous que votre installation de Lizmap a bien été mise à jour vers la dernière version 2.x. La dernière version est 2.12.

Vous pouvez donc passer à Lizmap 3.0.

Sauvegarde des données

Sauvegardez vos données dans un répertoire (par exemple : /tmp).

Lizmap 2.12.2 et version supérieure ont un script lizmap/install/backup.sh. Lancez

lizmap/install/backup.sh /tmp

Si vous n’avez pas ce script, sauvegardez à la main, copiez ces fichiers quelque part, par exemple /tmp :

var/jauth.db
var/logs.db
var/config/lizmapConfig.ini.php
var/config/installer.ini.php
var/config/profiles.ini.php

Remplacez les fichiers Lizmap

Récupérez l’archive Lizmap (en téléchargeant une archive ou en effectuant un git clone/pull)

Vous devriez

remplacez le répertoire lib/ par le nouveau répertoire lib/
remplacez le répertoire lizmap/ par le nouveau répertoire lizmap/

Restaurer les données et nettoyer l’installation

Restaurer les droits et le propriétaire sur certains répertoires. Voici un exemple où « myuser » est l’utilisateur propriétaire du fichier d’application, et « www-data », le groupe du serveur web.

sudo lizmap/install/set_rights.sh www-data www-data
sudo lizmap/install/clean_vartmp.sh

Ensuite, vous pouvez restaurer la sauvegarde, en précisant le chemin où les fichiers sauvegardés ont été précédemment enregistrés :

lizmap/install/restore.sh /tmp

Note

Lizmap 3.x requires that *.db files should be stored in var/db/, not in var/ as in 2.x

Dernière étape : lancé le script de mise à jour

php lizmap/install/upgrade-to-3.php

Mettre à jour entre versions 2.x

Sauvegarde préalable

Avant de mettre à jour, faites une sauvegarde des données de configuration : lizmap/var/jauth.db and lizmap/var/config/lizmapConfig.ini.php et du fichier de log (à partir de la 2.8) lizmap/var/logs.db

MYAPP=lizmap-web-client
OLDVERSION=2.8.1 # replace by the version number of your current lizmap installation
# if you installation is 2.1.0 or less, use an empty OLDVERSION instead :
# OLDVERSION=
cp /var/www/$MYAPP-$OLDVERSION/lizmap/var/jauth.db /tmp/jauth.db # user database
cp /var/www/$MYAPP-$OLDVERSION/lizmap/var/config/lizmapConfig.ini.php /tmp/lizmapConfig.ini.php # text configuration file with services and repositories
cp /var/www/$MYAPP-$OLDVERSION/lizmap/var/logs.db /tmp/logs.db # lizmap logs

Puis faites une installation classique de la nouvelle version (voir ci-dessus), ce qui crééra un nouveau dossier dans le répertoire /var/www/

Copier les fichiers sauvegardés dans le dossier de la nouvelle version

$VERSION=2.10.3
cp /tmp/jauth.db /var/www/$MYAPP-$VERSION/lizmap/var/jauth.db
cp /tmp/lizmapConfig.ini.php /var/www/$MYAPP-$VERSION/lizmap/var/config/lizmapConfig.ini.php
cp /tmp/logs.db /var/www/$MYAPP-$VERSION/lizmap/var/logs.db

Note

Pour certaines versions, il est aussi nécessaire de mettre à jour la base de données qui stocke les droits. Voir les points suivants pour plus de détail.

De la version 2.3.0 ou inférieure à la 2.4.0 ou supérieure

Le framework Jelix (outil avec lequel est construit Lizmap Web Client) a été mis à jour. Il faut modifier la base de données sqlite de gestion des droits :

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_1.3_1.4.sql

De la version 2.6 ou inférieure à la version 2.7

Le support des annotations a été ajouté à Lizmap, ainsi que la gestion des droits liée. Il faut donc modifier la base de données des droits pour mettre à niveau :

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_lizmap_from_2.0_and_above_to_2.5.sql

De la version 2.7.* à la version 2.8

L’outil d’édition a remplacé l’outil d’annotation et nous avons ajouté des champs pour décrire chaque utilisateur Lizmap. Il faut mettre à jour la base de donnée de gestion des droits :

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_2.7_2.8.sql

De la version 2.8.* à la version 2.9

La fonctionnalité de filtrage des données des couches en fonction de l’utilisateur connecté nécessite l’ajout des droits liés dans la base de données des utilisateurs :

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_2.8_2.9.sql

De la version 2.9.* à la version 2.10

La fonctionnalité de filtrage des données des couches en fonction de l’utilisateur connecté nécessite l’ajout des droits liés dans la base de données des utilisateurs :

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_2.9_2.10.sql

Supprimer les fichiers temporaires de Jelix

rm -rf /var/www/$MYAPP-$VERSION/temp/lizmap/*

Redéfinir les droits sur les fichiers de l’application

cd /var/www/$MYAPP-$VERSION
chown :www-data temp/ lizmap/var/ lizmap/www lizmap/install/qgis/edition/ -R
chmod 775 temp/ lizmap/var/ lizmap/www lizmap/install/qgis/edition/ -R