Installazione Lizmap Web Client su Windows

Nota

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

Questa documentazione mostra i passi necessari per installare Lizmap Web Client su un ambiente Windows 7 e Windows 10. Le altre versioni di Windows non dovrebbero essere un problema.

Nota

In questo documento, viene utilizzata la versione 3.3 di Lizmap Web Client. Assicuratevi di regolarvi in base alla versione che volete installare (la più recente è raccomandata).

Requisiti

• Editor di testo (per esempio Notepad++ , Visual Studio Code )

• Microsoft Visual C++ Redistributable 64-bits (questa installazione deve rispettare la versione di compilazione di Apache e PHP) ( Microsoft VCs C++ )

• Web Server (Apache 24 64-bits )

• PHP 7.3.10 (Non Thread Safe )

• QGIS Server 3 64-bits (OSGeo4W Network Installer (64 bit))

• Lizmap Web Client 3.x (Github Lizmap releases )

• Software FTP (per esempio Filezilla , WinSCP ) 64-bit (opzionale)

Configurazione del server Apache 2.4.41

Iniziate con la creazione di una cartella vicino a C:\‖ (per esempio **C:webserver). Dopodiché, scaricate Apache 64 bit e i suoi moduli. Al momento di questa documentazione, usiamo la versione compilata VC16.

Nota

Puoi usare altre installazioni di Apache, ma devi stare attento e installare correttamente i Microsoft Visual C++ Redistributable (per esempio VC15, VC16) e i loro moduli per una corretta installazione di Apache.

Estrai il file zip di Apache24 in C:webserver** e cambia il nome da **httpd-2.4.41-win64-VS16 a Apache24. Dopo di che decomprimi tutti i moduli e copia tutti i file .so nella cartella C:webserverApache24modules. Poi apri la configurazione di Apache in C:webserverApache24confhttpd.conf e modifica con un editor di testo e sostituisci la variabile globale ServerRoot in C:webserverApache24. Questa azione permetterà ad Apache di riconoscere il percorso di installazione di Apache.

Define SRVROOT "c:/webserver/Apache24" #Variable to define the root folder
ServerRoot "${SRVROOT}"

Lo scopo di usare la variabile SRVROOT è la sostituzione automatica di ${SRVROOT} per riconoscere il percorso che si definisce nel resto del file. Ora è il momento di vedere quale porta è «ascoltata» da Apache. Per impostazione predefinita, Apache usa la porta 80.

Nota

Se deve essere usata un’altra porta, per esempio 1664, aggiungere l’opzione Listen al file httpd.conf di Apache:

Listen 80 #Activated Default Apache port
#Listen 1664 Example port if default Apache port is taken

#You can activate or deactivate the ports using the # symbol

