Requisiti necessari a priori per installare Lizmap Web Client

Nota

Se vuoi installare e testare velocemente Lizmap Web Client in pochi passi, puoi seguire queste istruzioni.

QGIS Server

Avvertimento

Prima di installare la parte QGIS Server, è altamente consigliato di usare la stessa versione tra QGIS Desktop e QGIS Server.

Anche se alcune funzioni potrebbero funzionare, c’è la probabilità che qualche configurazione non funzioni se queste due versioni sono differenti.

La ragione è che QGIS Server versione X potrebbe non essere compatibile con un progetto QGIS fatto con un QGIS Desktop versione Y.

Seguire la documentazione di QGIS su come installare QGIS Server: https://docs.qgis.org/latest/en/docs/server_manual/

Usando un webserver (Apache o Nginx), dovete installare QGIS Server. Con Nginx, il modo migliore è usare spawn-fcgi. Non non usare il fcgiwrap, questa soluzione non è efficiente.

Nella configurazione di Nginx, è bene usare la variabile QGIS_OPTIONS_PATH per una cartella con permessi di scrittura per www-data. Questo è spiegato nella documentazione del server QGIS.

Dovresti anche installare e configurare XVFB menzionato nella Documentazione QGIS. Questo è utile per stampare i PDF. Puoi saltare questa sezione solo se non hai intenzione di stampare PDF sul lato server.

Dopo aver impostato il vostro server web con QGIS-Server, controllate che l’URL di QGIS Server funzioni. Probabilmente otterrete un XML come:

<ServerException>Project file error</ServerException>

Conservate questo URL, lo useremo più tardi nel pannello di amministrazione di Lizmap.

Avvertimento

Noi raccomandiamo vivamente di impostare il QGIS Server su un host virtuale diverso dal Lizmap Web Client. L’URL del QGIS Server dovrebbe rimanere privato, accessibile solo dall’applicazione PHP Lizmap soltanto.

Altrimenti, specialmente dopo l’installazione del plugin Lizmap su QGIS Server, il vostro utente potrebbe essere in grado di accedere a dati privati se bypassano Lizmap, usando direttamente l’URL di QGIS Server.

QGIS Server plugins

Alcuni plugin possono essere aggiunti a QGIS Server. Questo abiliterà alcune funzioni in Lizmap. Non è obbligatorio, ma in alcune situazioni è utile.

Si dovrebbe impostare la variabile d’ambiente QGIS_PLUGIN_PATH durante l’installazione di QGIS Server o usare quella di default fornita da QGIS. https://docs.qgis.org/latest/en/docs/server_manual/config.html#environment-variables

Suggerimento

Per gestire i plugin di QGIS Server, vi incoraggiamo ad usare qgis-plugin-manager, uno strumento CLI per installare e aggiornare i plugin. https://pypi.org/project/qgis-plugin-manager/

PostgreSQL

PostgreSQL può essere usato per due scopi diversi in Lizmap:

  • Per memorizzare i dati GIS. Nessuna configurazione è necessaria sul lato server di Lizmap Web Client, soltanto il server PostgreSQL deve essere accessibile dal server Lizmap Web Client. E” possibile modificare i livelli con Lizmap, ma il livello deve essere memorizzato in PostgreSQL. Vedere Prerequisiti.

  • Per memorizzare gli utenti di Lizmap Web Client e le azioni degli utenti. Lizmap utilizza delle tabelle. Questa impostazione deve essere fatta durante l”installazione di Lizmap.