Aggiornare Lizmap Web Client

Aggiornare da Lizmap 2.x

Aggiornamento da versioni di Lizmap inferiori alla 3.5

Dovresti prima migrare alla 3.5. Vedi documentazione di Lizmap 3.5. Quindi potresti migrare alla 3.6.

Aggiornamento da Lizmap 3.5 con lo script di migrazione

A partire da Lizmap 3.6.2, esiste uno script lizmap/install/migrate_from_3_5.sh che aiuta molto nella migrazione da Lizmap 3.5. Manipola i file lizmap e aggiorna automaticamente alcuni moduli aggiuntivi.

Ottieni l’archivio Lizmap 3.6 scaricando un archivio nella pagina release.

Dovresti quindi rinominare la directory lizmap/ di Lizmap 3.5 in lizmap35.bak/ ad esempio:

mv lizmap lizmap35.bak

Quindi estrai la directory lizmap/ dall’archivio, in modo che diventi la nuova directory lizmap/.

Quindi avvia lizmap/install/migrate_from_3_5.sh fornendo il percorso della directory lizmap precedente. Esempio:

cd lizmap/install
./migrate_from_3_5.sh ../../lizmap35.bak

Quindi, puoi avviare il programma di installazione

php installer.php -v
sudo clean_vartmp.sh

Se non ci sono errori, dovresti vedere Lizmap 3.6 in azione nel tuo browser. Puoi quindi eliminare lizmap35.bak e lib/ (non c’è più una directory lib/ in Lizmap 3.6).

Se si verificano errori durante l’aggiornamento e non trovi una soluzione, elimina semplicemente la nuova directory lizmap e rinomina la vecchia directory lizmap.

mv lizmap lizmap36.bak
mv lizmap35.bak lizmap

Puoi utilizzare nuovamente Lizmap 3.5 o provare l’aggiornamento manuale descritto di seguito.

Aggiornamento manuale da Lizmap 3.5

Ecco come eseguire l’aggiornamento da Lizmap 3.5.

Backup dei dati

Esegui il backup dei dati e dei file di configurazione in una directory (es: /tmp) con lo script lizmap/install/backup.sh di Lizmap 3.5.

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/.

Aggiornamento di moduli aggiuntivi

Se hai installato alcuni moduli in lizmap/my-packages o in lizmap/lizmap-modules, devi aggiornarli. Probabilmente ci sono nuove versioni per Lizmap 3.6. Leggi la documentazione di questi moduli.

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.

Aggiornamento a una versione minore di Lizmap 3.6

Potrebbe essere rilasciata una nuova versione di Lizmap 3.6 (3.6.1, 3.6.2 ecc.). Dovresti aggiornare la tua istanza Lizmap 3.6 esistente per usufruire di miglioramenti e correzioni di bug.

Backup

Nel caso in cui l’aggiornamento fallisca, è consigliabile eseguire il backup dell’intera directory lizmap prima di fare qualsiasi cosa.

cp -a lizmap lizmap.bak

se l’aggiornamento fallisce, elimina la directory lizmap e avvia:

mv lizmap.bak lizmap

Sostituire i file di Lizmap

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

Puoi quindi estrarre la directory lizmap/ dall’archivio, sovrascriverà tutti i file, tranne lizmap/var/.

Avviare il programma di installazione

Devi avviare il configuratore (aggiornerà alcuni file di configurazione se necessario), 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

Ripristinare i diritti sui file, indicando l’utente web e il gruppo web utilizzato dal server web

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 puoi eliminare la vecchia directory lizmap.bak/.