Dopo aver scelto la porta, è il momento di attivare i moduli di Apache nel file di configurazione. Per questa azione, è necessario modificare la configurazione di Apache in C:webserverApache24confhttpd.conf e abilitare i moduli che ti servono. Cercate le righe di comando LoadModule e poi deselezionate (rimuovete #) i seguenti moduli:

LoadModule fcgid_module modules/mod_fcgid.so
LoadModule actions_module modules/mod_actions.so
LoadModule ssl_module modules/mod_ssl.so
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule headers_module modules/mod_headers.so
LoadModule deflate_module modules/mod_deflate.so
LoadModule expires_module expires_module modules/mod_expires.so
LoadModule ext_filter_module modules/mod_ext_filter.so
LoadModule ident_module modules/mod_ident.so

Nota

Se è necessario utilizzare una porta diversa, allora è necessario attivare altri moduli associati al modulo proxy:

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so
LoadModule cache_module modules/mod_cache.so
LoadModule cache_disk_module modules/mod_cache_disk.so

Dopo questa sostituzione, cercate con Ctrl+F la variabile ServerName e aggiungete sotto le seguenti parole ServerName localhost. Continuando in questo file apparirà la DirectoryIndex index.html, si prega di sostituire con DirectoryIndex index.html index.php dopo questa azione salvate il file.

Avviare Apache aprendo la linea di comando con Windows+R, digitare cmd e nella linea di comando scrivere C:webserverApache24binhttpd.exe e non chiudere il cmd.

Avvertimento

È importante fare CLICK DESTRO nella linea di comando e «Esegui come amministratore» per avere accesso completo. Fatelo ogni volta che dovete usare il CMD.

Premendo Enter dopo l’istruzione nella linea di comando si aprirà un dialogo del firewall di Windows dove è necessario selezionare l’opzione Allow Access For all.

Usando un browser, scrivete http://localhost e premete invio, se tutto è andato bene nell’installazione questo aprirà la pagina con il testo «It Works «.

Avvertimento

Se non appaiono le finestre del firewall significa che probabilmente avete un software antivirus che gestisce il vostro firewall. In questo caso, è necessario controllare le configurazioni e consentire manualmente il servizio apache. Un altro consiglio importante è che se Windows Firewall non mostra la finestra di dialogo precedente è necessario aggiungere manualmente la porta 80 come porta in entrata/uscita nelle proprietà avanzate di Windows Firewall ( Pannello di Controllo > Strumenti di Amministrazione > Windows Firewall con Sicurezza Avanzata ).

Apri il cmd dove hai eseguito il comando precedente per avviare Apache e premi Ctrl+C per fermare Apache. Per aggiungere Apache nel percorso di sistema di Windows e avere accesso direttamente nel cmd è necessario tenere premuto Windows e cercare Edit System environments. Dopo aver cliccato nel risultato apparirà una finestra di dialogo con Variabili d'ambiente. Il prossimo passo è aggiungere (non sostituire!) ;C:webserverApache24bin alla variabile Path (doppio click sulla linea «Path»). Dopo questo passo, chiudi cmd, riapri cmd e controlla che Apache sia correttamente dichiarato nel Path del sistema. Per questo test, apri cmd e digita httpd, poi premi invio: questo farà partire Apache, se sì, fermati usando la combinazione di tasti Ctrl+C.

Adesso è ora di aggiungere Apache come Servizio, per questo passaggio devi aprire la linea di comando e scrivere httpd -k install. Partirà Apache come Servizio Windows.

Dopo aver testato con successo l’installazione di Apache, è il momento di aggiungere il resto delle configurazioni di Apache che serviranno il QGIS Server e il Lizmap Web Client. Aprire nuovamente il file di configurazione C:webserverApache24httpd.conf e aggiungere le seguenti linee alla fine del file:

<IfModule mod_deflate.c>
  SetOutputFilter DEFLATE
  BrowserMatch ^Mozilla/4 gzip-only-text/html
  BrowserMatch ^Mozilla/4\\.0[678] no-gzip
  BrowserMatch \\bMSIE !no-gzip !gzip-only-text/html
  SetEnvIfNoCase Request_URI \\.(?:gif|jpe?g|png|rar|zip)$ no-gzip dont-vary
  Header append Vary User-Agent env=!dont-vary
</IfModule>

Questa configurazione è importante per gestire la compressione dei file. Dopo questa configurazione riavvia Apache nella linea di comando di Windows usando il seguente comando httpd -k restart e premi Enter per ricevere la nuova configurazione. Ora è il momento di preparare le configurazioni che serviranno la versione php. Iniziate con la creazione di un file di configurazione Apache per usare la configurazione PHP in **C:webserverApache24confextra** con il nome di php73.conf. Questo può essere fatto se aprite un editor di testo (ad esempio Notepad++, Visual Studio Code, ecc.) e lo salvate con il seguente codice:

FcgidInitialEnv PHPRC "C:\webserver\php73"
 <FilesMatch \.php$>
  AddHandler fcgid-script .php
  FcgidWrapper "C:/webserver/php73/php-cgi.exe" .php
 </FilesMatch>


 FcgidInitialEnv PHPRC "C:\\webserver\\php73"

 FcgidInitialEnv PATH "C:\OSGeo4W64\bin;C:\OSGeo4W64\apps\qgis-ltr\bin;C:\OSGeo4W64\apps\Qt5\bin;C:\OSGeo4W64\apps\grass\grass-6.4.3\lib;C:\OSGeo4W64\apps\grass\grass-6.4.3\bin;C:\Windows\system32;C:\Windows;C:\Windows\System32\WBem"
 FcgidInitialEnv QT_PLUGIN_PATH "C:\OSGeo4W64\apps\qgis-ltr\qtplugins;C:\OSGeo4W64\apps\Qt5\plugins"
 FcgidInitialEnv PYTHONHOME "C:\OSGeo4W64\apps\Python37"
 FcgidInitialEnv PYTHONPATH "C:\OSGeo4W64\apps\qgis-ltr\.\python;C:\OSGeo4W64\apps\qgis-ltr\.\python\plugins;C:\OSGeo4W64\apps\Python37\DLLs;C:\OSGeo4W64\apps\Python37\lib;C:\OSGeo4W64\bin;C:\OSGeo4W64\apps\Python37;C:\OSGeo4W64\apps\Python37\lib\site-packages"

 FcgidInitialEnv QGIS_SERVER_LOG_LEVEL 0
 FcgidInitialEnv QGIS_SERVER_LOG_FILE "C:\webserver\Apache24\logs\qgis_server.log"

 FcgidIOTimeout 120
 FcgidInitialEnv LC_ALL "en_US.UTF-8"
 FcgidInitialEnv PYTHONIOENCODING UTF-8
 FcgidInitialEnv LANG "en_US.UTF-8"
 FcgidInitialEnv QGIS_DEBUG 1
 FcgidInitialEnv QGIS_SERVER_LOG_FILE "C:\webserver\Apache24\logs\qgis_server.log"
 FcgidInitialEnv QGIS_SERVER_LOG_LEVEL 0
 FcgidInitialEnv QGIS_PLUGINPATH "C:\OSGeo4W64\apps\qgis-ltr\python\plugins"

 SetEnvIf Request_URI ^/qgis QGIS_PREFIX_PATH "C:\OSGeo4W64\apps\qgis-ltr"
 SetEnvIf Request_URI ^/qgis TEMP "C:\Windows\Temp"

 SetEnvIf Request_URI ^/qgis GDAL_DATA "C:\OSGeo4W64\share\gdal"
 SetEnvIf Request_URI ^/qgis GDAL_DRIVER_PATH "C:\OSGeo4W64\bin"
 SetEnvIf Request_URI ^/qgis PDAL_DRIVER_PATH "C:\OSGeo4W64\bin"
 SetEnvIf Request_URI ^/qgis GDAL_SKIP "JP2ECW"
 SetEnvIf Request_URI ^/qgis PROJ_LIB "C:\OSGeo4W64\share\proj"

 <FilesMatch \.php$>
  AddHandler fcgid-script .php
  FcgidWrapper "C:/webserver/php73/php-cgi.exe" .php
 </FilesMatch>

Nota

Assicurati di avere l’estensione .conf in questo file.

Andate nel file C:webserverApache24confhttpd.conf e decommentate la linea Include confextrahttpd-vhosts.conf e salvate il file. Questa azione permetterà di utilizzare le nostre configurazioni di host virtuali nel file C:webserverApache24confextrahttpd-vhosts.conf. Includete i vhosts per creare le nuove configurazioni di host virtuali nel file C:webserverApache24confextrahttpd-vhosts.conf. Potete commentare o cancellare i due esempi all’interno (approssimativamente tra le linee 23 e 38). Se aggiungete il commento negli esempi predefiniti, copiate e incollate le prossime configurazioni dopo (il commento o le parti precedenti cancellate):

<VirtualHost *:80>
  Include conf/extra/php73.conf #include the diretory conf file for php73 configuration
  ServerName localhost # name of the server, in this case is localhost

  DocumentRoot "C:/webserver/lizmap/" #Path to the root document Directory
  <Directory "C:/webserver/lizmap">
      Options -Indexes +FollowSymLinks +ExecCGI
      AllowOverride All
      Require all granted
  </Directory>

  CustomLog "logs/lizmap-access.log" common
  ErrorLog "logs/lizmap-error.log"

  <IfModule mod_fcgid.c>
                RewriteEngine on
                RewriteCond %{HTTP:Authorization} .
                RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
  </IfModule>

  #Parameters for maximum requests and timeout connections of fgci module
        <IfModule fcgid_module>
                FcgidMaxRequestLen 51200000
                FcgidConnectTimeout 60
  </IfModule>

</VirtualHost>

Dopo questo passo salvate il file.

Avvertimento

La configurazione precedente ci aiuterà a controllare se apache è configurato correttamente. Il medesimo file sarà utilizzato per incrementare il resto delle modifiche durante l’installazione. Nella sezione Preparare la home di Lizmap Web Client questa configurazione sarà modificata per ricevere due ambienti.

php 7.3.10 Configurazione

Avvertimento

Il client web Lizmap è basato sul framework PHP Jelix. Devi installare almeno la versione 7 di PHP per avere tutte le funzionalità. Le estensioni dom, simplexml, pcre, session, tokenizer e spl sono richieste (sono generalmente attivate in un’installazione standard di PHP 7.x)

Per questa installazione usiamo il PHP 7.3.10, se avete installato la versione precedente del Microsoft Visual C++ Redistributable for Apache della presente documentazione, non avete bisogno di installare di nuovo. Vai su PHP binaries e scarica il link con il nome Zip, assicurati che sia il file non-thread-safe.

Dopo il download create una cartella in C:webserver** con il nome php73 e scompattate i file in essa. Andate al file **C:webserverphp73php.ini-production e cambiatelo in C:webserverphp73php.ini. Aprite il file php.ini e cercate la direttiva Extension Dir e cambiate per localizzare correttamente la cartella EXT, assicuratevi di inserire il percorso completo come questo extension_dir = «C:webserverphp73ext «. Ora è il momento di attivare i moduli php, per questo compito è necessario decommentare le seguenti linee:

extension=php_curl.dll
extension=php_fileinfo.dll
extension=php_gd2.dll
extension=php_mbstring.dll
; driver for PostgreSQL
extension=php_pdo_pgsql.dll
; driver for SQLite
extension=php_pdo_sqlite.dll
; driver for PostgreSQL
extension=php_pgsql.dll
; driver for SQLite3
extension=php_sqlite3.dll

Dopo l’attivazione delle estensioni php, nello stesso file cambiate i valori di upload dal valore di default a 15M e rimarrà come upload_max_filesize = 15M. Per favore, fate lo stesso per post_max_size e cambiate dal valore di default a post_max_size = 15M e salvate le modifiche nel file. Prima di chiudere questo file, create una cartella con il nome sessions in C:webserver e aggiungete il seguente percorso:

; The path can be defined as:
;
session.save_path = "C:\webserver\sessions"
;

Aggiungete il PHP al vostro Windows System Path che vi permetterà di chiamare apache direttamente nel cmd. Per fare ciò, tenete premuto il tasto Windows e premete Pause. Poi, cliccate su Impostazioni avanzate di sistema e poi su Variabili d'ambiente. Il prossimo passo è aggiungere (non sostituire!) il percorso ;C:webserverphp-7.3 alla variabile Path (doppio click sulla linea «Path»). Dopo questo passo, chiudete cmd, riaprite cmd e controllate che PHP sia correttamente dichiarato nel Percorso di sistema usando cmd e digitando php -m Ora controllate la configurazione di Apache con httpd -S.

Create una cartella con il nome lizmap all’interno di C:webserverlizmap aggiungete un file con estensione .php e salvate con questo codice all’interno del file:

<?php phpinfo(); ?>

Riavviare Apache da linea di comando con httpd -k restart e vedere se tutto è a posto. Se SI, aprite il browser e digitate http://localhost/index.php e apparirà la pagina delle proprietà di PHP si presume che avete installato correttamente il PHP.

QGIS Server Installazione

Andate su https://www.qgis.org/en/site e prendete il file Osgeo4W Network installer (64 bit) ed eseguite il programma di installazione. Scegliete le seguenti opzioni:

1. Installatore avanzato;

2. Installa da internet;

3. Root Directory C:OSGeo4W64 e installare per tutti gli utenti;

4. Mantenere la directory locale dei pacchetti e il nome del menu di avvio predefiniti;

5. Non configurare il proxy se non è necessario;

6. Scegliete un sito di download (per esempio https://download.osgeo.org );

7. Seleziona i pacchetti: command line_Utilities/gdal, Desktop/QGIS full, Web/QGIS server, lib/fcgi poi Next (Noi usiamo, per scopi stabili, la versione QGIS LTR);

8. Accettare affinché i pacchetti soddisfino le dipendenze: Next poi Attendere che il download sia completato e Accettare tutte le licenze.

Nota

Questo processo può durare tanto (~ 1 ora).

Dopo l’installazione abbiamo bisogno di configurare QGIS Server affinché sia accessibile come fcgi, quindi è necessario modificare il precedente file degli host virtuali nella directory C:webserverApache24confextrahttpd-vhosts.conf per avere questo contenuto:

<VirtualHost *:80>
  Include conf/extra/php73.conf
  ServerName localhost # name of the server, in this case is localhost

  DocumentRoot "C:/webserver/lizmap/" #Path to the root document Directory
  <Directory "C:/webserver/lizmap">
      Options -Indexes +FollowSymLinks +ExecCGI
      AllowOverride All
      Require all granted
  </Directory>

  # Added QGIS Server Folder
  Alias /qgis/ "C:/OSGeo4W64/apps/qgis-ltr/bin/"
  <Directory "C:/OSGeo4W64/apps/qgis-ltr/bin/">
      SetHandler fcgid-script
      Options +ExecCGI
      AllowOverride All
      Require all granted
  </Directory>

  CustomLog "logs/lizmap-access.log" common
  ErrorLog "logs/lizmap-error.log"

  <IfModule mod_fcgid.c>
                RewriteEngine on
                RewriteCond %{HTTP:Authorization} .
                RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
  </IfModule>

  #Parameters for maximum requests and timeout connections of fgci module
        <IfModule fcgid_module>
    FcgidMaxRequestLen 51200000
    FcgidConnectTimeout 60
  </IfModule>

</VirtualHost>

Dopo le modifiche riavviate apache, digitate nella riga di comando l’istruzione:

httpd -k restart

Ora è il momento di testare il server QGIS e vedere se è accessibile in fcgi digitando nel browser il seguente link: http://localhost/qgis/qgis_mapserv.fcgi.exe e se tutto è giusto riceverete la seguente risposta:

<ServiceExceptionReport version="1.3.0">
   ServiceException code="OperationNotSupported">Please check the value of the REQUEST parameter</ServiceException>
</ServiceExceptionReport>

Preparare la home di Lizmap Web Client

È utile avere 2 ambienti, uno per la produzione e l’altro per la preproduzione (o master per testare nuove funzionalità), per questa azione avrete bisogno di creare le cartelle **C:webserverlizmapprodd** e **C:webserverlizmappreprodd** e cambiare il file di configurazione Apache VirtualHost.

Per prima cosa, vai su 3Liz Target del repository Github e scarica l’ultima versione in formato ZIP. Per esempio, puoi usare Lizmap-web-client 3.3.4 per la cartella prod.

Ogni ambiente avrà una versione in parallelo. Per esempio: release_3_3 e master. Per questo devi decomprimere in C:webserverlizmapprod la versione release_3_3 e C:webserverlizmappreprod la versione master. Poi puoi creare una directory dove metterai la cache delle tile per l’ambiente di produzione C:webservercacheprod e per l’ambiente master C:webservercachepreprod. Dopo aver creato le cartelle della cache, modificate l’host virtuale per puntare alle cartelle www dell’applicazione lizmap web client per ogni ambiente. Vai al file **C:webserverApache24confextrahtpd-vhosts.conf e modifica la seguente configurazione:

# example configuration in httpd-vhosts.conf
<VirtualHost *:80>
Include conf/extra/php73.conf
ServerName localhost

# Lizmap Production
# Version 3_3
Alias /webgis/ "C:/webserver/lizmap/prod/release_3_3/lizmap/www/"
<Directory "C:/webserver/lizmap/prod/release_3_3/lizmap/www">
    Options -Indexes +FollowSymLinks +ExecCGI
    AllowOverride All
    Require all granted
</Directory>

# Lizmap Pre-production (master)
# Version master
Alias /preprod/ "C:/webserver/lizmap/preprod/master/lizmap/www/"
<Directory "C:/webserver/lizmap/preprod/master/lizmap/www">
    Options -Indexes +FollowSymLinks +ExecCGI
    AllowOverride All
    Require all granted
</Directory>

Alias /qgis/ "C:/OSGeo4W64/apps/qgis-ltr/bin/"
<Directory "C:/OSGeo4W64/apps/qgis-ltr/bin/">
    SetHandler fcgid-script
    Options +ExecCGI
    AllowOverride All
    Require all granted
</Directory>

CustomLog "logs/lizmap-access.log" common
ErrorLog "logs/lizmap-error.log"

# ABP: needed for authentication in Lizmap
<IfModule mod_fcgid.c>
    RewriteEngine on
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
</IfModule>

<IfModule fcgid_module>
    FcgidMaxRequestLen 51200000
    FcgidConnectTimeout 60
</IfModule>

</VirtualHost>

Dopo la sostituzione salvate il file e riavviate Apache con le istruzioni della linea di comando:

httpd -k restart

In caso di versione di lizmap >= 3.0, è necessario utilizzare alcuni script per installarlo correttamente (vedi https://github.com/3liz/lizmap-web-client/blob/master/INSTALL.md ). Aprire la linea di comando (cmd.exe) e scrivere le prossime istruzioni:

REM Production folder
cd C:\webserver\lizmap\prod\release_3_3\
cd lizmap\var\config
copy lizmapConfig.ini.php.dist lizmapConfig.ini.php
copy localconfig.ini.php.dist localconfig.ini.php
copy profiles.ini.php.dist profiles.ini.php
cd ..\..\..

REM PreProd (Master) folder
cd C:\webserver\lizmap\preprod\master\
cd lizmap\var\config
copy lizmapConfig.ini.php.dist lizmapConfig.ini.php
copy localconfig.ini.php.dist localconfig.ini.php
copy profiles.ini.php.dist profiles.ini.php
cd ..\..\..

Se volete abilitare i repository demo in entrambi gli ambienti, prima di questa installazione dovete aggiungere al file localconfig.ini.php in entrambi gli ambienti il seguente codice:

[modules]
lizmap.installparam=demo

Usare PostgreSQL come database di amministrazione (Opzionale)

Nota

Requisiti: Installazione PostgreSQL/PostGIS

Per impostazione predefinita, quando si installa Lizmap Web Client, verrà installato un database sqlite dove verranno memorizzate le informazioni sugli utenti, i permessi e altre informazioni.

Immagina che tu sia il GIS Manager e che tu voglia legare le credenziali user e password di lizmap alle credenziali user e password degli utenti PostgreSQL.

Per questo prima dell’installazione di LWC è necessario cambiare il file profiles.ini.php nella cartella di entrambi gli ambienti nella cartella C:webserverlizmapprodrelease_3_3lizmapvarconfig (cartella di produzione) e C:webserverlizmappreprodmasterlizmapvarconfig (cartella di pre-produzione) con le seguenti linee:

default=jauth
jacl2_profile=jauth

Aggiungi ; per disattivare il database sqlite.

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

;[jdb:lizlog]
;driver=sqlite3
;database="var:db/logs.db"
; when you have charset issues, enable force_encoding so the connection will be
; made with the charset indicated in jelix config
;force_encoding = on

; with the following parameter, you can specify a table prefix which will be
; applied to DAOs automatically. For manual jDb requests, please use method
; jDbConnection::prefixTable().
;table_prefix =

Togli ; ed immetti le credenziali PostgreSQL:

;Example of different driver (e.g PostgreSQL)
[jdb:jauth]
driver="pgsql"
database="name_of_database"
host="localhost"
user="Admin_user_postgreSQL"
password="put_here_the_password"

[jdb:lizlog]
driver="pgsql"
database="name_of_database"
host="localhost"
user="Admin_user_postgreSQL"
password="put_here_the_password"


; Example for pdo (eg. MySQL):
;driver=pdo
;dsn=mysql:host=your_host;dbname=name_of_database
;user=
;password=

Dopo tutte le tue precedenti modifiche sei pronto a lanciare il programma di installazione di lizmap per entrambi gli ambienti nella linea di comando (cmd):

REM Production Lizmap
cd C:\webserver\lizmap\prod\release_3_3\
php lizmap\install\installer.php

REM PreProduction Lizmap
cd C:\webserver\lizmap\prod\master\
php lizmap\install\installer.php

Configurare il pannello di amministrazione di Lizmap

[PROD] Ambiente di produzione ( webgis )

Dopo la corretta installazione con il programma di installazione, andate su http://localhost/webgis/index.php e dovreste vedere la home page dell’applicazione Lizmap con il progetto demo Montpellier - Transport. Ora è il momento di configurare il pannello di amministrazione di Lizmap, andate su http://localhost/webgis/admin.php e fate il login con:

• user=admin;

• password=admin;

Poi, per motivi di sicurezza, cambiate la password dell’amministratore, per esempio: lizmap_12345. Se ha senso, puoi cancellare gli utenti lizadmin e logintranet. Potete fare lo stesso per i gruppi, in questo caso cancellare il gruppo Intranet Demo Group e il gruppo Lizadmin.

Andare nel menu di configurazione di Lizmap > Cancellare il repository «intranet» (in basso). Poi è necessario cambiare la URL WMS Server, andare nel menu di configurazione di Lizmap / Modificare il modulo Servizi e cambiare l’URL WMS Server da: http://127.0.0.1/cgi-bin/qgis_mapserv.fcgi a http://localhost/qgis/qgis_mapserv.fcgi.exe Dopo di che, cambiare anche la directory della cache da C:\Windows\Temp\ a: **C:\webserver\cache\prod\ e salvare questa configurazione.

Ora controllate che il progetto demo di Montpellier funzioni: http://localhost/webgis/index.php/view/map/?repository=montpellier&project=montpellier

[PREPROD] Ambiente di pre-produzione ( preprod )

Dopo la corretta installazione con l’installer, andate su http://localhost/preprod/index.php e dovreste vedere la home page dell’applicazione Lizmap con il progetto demo Montpellier - Transport. Ora è il momento di configurare il pannello di amministrazione di Lizmap, andate su http://localhost/preprod/admin.php e fate il login con:

• user=admin;

• password=admin;

Poi, per motivi di sicurezza, cambiate la password dell’amministratore, per esempio: lizmap_12345. Se ha senso, puoi cancellare gli utenti lizadmin e logintranet. Potete fare lo stesso per i gruppi, in questo caso cancellare il gruppo Intranet Demo Group e il gruppo Lizadmin.

Andare nel menu di configurazione di Lizmap > Cancellare il repository «intranet» (in basso). Poi è necessario cambiare la URL WMS Server, andare nel menu di configurazione di Lizmap / Modificare il modulo Servizi e cambiare l’URL WMS Server da: http://127.0.0.1/cgi-bin/qgis_mapserv.fcgi a http://localhost/qgis/qgis_mapserv.fcgi.exe Dopo di che, cambiare anche la directory della cache da **C:WindowsTemp** a: **C:webservercachepreprode salvare questa configurazione.

Ora controllate che il progetto demo di Montpellier funzioni: http://localhost/preprod/index.php/view/map/?repository=montpellier&project=montpellier

Configurazione delle directory Lizmap

È necessario creare un’architettura di directory Lizmap per scopi organizzativi. Creare le seguenti directory tramite un file *.bat ( Si prega di controllare che il fine linea sia corretto, si può aprire usando notepad, notepad++):

REM common folder for both environments
mkdir C:\webserver\data\common\
REM common folder to publish SVG and images files in QGIS Server
mkdir C:\webserver\data\document\

REM directory of prod data
mkdir C:\webserver\data\prod\
REM common folder between rep in production environment
mkdir C:\webserver\data\prod\common\
mkdir C:\webserver\data\prod\rep1\
mkdir C:\webserver\data\prod\rep1\media\
mkdir C:\webserver\data\prod\rep1\media\js\
mkdir C:\webserver\data\prod\rep2\
mkdir C:\webserver\data\prod\rep2\media\
mkdir C:\webserver\data\prod\rep2\media\js\

REM directory of preprod data
mkdir C:\webserver\data\preprod\
REM common folder between rep in preprod (master) environment
mkdir C:\webserver\data\preprod\common\
mkdir C:\webserver\data\preprod\rep1\
mkdir C:\webserver\data\preprod\rep1\media\
mkdir C:\webserver\data\preprod\rep1\media\js\
mkdir C:\webserver\data\preprod\rep2\
mkdir C:\webserver\data\preprod\rep2\media\
mkdir C:\webserver\data\preprod\rep2\media\js\

Ora abbiamo bisogno di ottenere l’accesso alla cartella C:webserverdataprod e le sue sottocartelle in modo che l’amministratore GIS possa inviare i file del progetto QGIS, il file di configurazione Lizmap per ogni progetto, i dati GIS in queste cartelle e altri documenti. Andare al pannello di amministrazione di Lizmap in http://localhost/admin.php e creare il nuovo repository. Seguire questi passi:

• Configurazione di Lizmap / Creare un nuovo repository ( bottone in fondo alla pagina)

• id = rep1

• label = Un’etichetta del repository ( potrete cambiarla in seguito)

• path = /webserver/data/prod/rep1/

Nota

IMPORTANTE PER IL PERCORSO DEL REPOSITORY -> NON USARE: C:\webserver\data\prod\rep1

In Apache è necessario aggiungere un vhost per pubblicare file SVG e immagini via HTTP questo eviterà il bug in QGIS Server sotto Windows che non può visualizzare l’icona SVG quando si ha un percorso relativo. In precedenza avete creato una cartella C:webserverdatadocument** e ora è necessario modificare il file **C:webserverApache24confextrahttpd-vhosts.conf, aggiungendo la seguente directory:

#Add this configuration before of the two environments directories.
Alias /document/ "C:/webserver/data/document/"
<Directory "C:/webserver/Data/document">
    Options -Indexes +FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Dopo questo passaggio salvate e riavviate Apache. Controllate se potete aggiungere il file svg in una cartella, per esempio C:webserverDatadocumentsvgmio_icon.svg e poi accedervi tramite http://localhost/webgis/document/svg/my_icon.svg ed usarlo come percorso SVG nelle proprietà di stile di un livello vettoriale.

FTP Server Configurazione (es. Filezilla)

Questa configurazione si applica solo se state usando un server remoto.

Ora configurerete un FTP per avere un accesso remoto e distribuire in modo semplice nel server i progetti qgis e i loro elementi. Per prima cosa dovete scaricare il server FTP. Poi installare la configurazione di default nel server.

Nota

Non dimenticare di «Eseguire con diritti di amministratore «.

1. Specificare la Porta: 14147 .

2. Aprite l’interfaccia di FileZilla Server attraverso Windows Menu > Tutti i programmi > FileZilla Server > FileZilla Server Interface e cliccate OK per connettervi (non è ancora richiesta la password).

3. Modificate alcune opzioni tramite il menu Modifica > Impostazioni e cambiate il filtro IP se necessario: per filtrare solo alcuni IP, usate «*» nel primo blocco, e aggiungete la maschera nel secondo blocco.

4. Impostazioni modalità passiva > Usa il seguente IP: scrivi il tuo IP pubblico e cambia l’intervallo delle porte: 5500-5700.

5. Logging: Abilita la registrazione su file e limita la dimensione del file di log a 500 KB.

6. Impostazioni SSL/TLS: Abilita FTP su SSL/TLS && Genera un nuovo certificato in C:webservercertftp_certificate.crt && Permetti FTP esplicito su TLS && Disabilita FTP semplice non criptato && Lascia port 990.

7. Autoban - Abilita con i valori predefiniti.

8. Creare un utente: Edit > Users - bottone Add user= lizmap_user e pass= choose_a_password

9. Cartella condivisa (Accesso all’ambiente PROD e PREPROD): Aggiungere C:webserverlizmap - Dare tutti i diritti spuntando le caselle di controllo per File e Directory.

10. Si può aggiungere un filtro IP anche qui, se necessario.

Dopo la configurazione remota, nella postazione del gestore GIS si può riprodurre la struttura delle cartelle in modo che sia esattamente la stessa del remoto per facilitare la gestione della cartella. Dopo di che, è necessario installare un client FTP vedere la sezione requisiti-etichetta. Un’altra cosa, è necessario un certificato client prodotto dal remoto nel gestore GIS. Dopo di che provate a connettervi con: Server = IP remoto. Usare la modalità passiva E controllare IPV6.

Nota

Potete vedere questo tutorial (solo in francese): https://forum.hardware.fr/hfr/WindowsSoftware/Tutoriels/filezilla-serveur-securise-sujet_300273_1.htm