Aggiornare Lizmap Web Client

Aggiornare da Lizmap 2.x

Aggiornamento da versioni di Lizmap inferiori alla 3.5

Si deve prima effettuare la migrazione a 3.5. Vedere la documentazione di Lizmap 3.5 <https://docs.lizmap.com/3.5/en/install/upgrade.html>`_. Quindi è possibile eseguire la migrazione a 3.7

Aggiornamento da Lizmap 3.5 o versione 3.6

Ecco come eseguire l’aggiornamento da Lizmap 3.5 o 3.6

Backup dei dati

Eseguire il Backup dei dati di configurazione e file in una directory (es: /tmp) tramite lo script lizmap/install/backup.sh di Lizmap 3.5 o 3.6.

lizmap/install/backup.sh /tmp

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

var/db/jauth.db (se è esistente)
var/db/logs.db (se è esistente)
var/config/installer.ini.php
var/config/liveConfig.ini.php
var/config/localframework.ini.php (se è esistente)
var/config/lizmapConfig.ini.php
var/config/localconfig.ini.php
var/config/profiles.ini.php

Sostituire i file di Lizmap

Si può scaricare l’archivio Lizmap dalla pagina_`release <https://github.com/3liz/lizmap-web-client/releases>`.

Si dovrebbe quindi :

rinominare la directory lizmap/ in lizmap.bak/, ad esempio
estrai la directory lizmap/ dall’archivio, quindi diventerà la nuova directory lizmap/.
esegui lo script lizmap/install/restore.sh /tmp o reinstalla manualmente i file di cui hai eseguito il backup.

Nota: non esiste più una directory lib/.

Avviare il programma di installazione

Devi lanciare il configuratore (aggiornerà alcuni file di configurazione), e poi il programma di installazione, che aggiornerà alcune cose: tabelle del database, dati ecc..

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

Pulizia e test

Dovresti quindi eliminare tutta la cache e i file temporanei:

sudo lizmap/install/clean_vartmp.sh

Quindi dovresti eseguire lo script che imposta i diritti sui file. I parametri sono l’utente web e il gruppo web utilizzato dal server web per eseguire Lizmap. Su un server Debian, spesso sono www-data.

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

Quindi carica Lizmap nel tuo browser, dovresti vedere le tue mappe senza errori.

In questo caso è possibile eliminare le vecchie directory lib/ e lizmap.bak/.

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/console.php database:migrateusers
php lizmap/console.php 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.