Introduzione

A Febbraio del 2006 – tantissimo tempo fa … – ho scritto un piccolo post sull’installazione di MapServer in ambiente Windows su un sistema in cui fosse già installato un webserver (Apache in particolare).

E’ stato un post che ha ricevuto molte letture, ma che ha anche subito qualche “legnata tecnologica”. Lo avevo scritto infatti non dentro il motore di questo blog (WordPress), ma dentro Writely.
Cosa è Writely? E’ nientepopodimeno che l’applicazione online su cui è basato l’editor di testo di Google Docs, comprata per l’appunto da Google proprio in quell’anno.
Ho scritto l’articolo, ho inserito anche delle immagini d’aiuto alla comprensione del testo, ed ho pubblicato tutto su questo blog con un click; il testo è stato contestualmente archiviato sui server di TANTO, mentre le immagini sono rimaste sui server di Writely. Questi non sono stati spenti subito e, per diverso tempo, questo vecchio glorioso articolo non ha subito alcuna conseguenza dal passaggio di Writely a Google. Spenti i server, sono sparite le immagini ed in qualche modo anche la leggibilità del post in oggetto. Ho provato a ripescarle dall’Internet Archive Wayback Machine, ma senza fortuna.

In ogni caso dovevo rimediare da tempo. Avevo rimosso dalla memoria il problema (sorry ), e un commento recente mi ha messo nuovamente davanti alla cruda realtà (grazie riccardo). L’articolo inoltre è datato anche nei contenuti, e valeva la pena dargli una rinfrescata.

MapServer su Windows

Installare MapServer è cosa semplice in qualsiasi ambiente (forse il massimo è su Linux); può sembrare meno semplice farlo su server in produzione con diversi servizi già installati e configurati, specie se vogliamo usare degli installer grafici e magari chiudere gli occhi.

I file binari per Windows sono contenuti in questi tre pacchetti:

• OSGeo4W
• MS4W
• FWTools

In questa guida sfrutteremo FWTools, di cui abbiamo parlato diverse volte.

Installazione passo passo di MapServer

Il prerequisito è quello di installare e scaricare FWTools per Windows dal sito ufficiale, e poi lanciarne l’installazione. Io di solito lo faccio scegliendo le opzioni visibili in figura.

I file vengono estratti di default nella cartella “C:\Programmi\FWToolsx.x.x“. L’eseguibile di MapServer – mapserv.exe – è uno dei file a corredo di FWTools e lo troverete nella cartella “C:\Programmi\FWToolsx.x..x\bin“.
Copiatelo nella cartella CGI di Apache (o in una qualsiasi cartella in cui il web server può lanciare applicazioni di questo tipo). Sul PC da cui scrivo la cartella è “C:\Programmi\Apache Software Foundation\Apachex.x\cgi-bin”

Copiare l’eseguibile non basta perché ci sono diverse dipendenze da rispettare. Per soddisfarle basterebbe copiare tutti i file contenuti in “C:\Programmi\FWToolsx.x..x\bin” nella cartella CGI, ma non è una procedura “pulita”. E’ più corretto impostare delle variabili d’ambiente.

La prima è il PATH, in cui inseriremo proprio la cartella “C:\Programmi\FWToolsx.x..x\bin“. Per farlo basta aprire le “Proprietà del sistema” di Windows  e cliccare su “Variabili d’ambiente”.

Tra quelle già definite troverete proprio PATH. Modificatela inserendo nel campo “Valore variabile”, a fine riga, il percorso della cartella bin di FWTools: inserite prima un “;”.

C’è da impostare ancora una variabile d’ambiente in quanto MapServer deve “sapere” dove sono i file in cui sono definiti i sistemi di proiezione. La cartella in questo caso è “C:\Programmi\FWToolsx.x.x\proj_lib” e la variabile  è PROJ_LIB.

Questa (di solito) non è – come PATH – già esistente e la dovrete creare cliccando sul tasto “Nuovo” ed inserire i valori come nella figura sottostante.

