Aggiornare Lizmap Web Client

Aggiornare da Lizmap 2.x

Vedere documentazione di Lizmap 3.1.

Aggiornamento dalle versioni 3.x di Lizmap

Da versioni 3.0 a successive, ecco come fare l’aggiornamento.

Backup dei dati

Fate un backup dei vostri dati in una directory (es: /tmp) con lo script lizmap/install/backup.sh, in modo da poterli reinstallare se l’installazione fallisse.

lizmap/install/backup.sh /tmp

Se volete fare il backup a mano, dovreste fare il backup almeno di questi file:

  • var/db/jauth.db
  • var/db/logs.db
  • var/config/installer.ini.php
  • var/config/liveConfig.ini.php (se esiste)
  • var/config/lizmapConfig.ini.php
  • var/config/localconfig.ini.php
  • var/config/profiles.ini.php

Sostituire i file di Lizmap

Recuperare l’archivio Lizmap (scaricando un archivio o facendo un git clone/pull)

Si dovrebbe

  • sostituire la directory lib/ con la nuova directory lib/
  • sostituire i file nella directory lizmap/ con i nuovi file lizmap/
  • Se la sostituzione ha cancellato alcuni file di cui hai fatto il backup, ripristinali con lizmap/install/restore.sh /tmp.

Avviare il programma di installazione

Dovete lanciare il programma di installazione, che aggiornerà alcune cose: tabelle del database, configurazione ecc.

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

Nota

se aggiornate da 3.0 o 3.1 a Lizmap 3.2/3.3, e se state usando l’autenticazione ldap con il modulo ldapdao, dovete sapere che questo modulo è incluso in Lizmap 3.2/3.3 ed è preconfigurato. Quindi, prima di lanciare l’installatore, dovete rimuovere il modulo ldapdao che avete installato, e dovete configurare il modulo ldapdao in un modo leggermente diverso da quando lo installate a mano. Vedi la sezione sulla configurazione di ldap in questo manuale.

Elimina i file temporanei Jelix

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

Ridefinire i diritti ai files dell’applicazione

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

Migrare da Sqlite a Postgresql

Potreste aver installato Lizmap con Sqlite. Dovresti quindi avere questi file lizmap/var/db/jauth.db e lizmap/var/db/logs.db, dove sono memorizzati alcuni dati come utenti, permessi e log. E dovresti avere questa configurazione in lizmap/var/config/profiles.ini.php:

[jdb:jauth]
driver=sqlite3
database="var:db/jauth.db"

[jdb:lizlog]
driver=sqlite3
database="var:db/logs.db"

Se avete una tale configurazione, potete migrare i dati in un database Postgresql.

Per prima cosa, create un database Postgresql, e poi cambiate la configurazione in lizmap/var/config/profiles.ini.php, impostando i parametri di accesso al database Postgresql. Si raccomanda di creare uno schema nel database, per esempio lizmap, se contiene già alcune tabelle.

Per esempio:

[jdb:jauth]
driver=pgsql
host=localhost
port=5432
database="your_database"
user=my_login
password=my_password
search_path=lizmap,public

[jdb:lizlog]
driver=pgsql
host=localhost
port=5432
database="your_database"
user=my_login
password=my_password
search_path=lizmap,public

Vedi il capitolo sull’installazione per saperne di più su questi parametri.

Poi puoi lanciare questi script che migreranno i dati.

php lizmap/scripts/script.php lizmap~database:migrateusers
php lizmap/scripts/script.php lizmap~database:migratelog

Se non ci sono errori, puoi andare su lizmap con il tuo browser, e controllare se puoi autenticarti. Dovresti vedere anche la lista degli utenti nel pannello di amministrazione. In questo caso, puoi fare un backup dei file jauth.db e logs.db e cancellarli.

Se qualcosa va storto e non puoi risolvere il problema, ripristina l’accesso al database in lizmap/var/config/profiles.ini.php come prima, in questo modo:

[jdb:jauth]
driver=sqlite3
database="var:db/jauth.db"

[jdb:lizlog]
driver=sqlite3
database="var:db/logs.db"

E Lizmap dovrebbe funzionare bene, ma sempre con Sqlite.