Upgrade Lizmap Web Client

Upgrading from Lizmap 2.x

Upgrading from Lizmap 3.x versions

From 3.0 versions to upper, here is how to upgrade.

Data backup

Backup your data into a directory (ex: /tmp) with the lizmap/install/backup.sh script, so you could reinstall them if the installation failed.

lizmap/install/backup.sh /tmp

If you want to backup by hand, you should backup at least these files:

var/jauth.db
var/logs.db
var/config/installer.ini.php
var/config/liveConfig.ini.php (if it exists)
var/config/lizmapConfig.ini.php
var/config/localconfig.ini.php
var/config/profiles.ini.php

Replace lizmap files

Get the lizmap archive (by downloading an archive or by doing a git clone/pull)

You should

replace the lib/ directory by the new lib/ directory
replace files into lizmap/ directory by the new lizmap/ files
If the replacement has erased some files that you’ve been backuped, restore them with lizmap/install/restore.sh /tmp

Launch the installer

You have to launch the installer, it will upgrade some stuff: database tables, configuration etc..

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

Note

if you upgrade from 3.0 or 3.1 to Lizmap 3.2/3.3, and if you are using the ldap authentication with the ldapdao module, you have to know that this module is included into Lizmap 3.2/3.3 and is pre-configured. So, before launching the installer, you have to remove the ldapdao module you’ve installed, and you have to configure the ldapdao module in a little different manner than when installing it by hand. See the ldap configuration section in this manual.

Delete Jelix temporary files

rm -rf temp/lizmap/*

Redefine the rights to the application files

sudo chown :www-data temp/ lizmap/var/ lizmap/www lizmap/install/qgis/edition/ -R
sudo chmod 775 temp/ lizmap/var/ lizmap/www lizmap/install/qgis/edition/ -R