A questo punto riavviate il PC, aprite il browser e lanciate un URL di questo tipo: http://vostrosito/cgi-bin/mapserv.exe

Se avrete come risposta la stringa “No query information to decode. QUERY_STRING is set, but empty.“, vorrà dire che tutto è andato a buon fine.

Non vi resta che creare delle belle applicazioni di web-mapping.

L'articolo Installare MapServer su Windows con Apache (riveduto e corretto) è apparso originariamente su TANTO. Rispettane le condizioni di licenza.

Aggiornamento: è stato scritto un post che funge da aggiornamento di questo. Lo trovate qui.

MapServerè l’applicazione di webmapping opensource oggi più diffusa e con una lunga storia alle spalle; a mio avviso è anche la migliore.

Per portare a buon fine questo tutorial avremo bisogno anche di un’installazione di Apache funzionante e configurata.

Questo è il primo piccolo tutorial che sto inserendo nel mio Blog, sperando che sia il primo di molti. E’ dedicato all’installazione di MapServer in un ambiente Windows; lo so, sembra un controsenso, ma è la prima cosa che ho imparato a fare e da qui voglio iniziare.

Guida passo passo

• scaricate dal sito MapTools il file zip che contiene il binario dell’ultima versione stabile di MapServer per piattaforma Win32 (oggi è la 4.8.1)

• scaricate il web server Apache o dal sito ufficiale , o scaricate un pacchetto WAMP – con Apache, MySQL e PHP – come Uniform Server. Un pacchetto “completo” come questo vi darà la possibilità di testare anche funzioni più avanzate di MapServer (i.e. phpmapscritpt)
• Assicuratevi che il web server sia attivo (do per scontato che lo sappiate fare)
• Estraete il file mapserv.exe (è un’applicazione cgi) contenuto nel file zip scaricato dal sito MapTools (vedi sotto), nella cartella “cgi” del web-server (se avrete installato Uniform Server, la cartella sarà “W:\cgi-bin”). La cartella cgi è “speciale”, in quanto è una cartella in cui i file possono essere “eseguiti”

• Estraete il contenuto dei file zip evidenziati nella figura sottostante, in una cartella presente nel PATH del vostro sistema operativo. Se avete Windows XP, potrete estrarre il tutto in “C:\WINDOWS\system32″. Questi file zip contengono delle DLL necessarie al corretto funzionamento di MapServer

• Non vi resta che lanciare il vostro browser e puntare al file “mapserv.exe”: tipicamente “http://localhost/cgi-bin/mapserv.exe”. Se avrete come risposta “No query information to decode. QUERY_STRING is set, but empty”, vorrà dire che l’installazione è andata a buon fine. Il messaggio che vi ha restituito MapServer, è una segnalazione del fatto che non avete fornito a MapServer alcun file da processare

Un’altra verifica che potrete fare, al fine di accertarvi della correttezza dell’installazione di MapServer, è quella di aprire il prompt dei comandi sulla cartella cgi e scrivere la seguente stringa: “mapserv.exe -v”. Se tutto va bene avrete un risultato come quello sottostante, in cui potrete leggere quale versione di MapServer state utilizzando (in questo caso la 4.8.1) ma anche con quali feature è stato compilato (i.e. supporto in output di jpeg, png, svg, etc etc)

Riassumendo

Se siete arrivati sino a qui, probabilmente avete un sistema con mapserver 4.8.1 installato e configurato in ambiente Windows sotto un web server Apache. Se il server web fosse IIS, cambierebbe poco: dovrete estrarre il file mapserv.exe nella cartella cgi che avete configurato in IIS, ed assicurarvi che lo IUSR abbia il permesso di esecuzione del file mapserv.exe.
Nel prossimo tutorial (lontano nelle mie previsioni), creeremo una semplicissima applicazione MapServer.

L'articolo Installare MapServer su Windows con Apache è apparso originariamente su TANTO. Rispettane le condizioni di licenza.