OSGeo - User contributions [en]

Komitee für Bildung und Dokumentationserstellung

2009-06-11T15:45:25Z

Wiki-Kai-Behncke: /* Anleitungen */

== Komitee für Bildung und Dokumentationserstellung ==

Die Aufgabe des Komitees für Bildung und Dokumentationserstellung ist es, die Nutzung der unter dem Dach der OSGeo entwickelten
Softwareprodukte durch Anleitungen und Tutorials zu unterstützen.
Diese Anleitungen sollen vorrangig im WIKI erstellt werden, um die Vorteile einer gemeinsamen Erstellung ausnutzen zu können.
Fühlen Sie sich frei sich als Mitglied in dieses Komitee einzutragen und eigene Anleitungen zu erstellen.

== Mitglieder ==
* [[User:Kai Behncke | Kai Behncke]]
* [[User:Peter_panther | Florian Thürkow]]
* [[User:Simon Appelt | Simon Appelt]]
* [[User:jtmapmedia | Jörg Thomsen]]
* [[User:Markus Weißmann | Markus Weißmann]]
* [[User:Sven Boehme | Sven Boehme]]
* [[User:Matthias Heber | Matthias Heber]]
* [[User:Khoffmann | Karsten Hoffmann]]
* [[User:Astrid Emde | Astrid Emde]]
* [[User:mikee63 | Mike Elstermann]]
* [[User:Christian Plass | Christian Plass]]

{| class="float-right" style="background-color:transparent;"
| [[Image:Autorentreffen_Linuxhotel091001.jpg]]
|-
| Treffen zum UMN MapServer Handbuch im Linuxhotel in Essen, Januar 2009
|}

== Kommunikation ==
=== mails ===
* mapserver-de@freegis.org

=== IRC ===
* irc://irc.freenode.net/#fossgis
* [http://widget.mibbit.com/?settings=d6c564d91b45ad67d712a5d287c9a39e&server=irc.freenode.net&channel=%23fossgis Webchat]
* regelmässige Treffen: Donnerstags 17:30 Uhr

== Roadmap ==
* Übernahme von Teilen aus dem englischen UMN Dokument
* FOSSGIS 2009: [http://www.fossgis.de/konferenz/wiki/Dienstag%2C_17._M%C3%A4rz_2009#Entwickler-_und_Anwendertreffen_ab_17:30_Uhr Di 17.3.09 17:30 ]
* evtl. weiteres Treffen Linux-Tag
* Fertigstellung September 2009
* evtl. Intergeo 2009 Bereitstellung des Buches

== Anleitungen ==
* [[Anleitung für Routing (Pgrouting) und UMN MapServer mit den Freien Geodaten aus Osnabrück (Frida) | Anleitung für Routing (Pgrouting) und UMN MapServer mit den Freien Geodaten aus Osnabrück (Frida)]]

* [[Neuerungen des UMN MapServers 5.0 | Neuerungen des UMN MapServers 5.0]]

* [[Installation von MapServer, Apache und PostgreSQL/PostGIS auf Debian 4.0 | Installation von MapServer, Apache und PostgreSQL/PostGIS auf Debian 4.0]]

* [[UMN-Mapserver_Performancetest | UMN-Mapserver Performancetest]]

* [[Wxs mapscript]]

* [[Konstruktion von Diagrammen mit dem UMN MapServer 5.0 | Konstruktion von Diagrammen mit dem UMN MapServer 5.0]]

* [http://trac.mapfish.org/trac/mapfish/wiki/Mapfishprintfornewbies Mapfish-printing (WMS) für Anfänger(Tutorial)]

* [http://pgrouting.postlbs.org/wiki/WorkshopOL2.7andOSM OpenLayers, OSM und pgRouting (Workshop)]

Auf der FOSSGIS 2008 in Freiburg wurde beschlossen, dass im Rahmen von OSGeo Dach (Bildung) gemeinschaftlich das neue Handbuch für den UMN MapServer erstellt wird. Die Erstellung des Buches wird über ein WIKI laufen. Sofern Sie Interesse haben tragen Sie sich bitte in die Mailingliste [http://freegis.org/mailman/listinfo/mapserver-de mapserver-de] ein, und setzen Sie, wenn Sie möchten, oben auch einen namentlichen Link.

Hier gehts zur Gliederung des Handbuches
[http://wiki.osgeo.org/wiki/HBUMNMapServer_ger http://wiki.osgeo.org/wiki/HBUMNMapServer_ger]

== Links ==
* [http://download.osgeo.org/mapserver/docs/mapserver-users-manual.pdf mapserver user manual ]

== Zusammenfassung der Treffen==
=== IRC 2009-01-22===
Link zum gesamten Protokoll: http://logs.qgis.org/fossgis/%23fossgis.2009-01-22.log

'''SVN der OSGEO'''
* wir nutzen das SVN für
** MapFiles
** Beispieldaten
** Grafiken (hochaufgelöste Raster und Vektor-Versionen für den Druck)
** LaTeX- und PDF-Druck-Versionen zu den gedruckten Ausgaben (Ergänzung, Jörg)

'''Beispieldaten'''
* Es werden, wie in Essen besprochen, OSM-Daten von Hamburg für die Beispiele genommen
* Versuch Demo-Rasterdaten für Hamburg zu bekommen (über Kai/Simon/GiN)

'''Finanzierung'''
* Beantragung der Unterstützung durch den FOSSGIS e. V.
* Versuch auch über den AK-WebGIS des GiN Zuschüsse zu bekommen.
Erläuterung für Außenstehende: Es geht hier nicht um die Bezahlung der Arbeitszeiten, nur die Erstattung oder Bezuschussung anfallender Kosten (z.B. Reisekosten) und einer Auslage der Druckkosten.

'''Druck'''

Angebote werden eingeholt, wenn es soweit ist, dass gedruckt werden kann. Eine Option ist die bisherige Druckerei (Schaltungsdienst Lange, Berlin), eine weitere Books on Demand: http://www.bod.de.

'''Grafiker'''

gefunden!
Chrsitian aus Osnabrück

'''Nächster offizieller IRC'''

Der bisherige Termin, Do 17:30, passt leider nicht mehr allen, ein Neuer muss gefunden werden: http://www.doodle.com/sprra5ehbuvex32d

=== Treffen FOSSGIS Hannover 17. 3. 2009===
* UMN MapServer Handbuchtreffen
* Wir haben uns auf der FOSSGIS in Hannover getroffen.
* alle wichtigen Infos sollten sich auf dieser Wikiseite befinden bzw. über die Kategorie http://wiki.osgeo.org/wiki/Category:UMN_MapServer_Handbuch verlinkt sein
* die Kommunikation zum Handbuch geht vorerst über die deutschsprachige Mapserver Liste (falls es zu viel werden sollte, können wir uns eine Alternative überlegen)

;Für alle, die neu hinzugekommen sind oder noch bei der Handbucherstellung mitmachen möchten. Hier die wichtigsten Informationen:
# Link zur OSGeo-Seite
# das Buch soll im September 2009 zur Intergeo herauskommen
# das Buch soll über dern FOSSGIS e.V. vertrieben werden
# alle, die Lust haben mitzuwirken, können sich auf der dieser Seite unter Mitglieder [[Komitee_f%C3%BCr_Bildung_und_Dokumentationserstellung#Mitglieder]] eintragen.
# für das Editieren im Wiki wird ein Account benötigt. Dieses kann direkt im Wiki über den Link http://wiki.osgeo.org/wiki/Special:UserLogin erstellt werden:
# Anregungen zu den einzelnen Kapiteln können auf den jeweiligen "Discussion" Seiten der Kapitel hinterlegt werden und mit den Autoren der Kapitel abgesprochen werden.

;Das Treffen
* neue Interessenten waren anwesend, die sich eine Mitarbeit in Form von Anregungen, kleineren Beiträgen, Korrekturen lesen vorstellen konnten.
* schön wäre es, wenn das Buch eine Mischung aus Nachschlagewerk und Buch, das auch lesbar ist, würde.
* Lars hat das mapserver.org Kapitel Mapfile übersetzt
* das Anwendertreffen auf der FOSSGIS war zu kurz, um in Details zu gehen. Es wäre sinnvoll, wenn wir uns nochmals im Linuxhotel zu einem Wochenende treffen könnten (Termine stehen noch nocht fest)

; Demodaten
Als Demodaten zur Veranschaulichung des Inhalts sollen Raster- und Vektordaten verwendet werden:
* Vektordaten: OSM (download aktueller Daten über die Geofabrik Bereich Bielefeld oder NRW)
* Vektordaten: Basisdaten der Stadt Bielefeld (nach Absprache)
* Rasterdaten: ältere Luftbilder werden von der Stadt Bielefeld bereitgestellt
* Statistische Daten der Stadt Bielefeld
* --> Lars Ligner wird sich mit Rainer Nuß und Andreas Wagner wegen der Daten aus Bielefeld in Verbindung setzen
* --> Jochen Topf wurde angesprochen (Astrid). Er könnte die OSM Daten des gewünschten Bereiches dauerhaft und aktuell bereitstellen.

[[Category: Education]]
[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-02-10T20:10:58Z

Wiki-Kai-Behncke: /* Änderungen */

HBUMNMapServer ger Capter Bezug

2009-02-10T20:06:23Z

Wiki-Kai-Behncke: /* OSGeo4W */

HBUMNMapServer ger Capter Bezug

2009-02-10T20:04:30Z

Wiki-Kai-Behncke: /* OSGeo4W */

HBUMNMapServer ger

2009-02-10T19:56:36Z

Wiki-Kai-Behncke: /* B Bezug und Installation */

= Links =
* die Kategorie zum Handbuch [http://wiki.osgeo.org/wiki/Category:UMN_MapServer_Handbuch Kategorie UMN MapServer Handbuch]
* [[UMNHB_ger_Lizenzen | Klärung der Lizenzfrage]]
* [[ Komitee_f%C3%BCr_Bildung_und_Dokumentationserstellung | Komitee für Bildung und Dokumentationserstellung ]]

= Hinweise zur Bearbeitung der Handbuchseiten=
Aus den Wiki-Seiten der [http://wiki.osgeo.org/wiki/Category:UMN_MapServer_Handbuch Kategorie UMN MapServer Handbuch] soll ein Handbuch in Papierform erstellt werden.

* Der Export aus dem Wiki soll über Wiki2LaTeX (http://www.mediawiki.org/wiki/Extension:Wiki2LaTeX) erfolgen.
* Der Export/Speicherort der Bilder muss noch geklärt werden
* [[Vorlage UMN MapServer Handbuch Kapitel]]

== Vorgaben Wiki Seiten==
Damit dieses recht problemlos erfolgen kann muss bei der Bearbeitung der Seiten folgendes beachtet werden:
* Kapitel
** Überschriften
* Bilder:
* Links
* Codeblöcke
* Listen

__TOC__

= Inhaltsverzeichnis des 'neuen' Handbuchs =

- Änderungen bitte unter das jeweilige Thema fett schreiben '''und auch in den verlinkten Seiten nachführen''' 
- Zuständigkeiten / Autoren im besten Fall mit angeben 

== [[HBUMNMapServer_ger_Capter_1 | Einführung]]==
1.1 Aufbau dieses Buches 
1.2 Was ist ein Mapserver? 
* Mit Architektur Webmapping-Amwendung und Positionierung des UMN 
1.2.1 Vorteile des UMN MapServer 
1.3 Die verschiedenen Funktionsweisen 
1.3.1 MapServer als CGI 
1.3.2 MapServer OGC-konform 
1.3.3 MapScript 
1.3.4 ChangeLog 
1.4 Migration 
1.5 Danksagung 

==[[HBUMNMapServer_ger_Capter_2 | MapFile]]==
2.1 Bedeutung des Mapﬁles 
2.1.1 MapServer als CGI 
2.1.2 Die Modi 
2.1.3 Die weiteren Parameter 
2.2 Grundlegender Aufbau des Mapﬁles 
2.3 Der Header 
2.4 Die Web-Sektion [[USER:Simon Appelt]] 
2.5 Layer [[USER:Simon Appelt]] 
2.5.1 Gruppierungen von Layern 
2.5.2 Weitere Layer-Optionen 
'''2.5.3 Diagramme (Kai Behncke? / Nicol Hermann)''' 
2.6 Classes 
2.6.1 Gruppierungen von Classes '''-NEU-''' 
mit vielen Bsp. für Expressions!!! 
2.7 Styles 
2.8 Rasterdaten 
2.8.1 Bildkataloge 
2.8.2 Rasterdaten klassiﬁzieren 
2.8.3 Umprojizieren von Rasterdaten 
2.8.4 Rasterdaten mit GDAL 
2.9 Vektordaten 
2.9.1 Indizes für Shapeﬁles 
2.9.2 Graticule-Layer '''wird zu GRID -NEU-''' 
2.10 Projektionen 
2.10.1 Notation 
2.10.2 Orthographische Projektion 
2.10.3 Projektionen im realen Einsatz 
2.11 Schriften 
2.12 Annotationen 
2.12.1 Die Label-Sektion 
2.12.2 Bitmap-Schriften 
2.12.3 TrueType-Schriften 
2.12.4 Beschriftungen ohne Annotationslayer 
2.12.5 Der Label-Cache 
2.12.6 Hinweise 
2.13 Symbole 
2.13.1 TrueType-Symbole 
2.13.2 Pixmap-Symbole 
2.13.3 Overlay-Symbole 
2.13.4 Beispiele 
2.14 Maßstäbe 
2.15 Legenden [[USER:Astrid Emde]] 
2.15.1 Die klassische MapServer-Legende 
2.15.2 HTML-Legenden 
'''2.15.3 GetLegendGraphics Request''' ( evtl. auch bei WMS 3.2) 
2.16 Templates 
2.16.1 Die verschiedenen Arten von Templates 
2.16.2 Aufbau 
2.17 Metadaten 
2.18 Queries 
2.18.1 Notation 
2.18.2 Query maps 
2.18.3 Weitere Arten von Queries 
2.19 PostgreSQL und PostGIS 
2.20 OGR 
2.21 Speziﬁkation von Ausgabeformaten 
2.21.1 Rasterbilder 
2.21.2 Vektorformate 
2.22 Features 
2.22.1 Fix positionierte Elemente . 
2.23 CGI-Parameter 
2.23.1 Parameter einschränken . 
2.23.2 Variablensubstitution 
2.24 Logs (Lars?) 
2.25 Includes 
2.26 Joins '''-NEU-''' 

== [[HBUMNMapServer_ger_Capter_3 | OGC-Konformität ]] ==
([[User:jtmapmedia | Jörg Thomsen]] bis einschl. 3.3.2 UMN als WMS Client)

=== [[HBUMNMapServer_ger_Capter_3#Warum_macht_man_das.3F | OGC - warum macht man das?]] ===

=== [[HBUMNMapServer_ger_Capter_3#Wie_macht_man_das.3F | OGC - wie macht man das?]] ===

=== [[HBUMNMapServer_ger_Capter_3#Web_Map_Service_.28WMS.29 | Web Map Service (WMS)]] ===
==== [[HBUMNMapServer_ger_Capter_3#UMN_als_WMS_Server | UMN als WMS Server]] ====
Einführung
* Map Sektion
* Layer Sektion
* Request anhand der Demodaten
** GetFeatureInfo Besonderheiten

==== UMN als WMS Client ====
Einführung
* MAP Sektion
* LAYER Sektion

=== Web Feature Service (WFS) ===
==== UMN als WFS Server ====
Einführung
* MAP Section
* LAYER Section
* --> verschieben nur Verweis in dem Kapitel Projektionen in WFS-Servern
* Schemas ??? Inhalt
* Beispiel / Aufrufe & Capabilities 

==== UMN als WFS Client ====
Einführung
* Map Section
* LAYER Section

=== UMN als WCS ===
* Informationen siehe http://www.mapserver.org/ogc/wcs_server.html
* Informationen siehe http://www.mapserver.org/ogc/wcs_format.html
Einführung
* Map Section
* LAYER Section

=== Web Map Context ===
* Das Context-Dokument
* Den Kontext verwenden

=== Styled Layer Descriptor (SLD) [[USER:Astrid Emde]]===
* Informationen siehe http://www.mapserver.org/ogc/sld.html

=== Filter Encoding [[USER:Astrid Emde]]===
* http://www.mapserver.org/ogc/filter_encoding.html

=== WMS TIME ===
* Informationen siehe http://www.mapserver.org/ogc/wms_time.html
* Einführung
* MAP Section
* LAYER Section
* Anwendungsbeispiel

=== SOS ===
* Informationen siehe http://www.mapserver.org/ogc/sos_server.html

=== OWS Clients [[USER:Astrid Emde]]===
==== Desktop GIS ====
==== WebGIS ====

== [[HBUMNMapServer_ger_Capter_4 | Datenbankanbindungen]] (Kai Behncke, Florian Thürkow)==
4.1 PostgreSQL und PostGIS . 
4.1.1 Shapeﬁles in PostGIS laden 
4.1.2 Notation in Layern 
4.1.3 PostGIS außerhalb des MapServers 
'''4.1.3 PgRouting (Kai Behncke, Florian Thuerkow)''' 
'''4.1.4 Ein paar Worte zu MySQL, Oracle (Spatial) etc.''' 

== [[HBUMNMapServer_ger_Capter_5 | Demos]] ==
''kann entfallen'' 
5.1 Itasca 
5.2 GMap 
5.3 Wesermarsch

== [[HBUMNMapServer_ger_Capter_6 | MapScript]]==
6.1 PHP MapScript '''(Nicol Hermann)''' 
6.1.1 Laden des Moduls 
6.1.2 Setzen von Objekt-Eigenschaften . 
6.1.3 Formulareingaben in PHP verarbeiten 
6.1.4 Die mapObj-Klasse 
6.1.5 Fehlerbehandlung 
6.1.6 Die layerObj-Klasse 
6.1.7 Die classObj-Klasse 
'''6.1.7.1 Dynamische Klassifizierungen ''' 
6.1.8 Die imageObj-Klasse 
6.1.9 Die labelObj-Klasse 
6.1.10 Die webObj-Klasse 
6.1.11 Die referenceMapObj-Klasse 
6.1.12 Die colorObj-Klasse 
6.1.13 Die pointObj-Klasse 
6.1.14 Die lineObj-Klasse 
6.1.15 Die projectionObj-Klasse 
6.1.16 Die shapeﬁleObj-Klasse 
'''6.1.16.1 Dynamisches Erzeugen eines Shape-Files''' 
''' 6.1.17 Die SymbolObj-Klasse''' 
''' 6.1.17.1 Dynamisches Erzeugung von Symbol-Objekten''' 
'''6.1.18 Die ShapeObj Klasse ''' 
'''6.1.18.1 Feature-Anlage (Punkt-, Linien, Polygon-Objekte) ''' 
'''6.1.18.2 Geometrie-Verarbeibung mit PHP MapScript ''' 
6.1.19 Struktur von PHP MapScript-Seiten 
6.1.20 Speichern von Map-Objekten in PHP-Sessions 
6.1.21 Speicherverwaltung mit MapScript 
'''6.1.22 OGC Konformität mit PHP MapScript ''' 
'''6.1.22.1 PHP Mapscript als WxS-Server''' 
'''6.1.22.2 Erzeugen und Laden von SLD-Dokumenten''' 
'''6.1.22.3 Erzeugen und Laden von WMS Map Context Dokumenten ''' 
'''6.1.23 Nutzung von PHP Mapscript ohne MapFile''' 
6.2 Weitere Sprachen 
6.2.1 Perl 
6.2.2 Java 
6.2.3 Python 
'''6.2.3 Mapserver goes Web 2.0 - AJAX mit msCross (Florian Thuerkow)''' 

== [[HBUMNMapServer_ger_Capter_7 | Zusätzliche Werkzeuge]]==
7.1 Werkzeuge der Bibliothek Shapelib 
7.1.1 shpdump 
7.1.2 shpcreate, shpadd, dbfcreate und dbfadd 
7.1.3 dbfdump 
7.1.4 shpinfo 
7.1.5 dbﬁnfo 
7.2 Werkzeuge des MapServers 
7.2.1 shp2img 
7.2.2 shptree 
7.2.3 shptreevis 
7.2.4 msencrypt 
7.3 Werkzeuge der GDAL/'''OGR'''-Bibliothek 
7.3.1 gdaltindex 
'''7.3.2 gdalinfo''' 
'''7.3.3 ogrinfo''' 
'''7.3.4 FWTools''' 

===7.4 Erzeugung von MapFiles [[USER:Astrid Emde]]===
====7.4.1 QGIS ====
====7.4.1 gvSIG ====
====7.4.2 MapStorer ====
====7.4.3 AVEIN! / AMEIN! ====
====7.4.4 MapEdit ====

== II Anhang ==
===A [[HBUMNMapServer_ger_Capter_Referenz | Referenz]] ===
A.1 Limits 
A.2 Organisation der Daten 
A.3 Änderungen 
A.3.1 3.6 nach 4.0 
A.3.2 3.5 nach 3.6 
A.4 PHP MapScript 
A.4.1 Konstanten 
A.4.2 Allgemeine Funktionen 
A.4.3 mapObj 
A.4.4 layerObj . 
A.4.5 classObj 
A.4.6 styleObj 
A.4.7 imageObj 
A.4.8 labelObj 
A.4.9 labelCacheObj . 
A.4.10 webObj 
A.4.11 referenceMapObj 
A.4.12 colorObj 
A.4.13 pointObj 
A.4.14 lineObj 
A.4.15 rectObj 
A.4.16 shapeObj 
A.4.17 projectionObj 
A.4.18 shapeﬁleObj 
A.4.19 resultCacheMemberObj 
A.4.20 scalebarObj 
A.4.21 legendObj 
A.4.22 outputformatObj . 
A.4.23 gridObj 
A.4.24 errorObj 
'''A.4.25 symbolObj''' 
'''A.4.26 querymapObj''' 
'''A.4.27 owsrequestObj''' 
'''A.4.28 imageObj''' 
A.5 CGI-Parameter 
A.5.1 Normale Parameter . 
A.5.2 CGI-Modus . 
A.5.3 Parameter für Java-Applets 

== B [[HBUMNMapServer_ger_Capter_Bezug | Bezug und Installation]] ==
*Florian Thürkow, Kai Behncke ''' (Nur als Kapitel im Anhang?, finde ich zu wenig, nh)
* 1 Bezug
o 1.1 Vorkompilierte Binaries
+ 1.1.1 Windows
o 1.2 ms4w
+ 1.2.1 OSGeo4W
+ 1.2.2 Linux
o 1.3 Quelltexte
+ 1.3.1 Bibliotheken
# 1.3.1.1 Installation der Bibliotheken
+ 1.3.2 Apache Webserver
+ 1.3.3 PostgreSQL/PostGIS
+ 1.3.4 PHP
+ 1.3.5 UMN MapServer
o 1.4 Änderungen

==C [[HBUMNMapServer_ger_Capter_Migration | Migration]] 239==
C.1 Von Version 3.6 nach Version 4.0 
'''raus, Migration 4.x nach 5.x''' 
C.1.1 Geänderte und neue Parameter 
C.1.2 MapServer kompilieren 
C.1.3 Queries 
C.1.4 Diverse Probleme 
C.1.5 MapScript 

== D [[HBUMNMapServer_ger_Capter_Sicherheit | Sicherheit]]==
D.1 Komprommittierung des MapServer-Rechners 
D.2 Zugänglichkeit der Originaldaten 
D.3 Verschleiern des Mapﬁlenamens 
D.4 MapScript-Anwendungen 
D.5 Die Clientseite: Active Scripting 

==E [[HBUMNMapServer_ger_Capter_Performance | Tips zur Performance]] ==
E.1 Vermeiden Sie unnötige Funktionalität 
E.2 Nutzen Sie MINSCALE und MAXSCALE 
'''Kann raus - MINSCALEDENOM und MAXSCALEDENOM''' 
E.3 Legen Sie Indizes an 
E.4 Kacheln Sie Ihre Daten 
E.5 Kompression muß verstanden werden 
E.6 Datenbankabfragen . 
E.7 Hardware 
E.8 Schließlich: Zeigen Sie nie alles auf einmal 

== Projektionen ==
=== die EPSG ===

== F [[HBUMNMapServer_ger_Capter_Formate | Unterstützte Formate]]==
F.1 Lesbare Formate 
F.1.1 GD 
F.1.2 Räumliche Datenbanken 
F.1.3 Rasterformate mit GDAL 
F.1.4 Vektorformate mit OGR 
'''F.1.5 ArcSDE (Florian Thuerkow)''' 
F.2 Schreibbare Formate 
F.3 Nicht unterstützte Formate 

==G [[HBUMNMapServer_ger_Capter_Internet | MapServer im Internet]] ==
G.1 Website 
G.2 Mailinglisten 
G.2.1 Archiv 
G.2.2 Wiki 
G.2.3 Forum 
G.3 Beispielseiten 
G.3.1 Capabilities XML 

==H [[HBUMNMapServer_ger_Capter_Lizenz | Lizenz der Software]] ==
H.1 Die Lizenz aus der Datei README 
H.2 Erläuterungen 

= Inhaltsverzeichnis aus der internationalen Diskussion =

Kurzes Update zum internationalen User Manual (09.04.2008). Jeff McKenna hat gestern ein PDF mit dem ersten Entwurf des Buches veröffentlicht. Der Entwurf umfasst 134 Seiten und ist unter der Adresse:
http://download.osgeo.org/mapserver/docs/mapserver-users-manual.pdf (1MB)
einsehbar.

Some comments:

- has gaping holes 
- plan is to use SteveL's demo as part of the missing 'application' section 
- most if not all examples in this doc were manually executed, and in many cases i've updated the associated existing website docs accordingly 
- many more existing website docs will be ported into the Appendix 

 
-------
 

Hier die Zusammenfassung zum Thread 'Feedback required: plans for Downloadable Users Manual' auf der mapserver-dev Liste.
Der Original-Thread findet sich unter:
http://www.nabble.com/Feedback-required:-plans-for-Downloadable-Users-Manual-td16260533.html
 
Vorgeschlagen wurde zunächst folgende Struktur: 
 

Table of Contents 
----------------- 
 
Introduction 
Getting Started 
- Installing 
- Architecture of MapServer 
Preparing Data 
- The .Map File 
- Supported Formats 
- Tips and Tricks 
- Factors Affecting Performance 
Building a MapServer Application 
- Flavors 
- Example Code 
Community 
- History of MapServer 
- Project Steering Committee 
- Contributing 
- Getting Help 
- Conferences/Workshops
Glossary 
 

Als inhaltliche Ergänzungen wurden dann noch folgende Punkte vorgeschlagen: 
 
- client software (ka-map!, OpenLayers, GeoMoose, PMapper, etc.) 
- map file management software (MapStorer, any others) 
- including copies of all HOWTOs and references in the appendices? 
- configuration of an application and data. 
- include a complete production sample mapfile like Bob Basques Googlish mapfile 

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-02-10T19:52:04Z

Wiki-Kai-Behncke: /* Bezug */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:51:43Z

Wiki-Kai-Behncke: /* Bezug */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:49:33Z

Wiki-Kai-Behncke: /* OSGeo4W */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:38:29Z

Wiki-Kai-Behncke: /* ms4w */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:27:46Z

Wiki-Kai-Behncke: /* ms4w */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:17:46Z

Wiki-Kai-Behncke: /* ms4w */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:14:10Z

Wiki-Kai-Behncke: /* Windows */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:12:50Z

Wiki-Kai-Behncke: /* Windows */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:11:54Z

Wiki-Kai-Behncke: /* MapScript */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:11:37Z

Wiki-Kai-Behncke: /* Aus den Quellen */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:11:12Z

Wiki-Kai-Behncke: /* Binaries */

HBUMNMapServer ger Capter Bezug

2009-02-10T19:10:42Z

Wiki-Kai-Behncke: /* Installation von Binaries */

User:Christian Plass

2009-01-28T19:35:09Z

Wiki-Kai-Behncke: New page: Christian Plass, Mail:cplass@uos.de

Christian Plass, Mail:cplass@uos.de

Komitee für Bildung und Dokumentationserstellung

2009-01-28T19:34:39Z

Wiki-Kai-Behncke: /* Mitglieder */

HBUMNMapServer ger Capter Bezug

2009-01-23T11:30:27Z

Wiki-Kai-Behncke: /* Vorkompiliert */

HBUMNMapServer ger Capter Bezug

2009-01-23T11:26:36Z

Wiki-Kai-Behncke: /* Die MapMedia MapServer Suite */

HBUMNMapServer ger Capter Bezug

2009-01-23T11:20:36Z

Wiki-Kai-Behncke: /* Vorkompiliert */

HBUMNMapServer ger Capter Bezug

2009-01-23T11:19:33Z

Wiki-Kai-Behncke: /* Installation der Bibliotheken */

HBUMNMapServer ger Capter Bezug

2009-01-23T11:18:25Z

Wiki-Kai-Behncke: /* Vorkompiliert */

HBUMNMapServer ger Capter Bezug

2009-01-23T11:15:42Z

Wiki-Kai-Behncke: /* Die MapMedia MapServer Suite */

HBUMNMapServer ger Capter Bezug

2009-01-23T11:09:39Z

Wiki-Kai-Behncke: /* Quelltexte */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

fehlt noch

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.
Sie sollten aber mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek ist unbedingt zu empfehlen.

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).
Eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter.

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers (http://www.mapserver.org) editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie, sofern noch nicht getan, bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach Distribution)
Fügen Sie dort die Zeilen

/usr/lib
/usr/local/lib
/usr/local/pgsql/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers und geben z.B. ein:

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg --with-png --with-freetype
--with-proj --with-geos --with-libiconv --with-agg=/opt/install/zip/agg-2.5 --with-postgis=/usr/local/pgsql/bin/pg_config --with-threads
--with-php=/usr/local/php5

...und geben Sie dann ein

make

ein. Wenn alles kompiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version.

MapServer version 5.2.1 OUTPUT=GIF OUTPUT=PNG OUTPUT=WBMP OUTPUT=SVG SUPPORTS=PROJ SUPPORTS=AGG SUPPORTS=FREETYPE SUPPORTS=ICONV SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT SUPPORTS=THREADS SUPPORTS=GEOS INPUT=TIFF INPUT=EPPL7 INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE

Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

No query information to decode. QUERY_STRING is set, but empty.

kommt ist alles wunderbar. Der MapServer ist einsatzbereit.

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T11:07:46Z

Wiki-Kai-Behncke: /* Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

fehlt noch

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek ist unbedingt zu empfehlen.

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).
Eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter.

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers (http://www.mapserver.org) editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie, sofern noch nicht getan, bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach Distribution)
Fügen Sie dort die Zeilen

/usr/lib
/usr/local/lib
/usr/local/pgsql/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers und geben z.B. ein:

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg --with-png --with-freetype
--with-proj --with-geos --with-libiconv --with-agg=/opt/install/zip/agg-2.5 --with-postgis=/usr/local/pgsql/bin/pg_config --with-threads
--with-php=/usr/local/php5

...und geben Sie dann ein

make

ein. Wenn alles kompiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version.

MapServer version 5.2.1 OUTPUT=GIF OUTPUT=PNG OUTPUT=WBMP OUTPUT=SVG SUPPORTS=PROJ SUPPORTS=AGG SUPPORTS=FREETYPE SUPPORTS=ICONV SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT SUPPORTS=THREADS SUPPORTS=GEOS INPUT=TIFF INPUT=EPPL7 INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE

Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

No query information to decode. QUERY_STRING is set, but empty.

kommt ist alles wunderbar. Der MapServer ist einsatzbereit.

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T11:05:52Z

Wiki-Kai-Behncke: /* Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

fehlt noch

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek ist unbedingt zu empfehlen.

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers (http://www.mapserver.org) editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie, sofern noch nicht getan, bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach Distribution)
Fügen Sie dort die Zeilen

/usr/lib
/usr/local/lib
/usr/local/pgsql/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers und geben z.B. ein:

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg --with-png --with-freetype
--with-proj --with-geos --with-libiconv --with-agg=/opt/install/zip/agg-2.5 --with-postgis=/usr/local/pgsql/bin/pg_config --with-threads
--with-php=/usr/local/php5

...und geben Sie dann ein

make

ein. Wenn alles kompiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version.

MapServer version 5.2.1 OUTPUT=GIF OUTPUT=PNG OUTPUT=WBMP OUTPUT=SVG SUPPORTS=PROJ SUPPORTS=AGG SUPPORTS=FREETYPE SUPPORTS=ICONV SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT SUPPORTS=THREADS SUPPORTS=GEOS INPUT=TIFF INPUT=EPPL7 INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE

Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

No query information to decode. QUERY_STRING is set, but empty.

kommt ist alles wunderbar. Der MapServer ist einsatzbereit.

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T11:04:01Z

Wiki-Kai-Behncke: /* Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

fehlt noch

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers (http://www.mapserver.org) editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie, sofern noch nicht getan, bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach Distribution)
Fügen Sie dort die Zeilen

/usr/lib
/usr/local/lib
/usr/local/pgsql/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers und geben z.B. ein:

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg --with-png --with-freetype
--with-proj --with-geos --with-libiconv --with-agg=/opt/install/zip/agg-2.5 --with-postgis=/usr/local/pgsql/bin/pg_config --with-threads
--with-php=/usr/local/php5

...und geben Sie dann ein

make

ein. Wenn alles kompiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version.

MapServer version 5.2.1 OUTPUT=GIF OUTPUT=PNG OUTPUT=WBMP OUTPUT=SVG SUPPORTS=PROJ SUPPORTS=AGG SUPPORTS=FREETYPE SUPPORTS=ICONV SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT SUPPORTS=THREADS SUPPORTS=GEOS INPUT=TIFF INPUT=EPPL7 INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE

Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

No query information to decode. QUERY_STRING is set, but empty.

kommt ist alles wunderbar. Der MapServer ist einsatzbereit.

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T11:01:28Z

Wiki-Kai-Behncke: /* Bezug */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

fehlt noch

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers (http://www.mapserver.org) editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie, sofern noch nicht getan, bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach Distribution)
Fügen Sie dort die Zeilen

/usr/lib
/usr/local/lib
/usr/local/pgsql/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers und geben z.B. ein:

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg --with-png --with-freetype
--with-proj --with-geos --with-libiconv --with-agg=/opt/install/zip/agg-2.5 --with-postgis=/usr/local/pgsql/bin/pg_config --with-threads
--with-php=/usr/local/php5

...und geben Sie dann ein

make

ein. Wenn alles kompiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version.

MapServer version 5.2.1 OUTPUT=GIF OUTPUT=PNG OUTPUT=WBMP OUTPUT=SVG SUPPORTS=PROJ SUPPORTS=AGG SUPPORTS=FREETYPE SUPPORTS=ICONV SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT SUPPORTS=THREADS SUPPORTS=GEOS INPUT=TIFF INPUT=EPPL7 INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE

Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

No query information to decode. QUERY_STRING is set, but empty.

kommt ist alles wunderbar. Der MapServer ist einsatzbereit.

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T10:44:22Z

Wiki-Kai-Behncke: /* UMN MapServer */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers (http://www.mapserver.org) editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie, sofern noch nicht getan, bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach Distribution)
Fügen Sie dort die Zeilen

/usr/lib
/usr/local/lib
/usr/local/pgsql/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers und geben z.B. ein:

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg --with-png --with-freetype
--with-proj --with-geos --with-libiconv --with-agg=/opt/install/zip/agg-2.5 --with-postgis=/usr/local/pgsql/bin/pg_config --with-threads
--with-php=/usr/local/php5

...und geben Sie dann ein

make

ein. Wenn alles kompiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version.

MapServer version 5.2.1 OUTPUT=GIF OUTPUT=PNG OUTPUT=WBMP OUTPUT=SVG SUPPORTS=PROJ SUPPORTS=AGG SUPPORTS=FREETYPE SUPPORTS=ICONV SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT SUPPORTS=THREADS SUPPORTS=GEOS INPUT=TIFF INPUT=EPPL7 INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE

Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

No query information to decode. QUERY_STRING is set, but empty.

kommt ist alles wunderbar. Der MapServer ist einsatzbereit.

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T10:42:30Z

Wiki-Kai-Behncke: /* UMN MapServer */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers (http://www.mapserver.org) editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie, sofern noch nicht getan, bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach Distribution)
Fügen Sie dort die Zeilen

/usr/lib
/usr/local/lib
/usr/local/pgsql/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers und geben z.B. ein:

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg --with-png --with-freetype
--with-proj --with-geos --with-libiconv --with-agg=/opt/install/zip/agg-2.5 --with-postgis=/usr/local/pgsql/bin/pg_config --with-threads
--with-php=/usr/local/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T10:42:05Z

Wiki-Kai-Behncke: /* UMN MapServer */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers (http://www.mapserver.org) editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie, sofern noch nicht getan, bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach Distribution)
Fügen Sie dort die Zeilen

/usr/lib
/usr/local/lib
/usr/local/pgsql/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers und geben z.B. ein:

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg --with-png --with-freetype --with-proj --with-geos --with-libiconv --with-agg=/opt/install/zip/agg-2.5 --with-postgis=/usr/local/pgsql/bin/pg_config --with-threads --with-php=/usr/local/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T10:37:12Z

Wiki-Kai-Behncke: /* UMN MapServer */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers (http://www.mapserver.org) editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie, sofern noch nicht getan, bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach Distribution)
Fügen Sie dort die Zeilen

/usr/lib
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers und geben z.B. ein:

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg --with-png --with-freetype --with-proj --with-geos --with-libiconv --with-agg=/opt/install/zip/agg-2.5 --with-postgis=/usr/local/pgsql/bin/pg_config --with-threads --with-php=/usr/local/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T10:24:41Z

Wiki-Kai-Behncke: /* PHP */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

Anschließend ein

make

sowie ein

make install

Dann:

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.8/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so (sofern dieses bei der Installation von php nicht automatisch eingetragen wurde)

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T10:17:00Z

Wiki-Kai-Behncke: /* Installation der Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Wenn Sie die Bibliotheken installieren wollen wechseln Sie bitte in das VErzeichnis der jeweilig entpackten Bibliothek.
Dort führen Sie zunächst den Befehl

./configure

aus. Dieser bewirkt zunächst eine Konfiguration der entsprechenden Bibliothek. Nach Abschluss der Konfiguration wird ein
sogenanntes Makefile erzeugt. Dieses beinhaltet die notwendigen Informationen um den Quellcode zu kompilieren.
Führen Sie danach den Befehl

make

und anschließend

make install

aus und die Biliotheken sind installiert.

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T09:59:47Z

Wiki-Kai-Behncke: /* Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35) (PostGIS benötigt diese Bibliothek)

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-23T09:58:53Z

Wiki-Kai-Behncke: /* PostgreSQL/PostGIS */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.
PostgreSQL können Sie von http://www.postgresql.org/download herunterladen (aktuell war 8.3.5).
PostGIS erhalten Sie auf http://postgis.refractions.net/ (1.3.5)

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/zip/postgresql-8.3.5/contrib.

cp -R postgis /opt/install/zip/postgresql-8.3.5/contrib/

In dem Ordner führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T09:50:28Z

Wiki-Kai-Behncke: /* PHP */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T09:49:59Z

Wiki-Kai-Behncke: /* Apache Webserver */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T09:12:44Z

Wiki-Kai-Behncke: /* Apache Webserver */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/conf/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.
z.B.

User daemon
Group daemon

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/apache/bin/apachectl start

Sollte dann evtl eine Fehlermeldung kommen der Art von:

error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

so werden Bibliotheken nicht gefunden.
Ändern Sie dann die Datei /etc/ld.co.conf und sorgen Sie dafür dass dort z.B. folgendes steht:

/lib/i486-linux-gnu
/usr/lib/i486-linux-gnu
/usr/lib
/usr/local/lib

Anschließend führen Sie auf Kommandozeile den Befehl

ldconfig
aus.

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T08:53:29Z

Wiki-Kai-Behncke: /* Installation der Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken wie z.B. libming oder pdflib.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/xxxxxxxxxxxxx/apachectl start

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T08:52:50Z

Wiki-Kai-Behncke: /* Installation der Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken.

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/xxxxxxxxxxxxx/apachectl start

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T08:49:25Z

Wiki-Kai-Behncke: /* Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken.(ausführlicher)

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/xxxxxxxxxxxxx/apachectl start

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T08:14:33Z

Wiki-Kai-Behncke: /* Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (http.//trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output, wird eher selten eingesetzt.

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken.(ausführlicher)

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/xxxxxxxxxxxxx/apachectl start

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T08:12:11Z

Wiki-Kai-Behncke: /* Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (http.//trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output

libming (http://www.libming.org): Für Macromedia Flash Output. (wird eher selten eingesetzt)

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken.(ausführlicher)

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/xxxxxxxxxxxxx/apachectl start

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T08:08:45Z

Wiki-Kai-Behncke: /* Installation der Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (http.//trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output

libming (http://www.libming.org): Für Macromedia Flash Output.

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken.(ausführlicher)

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/xxxxxxxxxxxxx/apachectl start

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T08:02:48Z

Wiki-Kai-Behncke: /* Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (http.//trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output

libming (http://www.libming.org): Für Macromedia Flash Output.

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

Die heruntergeladenen Dateien sind noch "gepackt", diese müssen Sie "entpacken".

Eine .tar,gz Datei entpacken Sie mit:

tar xvfz freetype-2.3.8.tar.gz

Eine tar.bz2-Datei entpacken Sie mit:

tar xvfl geos-3.0.3.tar.bz2

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken.(ausführlicher)

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/xxxxxxxxxxxxx/apachectl start

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T07:58:16Z

Wiki-Kai-Behncke: /* Installation der Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (http.//trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output

libming (http://www.libming.org): Für Macromedia Flash Output.

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

tiff (./configure/make/make install)

geotiff (./configure/make/make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken.(ausführlicher)

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/xxxxxxxxxxxxx/apachectl start

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Bezug

2009-01-22T07:56:59Z

Wiki-Kai-Behncke: /* Bibliotheken */

= Bezug und Installation (Florian Thürkow, Kai Behncke)
(1)\index{Bezug}\index{Installation}

Die Installation des MapServers auf einem System kann zuweilen seine Tücken haben, insbesondere dann, wenn Sie die Quelltexte selber kompilieren möchten. Sie ist im folgenden Schritt für Schritt so beschrieben, dass Sie dennoch in kürzester Zeit zu einem laufenden System kommen können.

=Bezug=

Auf der Mapserver Website http://mapserver.org gibt es eine Download-Sektion, die in diverse Rubriken unterteilt ist:

*''Offizieller Release'' : Dieses Paket enthält den Quellcode für die aktuelle, stabile Version des MapServers. Zur Drucklegung dieses Buches ist das Version 5.2.1.

*''Ältere Releases'' : Alte Versionen. Unterstützt wird vor allen Dingen immer die aktuelle Version. Fragen auf der Mailingliste zur älteren Version werden gerne mit dem Hinweis beantwortet, man solle doch auch die aktuelle Version upgraden.

*''Interim Builds'' : Dies sind täglich (automatisch) vorgenommene Kompilierungen aus dem CVS-Verzeichnis; d.h. aus dem Verzeichnis, in dem die Entwickler den aktuellsten Quellcode lagern. Der Umgang mit diesen Paketen soll an dieser Stelle nicht behandelt werden, zumal nicht einmal sichergestellt ist, dass sie überhaupt funktionieren.
*''Windows'' : Für Windows gibt es spezielle Pakete, mehr dazu weiter unten.

Grundsätzlich gilt für alle Wege der Installation, dass Sie am Ende das fertige MapServer-Binary in das CGI-Verzeichnis Ihres Webservers kopieren. Sie können prüfen, ob das Programm ausgeführt wird, indem Sie (nachdem der Webserver gestartet worden ist) seinen URL aufrufen:

 <code>
http://www.example.com/cgi-bin/mapserv
</code> 

Die Fehlermeldung, die Sie dann erhalten sollten, lautet:

 <code>
No query information to decode. QUERY_STRING is set, but empty.
</code> 

Motzt der Server herum, ist er gesund, wie bereits in Abschnitt~\ref{text:mapfile:cgi} erklärt. Beachten Sie, dass Sie unter Windows nicht gezwungenermaßen die Endung =.exe= an en URL-Aufruf anhängen müssen.

''Hinweis für Windows-Benutzer'' : Sollten Sie MapServer unter aktuellen Windows-Versionen wie 2003 unter IIS 6.0 laufen lassen wollen\footnote{Von IIS ist allerdings aus Sicherheitsgründen dringend abzuraten.}, beachten Sie bitte, dass die Software über ein neues Sicherheitsmodell verfügt und in der Standardeinstellung keine dynamisch generierten Inhalte ausliefert. Genaueres erfahren Sie auf der Microsoft-Website.

==Vorkompiliert==

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden ''.zip'' -Archive:

*''/win32bin/ms40_gif_pg.zip'' Ein fertiges Binary, dass ''.gif'' -Bilder produziert, gegen die GDAL gelinkt ist, auf PostGIS zugreifen kann und sowohl als WMS-konformer Client als auch Server dienen kann. Desweiteren kann dieses Binary PDF und Flash erzeugen, umprojizieren und mit TrueType-Schriften umgehen.
*''/win32bin/ms40_png_pg.zip'' Genau das gleiche, allerdings mit PNG statt GIF.

Beide Archive sind rund 10 Megabytes groß.

Des weiteren gibt es noch zwei Pakete, die mit den beiden genannten identisch sind, allerdings die PostGIS-Unterstützung durch Unterstützung für Oracle Spatial-Datenbanken ersetzen. Die Oracle-Bibliotheken werden nicht mitgeliefert und müssen demnach bereits auf dem Zielsystem vorhanden sein.

Unter Umständen finden sich im Internet für diverse Systeme Binaries mit einkompilierten Spezialitäten. Mit ein wenig Suche sollten Sie beispielsweise auch im Archiv der Mailingliste entsprechende Verweise auftun können.

Für RPM-basierte Linux-Distributionen auf Intel-Systeme gibt es ein Paket, das von der Firma intevation geschnürt wird. Sie finden es unter~[[ftp:intevation:rpm]].

==Quelltexte==

Das herunterladen von Quelltexten und manuelle konfigurieren/kompilieren ist letztlich unter Linuxdistributionen die sauberste aber auch die langwierigste Form der Installation.
Ihre Nerven sollten, zumal wenn Sie eine solche Installation erstmalig durchführen, schon ein klein wenig strapazierfähig sein.
Aber keine Sorge, im Endeffekt wird der MapServer sicher laufen.

Legen Sie als erstes mehrere Verzeichnisse an um die einzelnen Bibliotheken, den Apache Webserver, PHP, den MapServer herunterzuladen und letztlich zu installieren.

mkdir /opt/install
mkdir /opt/install/zip

Unter dem Quelltext, auch Quellcode (engl. source code) oder Programmcode, versteht man in der Informatik den für Menschen lesbaren, in einer Programmiersprache geschriebenen Text eines Computerprogramms.
In der Regel wird der entsprechende Code auf den jeweiligen Webseiten auch direkt als "Source-Code" angeboten.
Die Dateien erkennen Sie oft an der Endung "tar.gz" bzw. "tar.bz2".

Um die Quelltexte zu kompilieren benötigen Sie zudem einige Entpackungsprogramme bzw. Kompiler. Oftmals sind diese
schon vorinstalliert, wenn nicht so müssen sie nachintsalliert werden, z.B.

bison (ftp.gnu.org/gnu/bison) (Aktuell war 2.4) (C/C++ kompiler)

gcc (http://gcc.gnu.org) (aktuell war 4.3.3) (Eine Compiler Collection)

bzip2 (http://bzip.org/) (1.0.5) (Komprimierungs-/Dekomprimierungsprogramm)

---------------

=== Bibliotheken ===

Laden Sie dann folgende Quellcodes herunter:

freetype (http://www.freetype.org (Zum Zeitpunkt der Erstellung des Buches lag von freetype die Version 2.3.6 vor)).
FreeType stellt eine Bibliothek dar um vektorisierte Schriftarten in Rastergrafiken umzuwandeln.
Diese Bibliothek wird vom MapServer unbedingt benötigt (Die Bibliothek GD benötigt diese).

zlib (http://www.zlib.net) (aktuell war Version 1.2.3).
Die Bibliothek zlib dient zum Komprimieren und Dekomprimieren von Daten mit dem sog. Deflate-Algorithmus.

libpng (http://www.libpng.org) (aktuell war Version 1.2.34).
Diese Biliothek sollte unbedingt installiert werden.
Die libpng-Bibliothek dient zum Bearbeiten/Darstellen von PNG-Bildern.

libgd (http://www.libgd.org (aktuell war 2.0.35).
GD dient zur Erstellung/zum Rendering u.a. von PNG-, JPEG- and GIF-Bildern. Diese Bibliothek wird unbedingt vom MapServer benötigt.

Für den Fall, dass Sie internationale Zeichensätze integrieren wollen benötigen Sie noch die
libiconv-Bibliothek. Die erhalten Sie von http://www.gnu.org/software/libiconv/ .

Sehr zu empfehlen sind auch die folgenden Bibliotheken:

Proj (http.//trac.osgeo.org/proj) (4.6.1),
Bibliothek für kartographische Projektionen.

AGG (http://antigrain.com) (2.5)
Dient ebenfalls zum Rendern von Grafiken, sorgt letztlich für ein etwas besseres Rendern als die GD-Bibliothek, ist aber auch etwas langsamer.

Gdal (http://gdal.org) (1.6.0),
Bibliothek für ca. 40 Rasterformate, zugleich beinhaltet diese Bibliothek auch die OGR-Library mit Unterstützung für nahezu 20
Vektortypen (sollte möglichst installiert werden). Sollten Sie z.B. Arc SDE für Rasterdaten nutzen wollen, so benötigen Sie diese Bibliothek.

libcurl (http://curl.haxx.se/libcurl) (7.19.2)-
Diese Bibliothek sorgt für OGC-(WFS/WMS/WCS)-Unterstützung (sehr wichtig!).

Optional:

FEHLT NOCH:FAST-CGI

libtiff (http://www.libtiff.org) (aktuell: 3.8.2) Für Tiff-Dateien, wird für Geotiff benötigt

ligbeotiff (http://trac.osgeo.org/geotiff (aktuell: 1.2.5)
LibGeoTIFF dient zum Lesen und Schreiben von GeoTIFF-Informationen.

Geos (http://trac.osgeo.org/geos/) (3.0.3).
Letztlich eine Bibliothek zur geografischen Datenverarbeitung. Diese beinhaltet alle Operatoren der OGC-
Spezifikation für SimpleFeatures (z.B. Funktionen wie touch, union, intersect etc.).
Benötigt wird mindestens Version 4.10 des MapServers.

libreadline (ftp.gnu.org/gnu/readline/readline-5.2.tar.gz) (5.2),
Bietet Funktionen an, um Kommandozeilen zu editieren.
Wird von PostgreSQL genutzt für die psql-Eingabekonsole.

libjpeg (http://ijg.org) (6.0),
Dient zum Erstellen/Bearbeiten von JPEG-Bildern.

libxml (ftp.xmlsoft.org/libxml2/).
Dient zum Parsen von xml. Wird für den OGC SOS-Support benötigt.

pdflib (lite) (http://www.pdflib.com/products/pdflib-family/pdflib-lite):
Für die Erstellung von PDF-Output

libming (http://www.libming.org): Für Macromedia Flash Output.

Flex (http://flex.sourceforge.net) (Version 2.5.35).

libpg: Diese Bibliothek steht zur Verfügung wenn Sie PostgresSQL/PostGIS installieren.
Den Quellcode finde Sie auf http://postgresql.org (8.3.5) bzw. auf http://postgis.refractions.net/download (1.3.5)

Proprietäre Bibliotheken

Arc SDE Client Bibliothek: Diese Bibliothek steht nicht frei zur Verfügung, sie ist Bestandteil von von der ESRI-Geodatenbak ArcSDE.

Oracle Spatial OCI: Aufsatz für die Oracle-Datenbank. Diese Bibliothek bekommen Sie von der Oracle-Seite.

== Installation der Bibliotheken ==

Folgende Schritte sollten Sie dann in den Ordnern der entpackten Bibliotheken ausführen:

readline (./configure,make, make install)

zlib (./configure, make, make test (um zu überprüfen) make install)

libpng (./configure, make, make install)

libjpeg (./configure --enable-shared, make, make test, make install)
make install-lib (dieser Befehl damit libjpeg auch ordentlich von der GD-Bibliothek erkannt wird)

flex (./configure, make, make install)

curl (./configure, make, make install)

freetype (./configure, make, make install)

Sofern Sie verschiedene internationale Zeichensätze installieren möchten müssen Sie zunächst
libiconv installieren:

libiconv (./configure, make, make install)

gd (./configure --with-liconv (diese Option nur dann, wenn Sie internationale Zeichensätze benötigen), make , make install)

Sie können testen ob gd mit der libiconv kompiliert wurde indem Sie ein

gdlib-config --libs

eingeben. Im Output sollte dann ein "-liconv" erscheinen.

geos (./configure, make, make install)

xml (./configure, make, make install)

gdal (./configure, make, make install)

proj (./configure, make, make install)

geotiff (./configure/make/make install)

AGG (Bei dieser Bibliothek brauchen Sie nur im Ordner des entpackten Quellcodes den Befehl "make" ausführen.

.....sowie ggf. die weiteren Bibliotheken.(ausführlicher)

=== Apache Webserver ===

Als Webserver nutzen Sie am Besten den Apache (2.2.11)
Den Quellcode bekommen Sie von httpd.apache.org/download.cgi

Anschließend installieren Sie bitte den Apache Webserver.
Zunächst einmal führen Sie bitte im Ordner des entpackten Quellcodes (/opt/install/unzip/httpd-2.2.11) ein

./configure --enable-so --enable-mime-magic --enable-cgi --prefix=/usr/local/apache
make
make install

aus.

Anschließend editieren Sie bitte die Konfigurationsdatei des Apache-Webserver
/usr/local/apache/httpd.conf. Geben Sie dort ein:

LoadModule php5_module modules/libphp5.so

AddType application/x-httpd-php .php .phtml

Achten Sie bitte unbedingt darauf, dass entweder der User des Apache (oder aber die Gruppe)
Inhaber des Ordners /usr/local/apache (und seiner Unterverzeichnisse) ist.
Wie der User/die Gruppe heissen steht in der Datei /usr/local/apache/httpd.conf.

Ein
ls -l im Ordner /usr/local

zeigt, an, wem aktuell der Ordner /usr/local/apache gehört.

Sollte z.B. der User "root" und auch die Gruppe "root" Inhaber sein, so ändern Sie dieses bitte mit:

chown -R root:daemon (je nachdem wie die Gruppe des Apache heißt) /usr/local/apache

Anschließend starten Sie einmal bitte den Apache mittels

/usr/local/xxxxxxxxxxxxx/apachectl start

und geben in Ihrem Browser ein:

http://localhost

Es müßte eine Meldung der Art von "It works" kommen.

=== PostgreSQL/PostGIS ===

Als nächstes installieren Sie einmal die PostgreSQL-Datenbank mit PostGIS-Aufsatz.

./configure --without-readline (sofern es Schwierigkeiten gibt die libreadline zu finden)
make
make install

Für die PostGIS-Installation entpacken Sie bitte den PostGIS-Ordner und benennen Sie ihn in "postgis".
Dieses funktioniert wie folgt:

mv postgis-1.3.5 postgis

Den umbenannten Ordner "postgis" kopieren Sie in den Ordner /opt/install/unzip/postgresql-8.3.5/contrib.

Dort führen Sie aus:

./configure –with-pgsql=/usr/local/pgsql/bin/pg_config
make
make install

Anschließend führen Sie bitte aus:

adduser postgres

(Ein Standarduser mit dem Namen „postgres“ wird angelegt,
Sie müssen hierfür auch ein Passwort festlegen)

mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data

(„postgres“ wird Besitzer des Verzeichnisses)

su – postgres

(Einloggen als user postgres)

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

(Datenbankschema wird initialisiert)

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start

(Start der Datenbank)

=== PHP ===

Sinnvoll ist es auf jeden Fall den Apache mit PHP zu nutzen, den aktuellen Quellcode bekommen Sie von
http://php.net/downloads.php) (5.2.8)

Dann wechseln Sie bitte in den entpackten Ordner des PHP-Quellcodes:

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-freetype-dir=/usr/lib
--with-jpeg-dir=/usr/local --with-png-dir=/usr/local --enable-shared --with-zlib --
enable-mbstring --with-gd --with-pgsql –prefix=/usr/local/php5

mkdir /usr/local/php5/extensions

(damit legen Sie ein Verzeichnis für PHP-Erweiterungen an, PHP/Mapscript wird hier später installiert)

cp /opt/install/unzip/php-5.2.3/php.ini-dist /usr/local/php5/lib/php.ini

Dann geben Sie in der php.ini ein:

extension_dir=/usr/local/php5/extensions

Um zu testen ob PHP funktioniert erstellen Sie eine Datei mit dem Inhalt

<? phpinfo(); ?>

nennen Sie diese "test.php" und legen Sie diese in den Ordner /usr/local/apache/htdocs
Anschließend rufen Sie auf: http://localhost/test.php
Wenn alles funktioniert erhalten Sie eine Ausgabe mit der aktuellen PHP-Version.

=== UMN MapServer ===

In den entpackten Quellen des UMN MapServers editieren Sie bitte die Datei mapsymbol.h
Standardmäßig ist die Anzahl der integrierbaren Symbole relativ niedrig.
Ändern Sie dieses z.B. wie folgt:

#define MS_SYMBOL_ALLOCSIZE 200

Zudem ändern Sie einmal die Datei mapserver.h

#define MS_LAYER_ALLOCSIZE 200
#define MS_CLASS_ALLOCSIZE 20
#define MS_STYLE_ALLOCSIZE 4
...
#define MS_MAXIMAGESIZE_DEFAULT 10000

Damit es keine Probleme mit dem dynamischen Linken der Bibliotheken gibt ändern Sie bitte noch die Datei

/etc/ld.so.conf

oder eine ähnliche Datei in /etc/ld.so.conf.d/ (je nach distribution)
Fügen Sie dort die Zeilen

/usr/local/bin
/usr/local/lib

ein.
Anschließend geben Sie den Befehl

ldconfig

ein.

Dann wechseln Sie in den Ordner des entpackten MapServers

./configure --with-ogr --with-gdal --with-wmsclient --with-wmsserver --with-wfsclient --with-wfs --with-tiff --with-jpeg
--with-png --with-freetype --with-proj --with-geos -with-libiconv=/usr --with-agg=/var/src/agg-2.5 --with-postgis=/usr/bin/pg_config
--with-threads --with-php=/usr/include/php5

...und geben Sie dann ein

make

ein. Wenn alles komipiliert wird geben Sie ein

./mapserv -v

und Sie erhalten Informationen über die Version. Kopieren Sie das binary "mapserv" in den Ordner /usr/local/apache/cgi-bin
und führen Sie aus.

http://localhost/cgi-bin/mapserv

Wenn dann die Meldung

==Änderungen==

Eine Liste der aktuellsten Änderungen am MapServer-Quellcode finden Sie auf der Website von DM Solutions~[[http:website:dmsolutions]] unter ''/mapserver/dl/mapserver_ChangeLog.txt'' . Dabei handelt es sich um eine Auflistung aller Kommentare, die von den Entwicklern bei der Änderung von Dateien im CVS hinzugefügt werden.

==CVS==\index{CVS}

Das CVS (Concurrent Versions System) ist ein System, mit dem Entwickler, die über ein Netzwerk verteilt sind, gemeinsam am gleichen Codebestand arbeiten können. So Sie auch keinen schreibenden Zugriff auf den MapServer-Code haben, so können Sie ihn sich dennoch lesend herunterladen und somit sozusagen immer 'on the bleeding edge' der MapServer-Entwicklung sein.

Seien Sie aber gewarnt: Da es sich um Code handelt, an dem aktiv herumentwickelt wird, kann er Macken haben. Es ist nicht einmal gesagt, dass er überhaupt kompiliert. Es kann zeitraubend sein, dann an dieser Stelle auf die Fehlersuche gehen zu müssen.

Geben Sie auf der Kommandozeile Ihrer Wahl ein:

 <code>
# export CVSROOT=:pserver:cvs@mapserver.gis.umn.edu:/data2/cvsroot
# cvs login
# cvs -z3 co mapserver
</code> 

Die Anfrage nach einem Paßwort beim Login können Sie mit einem simplen Druck auf die Return-Taste befriedigen.

Das Kommando =export= belegt die Umgebungsvariable (hier =CVSROOT= ), wenn Sie die Shell =bash= verwenden. Sollten Sie eine andere Shell benutzen, konsultieren Sie die Dokumentation dieser Shell, um mehr über das Setzen von Umgebungsvariablen herauszufinden.

=Installation von Binaries=

Die Installation von Binaries soll vor dem Kompilieren von Quelltexten genannt werden, da sie sich im allgemeinen wesentlich einfacher geriert. In den meisten Fällen sollte sich diese Art von Installation in wenigen Schritten abhandeln lassen.

==Binaries für Windows==(2)

Auf der Mapserver Website~[[http:website:mapserver]] gibt es die oben genannten Windows-Binaries herunterzuladen.

Wenn Sie das erste Archiv entpacken, finden Sie darin eine Menge ausfürbahrer Dateien, darunter auch das eigentliche MapServer-Binary =mapserver.exe= . Kopieren Sie diese Datei in das CGI-Verzeichnis Ihres Webservers. Was Sie mit den restlichen Programmen tun, die im wesentlichen auf der Kommandozeile von Nutzen sind, bleibt Ihnen überlassen. Einige von ihnen sind in Kapitel~\ref{text:tools} beschrieben.

Das zweite Archiv beinhaltet eine Menge DLLs, die Sie allesamt in das Systemverzeichnis zu kopieren sind; in einer Standardinstallation von Windows 2000 ist das beispielsweise =c:<math>\backslash</math>windows<math>\backslash</math>system32= .

Danach ist der MapServer einsazbereit.

==Binaries für Linux==

Vorkompilierte Binaries für Linux zu finden ist in den meisten Fällen nicht ganz einfach. Das hat verschiedene Gründe.

An erster Stelle steht die Vielfalt der Architekturen, auf denen Linux eingesetzt werden kann. Wenn Sie den MapServer auf einem 32-Bit Intel-System kompiliert haben, funktioniert es eben nur auf 32-Bit Intel-Systemen, aber schon nicht mehr unter dem Linux, das auf einer Sparc Station läuft.

Die vielen unterschiedlichen Versionen von Kernel und C-Systembibliotheken können dazu führen, dass Binaries nicht überall laufen. Und wenn sich dynamisch gelinkte Bibliotheken an anderen als den vorgesehenen Stellen befinden, ist wieder alles aus. Das führt dazu, dass viele Softwarehersteller, wenn sie Software für Linux anbieten, nur eine bestimmte Version eines bestimmten Herstellers unterstützen. Das ist natürlich ein hochgradig unbefriedigender Zustand.

\subsubsection*{RPM-basierte Linux-Systeme}\index{RPM}

Für RPM-basierte Intel-Systeme (beispielsweise von SuSE, Red Hat oder Mandrake) vom Prozessortyp Pentium oder neuer bietet die Firma intevation unter [[ftp:intevation:rpm]] Pakete zum Download an.

In dem Paket, das vollständig in einen eigenen Verzeichnisbaum unter =/opt/mapserver= installiert wird, befinden sich: das ROSA-Applet, das ein Java-Applet ist, das auf einen MapServer zurückgreift und einige Zusatzfunktionen wie das Zoomen auf eine aufziehbare Box bietet; das offizielle Itasca-Demo; diverse Sprachanbindungen und einiges an Dokumentation. Dazu kommt natürlich ein einsatzbereites MapServer-Binary zusammen mit einem kleinen Webserver namens =mini_httpd= .

Die Installation geht so schnell vonstatten, wie man es von RPM-Systemen kennt:

 <code>
# rpm --install mapserver-3.6.5-1.i386.rpm
</code> 

Über eventuelle Bibliotheksabhängigkeiten -- die dann grundsätzlich vom gleichen Ort herunterladbar sind -- informiert Sie die beiliegende Dokumentation. Zum Zeitpunkt der Drucklegung gab es noch kein aktualisiertes Paket für MapServer 4.0 auf dem FTP-Server; das kann sich inzwischen geändert haben.

\subsubsection*{Debian GNU/Linux}\index{Debian}

Für Debian gibt es über den Befehl
apt-get install mapserver-bin cgi-mapserver
die Möglichkeit den Mapserver auf einfachste Art und Weise zu installieren, doch aufgepasst: Die Debian-stable-Version hinkt in der Aktualität immer etwas nach. Zum Zeitpunkt der Bucherstellung war Version 5.2.1 aktuell, das auf diese Art und Weise installiete Debian-Paket jedoch lag noch bei Version 4.10.2.

=Die MapMedia MapServer Suite=

So einfach es auch ist, MapServer zu installieren, so kann es doch zuweilen recht zeitraubend sein, alle Beispielapplikationen zu installieren und anzupassen, Dokumentation zusammenzusuchen usw.

Um ein wenig Zeit zu sparen, gibt es von MapMedia, allerdings bisher nur für Windows, die MapServer Suite. Dabei handelt es sich im wesentlichen um ein Installationsprogramm, dass Ihnen den MapServer auf Ihrem System an den Start bringt, inklusive diverser Beispielapplikationen, MapLab und so weiter.

Mehr Informationen über die MapServer Suite finden Sie auf der Website von MapMedia~[[http:website:mapmedia]].

=Kompilieren der Quelltexte=(3)

Wir konzentrieren uns an dieser Stelle auf das Kompilieren der Software auf einem Linux-System. Anmerkungen zu anderen Plattformen, insbesondere Windows, werden an geeigneter Stelle eingeschoben. Generell fährt man unter Windows jedoch mit vorkompilierten Binaries besser. Detailliertere Dokumentation finden Sie beispielsweise im MapServer-Wiki; dort sind dann auch Details für andere Betriebssysteme vorhanden, beispielsweise MacOS~X.

Das Kompilieren der Quelltexte ist ein aufwendiger Vorgang, der einige Vorkenntnisse erfordert. Sie sollten mit einer Shell Ihrer Wahl umgehen können und mit der Installation von Software mittels =make= und ähnlichen Werkzeugen vertraut sein. Unter Umständen benötigen Sie auch einen Texteditor, um leichte Veränderungen in der einen oder anderen Datei vornehmen zu können

Einige der folgenden Pakete sind bereits Bestandteil der gängigsten Distributionen. Werfen Sie einen Blick in die Liste der installierten Pakete in Ihrem System, um herauszufinden, welche Pakete bereits vorhanden sind und daher nicht mehr installiert werden müssen.

Beachten Sie bitte, dass Sie für die Installation der ganzen bildverarbeitenden Pakete und so weiter ''keine X-Installation benötigen'' . Das Lesen und Schreiben von Bildern hat nichts mit ihrer Darstellung auf dem Bildschirm zu tun, und auf einem Webserver benötigt man sowieso keine grafische Oberfläche.

Zwingend notwendig sind für eine Kompilierung des MapServer die folgenden Pakete:

*Die Bibliothek GD in der Version 2, die das Rendern der Bilder übernimmt~[[http:website:gd]]. Beachten Sie bitte die Anmerkungen in Abschnitt~4, wenn Sie ein für Ihre fertigen Karten GIF als Ausgabeformat wünschen. GD kann im Moment JPEG und PNG produzieren\footnote{Und noch einige wenige andere, die aber für eine Darstellung im Webbrowser nicht von Interesse sind.}. MapServer 4.0 benötigt zwingend mindestens Version 2.0.12 der GD.

Mit diesen simplen Voraussetzungen können Sie bereits einen MapServer kompilieren, der Shapefiles lesen und Karten in diversen Formaten wie PNG, JPEG erzeugen kann, vorausgesetzt, die entsprechenden Grafikbibliotheken sind installiert.

Die folgenden Pakete sind zu empfehlen, falls man über diese simple Funktionialität hinaus etwas komplexere Anwendungen möchte:

*Die Projektionsbibliothek proj.4~[[http:website:libproj]], mit der Daten umprojiziert werden können. Zwingend notwendig, um OGC-konforme Funktionialitäten zu erhalten. Und natürlich, wenn man Daten umprojizieren will. Generell eine Sache, die man haben möchte.
*Die Bibliothek libtiff~[[http:website:tiff]], um das gängigste Karten-Rasterformat (mit Worldfiles) einlesen zu können. Bitte beachten Sie, dass Sie für das Format GeotTIFF eine weitere Bibliothek (libgeotiff) benötigen.
*FreeType~[[http:website:freetype]], für die Unterstützung von TrueType-Schriften. MapServer kann 'von Haus aus' nur mit einigen Bitmap-Schriften umgehen, die schlecht skalieren. Vor MapServer Version 4.0 war es zwingend notwendig, eine 1er-Version dieser Bibliothek zu verwenden. Dies war im wesentlichen der älteren GD-Version geschuldet, die in MapServer zum Einsatz kam. Die aktuelle Version 2 von GD muß eingesetzt werden, zusammen mit FreeType in der Version 2.
*libcurl~[[http:website:libcurl]], eine Bibliothek für den Dateitransfer über Protokolle wie HTTP, FTP und so weiter. Wird benötigt, um den MapServer als OGC-konformen Client fungieren zu lassen. Diese Bibliothek ersetzt mit Version 4.0 die bisher verwendete WWW-Bibliothek libwww~[[http:website:libwww]]. Sie benötigen mindestens Version 7.10.1.

Weitere, optionale Pakete für verschiedene Funktionen, die recht häufig zum Einsatz kommen:

*libgeotiff~[[http:website:geotiff]] zum Einlesen von GeoTiff-Bildern. Dieses Dateiformat unterscheidet sich von georeferenzierten Tiff-Bildern, die mit seperaten Worldfiles funktionierten.
*GDAL~[[http:website:gdal]], eine Bibliothek, die Zugriff auf diverse georeferenzierte Rasterformate ermöglicht. Bestandteil von GDAL ist die OGR (Simple Features Library), die Zugriff auf diverse Vektorformate ermöglicht.
*PostGIS~[[http:website:postgis]], eine Erweiterung für die Datenbank PostgreSQL; ähnlich ESRI ArcSDE oder den Oracle Spatial Extensions. Für die Installation von PostGIS benötigen Sie Zugriff auf den Quelltextbaum, aus dem PostgreSQL kompiliert worden ist -- für die PostGIS-Unterstützung im MapServer ist das nicht mehr nötig.

Und dann sind da noch die folgenden Bibliotheken, die aus verschiedenen Gründen zum Einsatz kommen können. Sie werden nicht (eventuell: noch nicht) so häufig angewendet.

*ming~[[http:website:ming]], eine Bibliothek zum Erzeugen von Flash-Output.
*pdflib~[[http:website:pdflib]], eine Bibliothek zum Erzeugen von PDF-Output. Bitte beachten Sie insbesondere die Lizenz dieser Software!
*Xerces~[[http:website:xerces]], eine XML-Bibliothek, die benötigt wird, um den MapServer als WFS-Client fungieren zu lassen.

Und wenn das noch nicht reicht, dann können Sie sich noch mit den eventuellen Abhängigkeiten der Bibliothek GDAL auseinandersetzen, mit der Sie Zugriff auf diverse, mehr oder weniger 'esoterische' Datenformate erlangen können. Werfen Sie einen Blick in Anhang~\ref{anhang:formate}, um herauszufinden, welche Formate eventuell für Sie interessant werden könnten.

==GD==(4)\index{GD}

Diese Grafikbibliothek ist für das Rendern der Bilder verantwortlich. MapServer erstellt eine Darstellung der fertigen Karte im Speicher. GD ist dann dafür verantwortlich, diese Darstellung in das gewünschte Bildformat zu überführen.

PNG ist das vorgegebene Bildformat in den aktuellen Versionen von GD. Ältere Versionen (1.6 und früher) produzierten noch GIF-Bilder. Wegen der Patente, die auf diesem Format liegen, entschied sich der Autor jedoch zu einem bestimmten Zeitpunkt, das Format fallen zu lassen und stattdessen PNG zu erzeugen, welches ein offen liegendes Format ist und keine Lizenzgebühren bei der vollständigen Implementierung benötigt. Aus Benutzersicht ist diese Entscheidung dahingehend nicht relevant, als jeder aktuelle Webbrowser dieses Format darstellen kann\footnote{Außer vielleicht lynx, links und andere kommandozeilenbasierte Browser. Diese können aber offensichtlich mit Karten generell nichts anfangen, egal in welchem Format sie vorliegen.}.

Vor Version 4.0 des MapServers war GD 1.8.4 die aktuelle Version. Diese Fassung der GD krankte an diversen Schwächen: insbesondere die Kompilierung und Installation war haarig, es wurde generell nur eine statische Fassung der Bibliothek erstellt und es gab nur Probleme mit der Zusammenarbeit aktueller Versionen der TrueType-Bibliothek FreeType. Außerdem war nicht in der Lage, Bilder mit mehr als 256 Farben zu produzieren.

Mit der Version 2 wurde das jedoch alles anders, und so können wir uns nun an Bildern in TrueColor und funktionierender Beschriftung erfreuen. Beim Schreiben dieser Zeilen ist die Version 2.0.15 die aktuellste; MapServer verlangt mindestens nach Version 2.0.12 der Bibliothek.

Beachten Sie bitte, dass es auch mit dieser Version der GD nicht möglich ist, GIF-Bilder zu produzieren.

Nach dem Entpacken des Archivs von~[[http:website:gd]] finden Sie im Verzeichnis ein ''configure'' -Skript (auch das eine Neuerung), das Sie etwa wie folgt aufrufen:

 <code>
root@box gd-2.0.15 <math> ./configure --with-png=/usr/local \
--with-freetype=/usr/local \
--with-jpeg=/usr/local \
--with-xpm=/usr/X11R6
root@box gd-2.0.15 </math> make
root@box gd-2.0.15 <math> make install
</code> 

Die Pfadangaben müssen natürlich angepaßt werden, je nachdem, wo die entsprechenden Pakete bei Ihnen installiert sind.

Obwohl MapServer später selber nach einer FreeType-Installation sucht, muß auch GD gegen FreeType gelinkt werden, falls Sie TrueType-Beschrifungen wünschen. Achten Sie unbedingt darauf, dass Sie den MapServer gegen die gleiche Version von FreeType linken, wie die GD.

==Proj.4-Unterstüzung==(5)\index{Proj.4}

Die Installation der Projektionsbibliothek proj.4 geht flott vonstatten. Dem Entpacken des Quellcodes folgt ein simples:

 <code>
root@box proj-4.4.7 </math> ./configure
root@box proj-4.4.7 <math> make
root@box proj-4.4.7 </math> make install
</code> 

Das war alles. Aktuelle Version ist Version 4.4.7.

==EPPL7-Unterstützung==

Die ''Environmental Planning Programming Language'' stammt aus einem älteren GIS der Universität von Minnesota. Um dieses Format lesen zu können, ist keine gesonderte Bibliothek notwendig; insbesondere ist die Unterstützung für dieses Format implizit im MapServer vorhanden, falls sie nicht explizit bei der Konfiguration der MapServer-Quellen abgeschaltet wird.

==Funktionalität als WMS-Server==

Die Fähigkeit, als WMS-Server zu fungieren, wird automatisch aktiviert, wenn dem Konfigurationsskript des MapServer die Unterstützung der Projektionsbibliothek proj.4 abgefordert wird (siehe weiter unten). Weitere Schritte sind nicht nötig. Sollten Sie WMS-Funktionalität nicht wünschen, müssen Sie diese später bei der Kompilierung des MapServers explizit ausschalten.

==Funktionalität als WMS-Client==(6)

Auch die Installation von curl geht erfreulich schnell und einfach vonstatten. Nach dem Entpacken des Archivs genügt

 <code>
root@box curl-7.10.7 <math> ./configure
root@box curl-7.10.7 </math> make
root@box curl-7.10.7 <math> make install
</code> 

um die Bibliotheken zu installieren. Aktuelle Version is 7.10.7.

==Funktionalität als WFS-Server==

Für WFS-Funktionalität in MapServer ist Unterstützung für GML in der Bibliothek GDAL vonnöten. Wie Sie diese Kombination aktivieren, erfahren Sie im nächsten Abschnitt über die Voraussetzungen für einen WFS-Client. Die GDAL-Version muß mindestens 1.1.8 sein.

Außerdem ist die Projektionsbibliothek ''proj.4'' in mindestens der Version 4.4.3 vonnöten.

==Funktionalität als WFS-Client==

Ein WFS-Client muß etwas mehr können als ein WFS-Server. Unter anderem muß er in der Lage sein, GML zu verarbeiten. GML ist die auf XML-basierende Sprache, in der sich WFS-konforme Systeme 'unterhalten'. Mehr zu GML und natürlich den restlichen WFS-Features sowie zur korrekten Konfiguration im Mapfile finden Sie in Abschnitt~\ref{text:ogc:wfs}.

Die GML-Unterstützung in MapServer wird mit der Bibliothek GDAL realisiert. GDAL verläßt sich bei GML jedoch auf noch eine weitere Bibliothek mit dem Namen Xerces, eine XML-Bibliothek, die Teil des Apache-Projekts ist.

Beim Kompiliervorgang verhält sich diese Bibliothek nicht ganz so, wie man es von einem Mechanismus wie =autoconf= gewohnt ist. Die Schritte sind wie folgt:

Zuerst muß eine Umgebungsvariable gesetzt werden, die das Verzeichnis des Quellbaums zum Inhalt hat. Am einfachsten ist es, das Archiv auszupacken, in das Verzeichnis zu wechseln und dann

 <code>
# cd xerces-c-src1_6_0
# export XERCESCROOT=`pwd`
</code> 

Wechseln Sie danach in das Unterverzeichnis =src= und führen das Skript =runConfigure= aus:

 <code>
# cd src
# ./runConfigure -p linux -c gcc -x g++ -r phtread -P /usr/local/GIS
</code> 

Der Parameter =-p= gibt dabei die Art des Systems an, die beiden nächsten Optionen bennenen die zu verwendenden Compiler. Mit =-P= schließlich wird das Verzeichnis für die Installation benannt.

Danach funktionieren =make= und =make install= wie gewohnt. Der nächste Schritt hiernach ist, GDAL so einzurichten, dass Xerces für GML benutzt wird. Die Schritte dafür finden Sie in Abschnitt~8 erklärt.

==Unterstützung für PostGIS==(7)\index{PostGIS}

PostGIS ist eine Erweiterung der freien Datenbank PostgreSQL für räumliche Vektordaten. Um PostGIS kompilieren zu können, müssen Sie Zugriff auf den Quelltextbaum haben, aus dem PostgreSQL kompiliert worden ist. Das reine Entpacken der PostgreSQL-Quellen reicht nicht! Aus offensichtlichen Gründen soll hier keine Zeit damit verbracht werden, auf die Kompilierung von PostgreSQL einzugehen.

Wechseln Sie in das Verzeichnis ''contrib'' der PostgreSQL-Quellen und entpacken Sie dort das PostGIS-Archiv:

 <code>
root@box postgresql-7.3.4 </math> cd contrib
root@box contrib <math> tar xzf postgis-0.7.5.tar.gz
</code> 

Wechseln Sie in das neu entstandene Verzeichnis und editieren Sie eventuell das Makfile:

*Setzen Sie die Variable ''USE_PG72'' auf 1, falls Sie PostgreSQL 7.2 anstatt 7.3 verwenden.
*Setzen Sie die Variable ''USE_PROJ'' auf 1, falls Sie Unterstützung für proj.4 in PostGIS haben wollen.

 <code>
root@box potsgis-0.7.5 </math> make
root@box potsgis-0.7.5 <math> make install
</code> 

Bevor PostGIS nun speziell für die gewünschte Datenbank in Betrieb genommen werden kann, muß die Prozeduralsprache PL/pgSQL für diese Datenbank aktiviert werden\footnote{Eine Prozeduralsprache (procedural language) stellt Schleifenkonstrukte und andere Kontrollstrukturen zur Verfügung, wo SQL nur Einzelbefehle kennt.}. Das geschieht am besten über das mit PostgreSQL mitgelieferte Skript:

 <code>
root@box ~ </math> createlang plpgsql <datenbankname>
</code> 

Nun ist diese Datenbank für PostGIS vorbereitet, und die entsprechenden Funktionen und so weiter können in die Datenbank eingelesen werden:

 <code>
root@box ~ <math> psql -f <datenbankname> postgis.sql
</code> 

Die Datei ''postgis.sql'' finden Sie natürlich im PostGIS-Quellverzeichnis.

\subsubsection*{Projektionen}

Wenn Sie möchten, können Sie in Ihrer Datenbank mit PostGIS-Unterstützung eine Tabelle mit EPSG-Codes anlegen, wie sie auch von proj.4 benutzt werden:

 <code>
root@box ~ </math> psql -f spatial_ref_sys.sql -d <datenbankname>
</code> 

Auch diese Datei befindet sich im PostGIS-Quellverzeichnis.

\subsubsection*{Upgrade}

Natürlich wird auch PostGIS weiterentwickelt. Irgendwann werden Sie dann eine alte Version gegen eine aktuelle austauschen wollen; das kann eventuell etwas schwierig werden. Die Webseite empfiehlt beim Versionswechsel musterhaft folgendes Vorgehen:

 <code>
# pg_dump -t "*" -f datei.sql <datenbankname>
# dropdb <datenbankname>
# createdb <datenbankname>
# createlang plpgsql <datenbankname>
# psql -f postgis.sql -d <datenbankname>
# psql -f datei.sql -d <datenbankname>
</code> 

Im Klartext: Speichern der Datenbank in einer Datei und dann Löschen der Datenbank; dann die Datenbank neu anlegen, PL/pgSQL-Unterstützung aktivieren, das ''neue'' postgis.sql einlesen und die gespeicherten Inhalte der Datenbank dann wieder einfügen.

==GDAL und OGR==(8)

GDAL und OGR sind Bibliotheken, die den Zugriff auf diverse Raster- bzw. Vektordateiformate realisieren. Zu dem Paket gehören auch kleine Utilities, die Sie dazu verwenden können, Informationen über Dateien in den unterstützten Formaten zu gewinnen und teilweise sogar ineinander zu konvertieren. Für MapServer ist natürlich interessant, die entsprechenden Formate als Datenquelle für einen Layer einlesen und teilweise sogar über ein entsprechend definiertes =OUTPUTFORMAT= auch produzieren zu können. Die neuste Version von GDAL~[[http:website:gdal]] ist im Moment 1.1.9.

Das =configure= -Skript von GDAL ist ziemlich gut darin, sich die Informationen über die installierten Bibliotheken zusammenzusuchen. Grundsätzlich genügt das folgende, bekannte Vorgehen:

 <code>
# tar xzf gdal-1.1.9.tar.gz
# cd gdal-1.1.9
# ./configure
# make
# make install
</code> 

Von besonderer Wichtigkeit ist in diesem Zusammenhang allerdings das Auffinden der XML-Bibliothek Xerces, die für die Unterstützung für GML im MapServer benötigt wird; siehe auch die Abschnitte über WFS-Server und WFS-Client weiter vorne. Falls GDAL nicht in der Lage ist, installierte Bibliotheken korrekt aufzufinden, kann man mit Optionen auf der Kommandozeile beim Konfigurieren nachhelfen. Nach einer gewissen Zeit schreibt man sich dann meist ein kleines Skript, insbesondere, wenn man -- wie der Autor -- gerne mit verschiedenen Dateiformaten experimentiert. Das kann dann zum Beispiel wie folgt aussehen:

 <code>
# ./configure --with-libz=/usr \
--with-cfitsio=/usr/local/GIS \
--with-png=/usr/local \
--with-jpeg=/usr \
--with-ogdi=/usr/local/GIS \
--with-xerces=/usr/local \
--without-jasper \
--with-libtiff=/usr/local \
--with-geotiff=/usr/local/GIS \
--with-grass=/usr/local/GIS
</code> 

Hier werden praktisch alle Bibliotheken explizit angegeben. Neben der Möglichkeit, installierte Bibliotheken explizit vom Kompilierungsprozess auszunehmen (wie hier geschehen mit der JPEG2000-Bibliothek Jasper) und den vielen verschiedenen Orten, an denen die Bibliotheken zu finden sind, ist in diesem Beispiel insbesondere die Konfiguration mit der TIFF-Bibliothek zu nennen. MapServer ist nur dann in der Lage, Rasterdaten umzuprojizieren, wenn das entsprechende Format lesend von GDAL unterstützt wird. Insbesondere darf dann aber der MapServer selber dann nicht mehr gegen die TIFF-Bibliothek gelinkt werden! Mehr dazu finden Sie weiter unten, wenn es um die Kompilierung des MapServers geht.

==Unterstützung für PDF-Output==

Für den PDF-Output bedient sich MapServer der Bibliothek PDFLib~[[http:website:pdflib]].

Auch für diese Bibliothek genügt das simple Vorgehen:

 <code>
# ./configure
# make
# make install
</code> 

Neben der Bibliothek werden auch gleich noch einige Sprachbindungen installiert, sodass Sie die Schnittstellen nicht nur von C-Programmen aus nutzen können, sondern auch gleich von C++, Perl, Python und einigen anderen Sprachen an die Bibliothek herankönnen. Zu den unterstützten Sprachen gehört auch PHP; für diese Skriptsprache wird aber die Schnittstelle während der Kompilierung von PHP erstellt, sodass hier zuerst PDFLib installiert sein muß, und erst später PHP richtig konfiguriert werden muß.

Beachten Sie bitte, dass diese Bibliothek für den kommerziellen Einsatz nicht kostenfrei ist. Details zur Lizensierung der Software finden Sie auf deren Website. Des weiteren hat der Autor bisher noch keine Tests mit der aktuellsten Version 5 der PDFLib vorgenommen, sodass keine Aussage getroffen werden kann, ob sie ebenso reibungslos ihre Arbeit tut, wie die 4er-Versionen.

==Unterstützung für Shockwave Flash==(9)\index{Flash}\index{ming}

Für die Erzeugung von Flash-Dateien greift MapServer auf die Bibliothek Ming zurück, die von~[[http:website:ming]] bezogen werden kann.

Nach dem Entpacken läuft die Installation leider nicht mit einem =configure= -Skript ab. Vielmehr existiert nur ein Makefile, an dem Sie aber keine großen Änderungen vornehmen müssen. Lediglich der Präfix für die Installation muß gesetzt werden. Wenn Sie die Bibliothek innerhalb von =/usr= installiert haben wollen, müssen Sie gar keine Änderung vornehmen.

Danach reicht:

 <code>
# make
# make install
</code> 

Die Bibliothek hat übrigens einige Durststrecken hinter sich, was die Veröffentlichung neuer Versionen anbelangt; genau so eine Durststrecke besteht auch im Moment, denn es ist über ein Jahr seit der letzten Änderung vergangen.

==Kompilieren des MapServers==(10)

Nachdem alle Vorarbeiten erledigt sind, können Sie sich endlich auf das Kompilieren des MapServers stürzen. Entpacken Sie zuerst das Paket:

 <code>
# tar xzvf mapserver-4.0.tar.gz
# cd mapserver-4.0
</code> 

In diesem Verzeichnis können Sie sich alle möglichen Optionen für die Konfiguration ausgeben lassen:

 <code>
# ./configure --help
</code> 

Für eine Basiskonfiguration benötigen Sie lediglich:

 <code>
# ./configure --with-gd=/usr/local \
--with-proj=/usr/local \
--with-freetype=/usr/local
</code> 

Die Verzeichnisangaben sind dabei die Installationsverzeichnisse der Bibliotheken, die Sie je nach Konfiguration Ihres Systems anpassen müssen.

Wenn Sie den MapServer entweder als WMS-Client oder als Server verwenden möchten, benötigen Sie die beiden folgenden Angaben:

 <code>
--with-wms-server \
--with-wms-client
</code> 

Sie können natürlich beide Dinge gleichzeitig in den MapServer einkompilieren. Funktionalität als WMS-Server wird übrigens stillschweigend vorausgesetzt, sobald Sie die Projektionsbibliothek einbinden.

Die Unterstützung für GDAL beziehungsweise PostGIS aktivieren Sie folgendermaßen:

 <code>
--with-postgis=/usr/bin/pg_config \
--with-gdal=/usr/bin/gdal-config
</code> 

Für PostGIS ist der benötigte Parameter der komplette Pfadname zum PostgreSQL-Konfigurationsprogramm =pg_config= . Die Option für GDAL fragt lediglich nach dem Pfad zum Konfigurationsprogramm =gdal-config= , ohne den Programmnamen selber angeben zu müseen.

Wenn Sie zusätzlich noch PHP MapScript kompilieren möchten, benötigen Sie Zugriff auf den Quelltext der von Ihnen verwendeten PHP-Version. Dann kommen noch diverse Optionen dazu:

 <code>
--with-php=/usr/src/php-4.3.3
</code> 

Hinweise zu den Einschränkungen, was die Konfiguration von PHP betrifft, finden Sie in einem Abschnitt weiter unten.

Das Kompilieren wird schließlich angestoßen mit:

 <code>
# make
</code> 

Sie können nun den Bildschirmausgaben eine Weile zusehen.

Wenn der Vorgang reibunglos durchgelaufen ist, finden Sie im Quelltextverzeichnis das fertige Binary. Sie können es mit dem Parameter =-v= ausführen, um zu sehen, ob alle geforderten Eingenschaften einkompiliert worden sind:

 <code>
# ./mapserv -v
MapServer version 4.0 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP OUTPUT=PDF
OUTPUT=SWF SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER
SUPPORTS=WMS_CLIENT SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT
INPUT=EPPL7 INPUT=JPEG INPUT=POSTGIS INPUT=OGR INPUT=GDAL
INPUT=SHAPEFILE
</code> 

Die Parameter sprechen in diesem Beispiel für sich.

Kopieren Sie nun das fertige Binary in das CGI-Verzeichnis Ihres Webservers und Sie sind fertig. Was Sie mit den Zusatzprogrammen machen, die sich ebenfalls im Quelltextverzeichnis befinden, ist im wesentlichen Ihre Sache -- sinnvoll ist es natürlich, sie in ein Verzeichnis zu kopieren, dass sich in der Liste Ihrer =PATH= -Variablen befindet, damit Sie sie von jeder Stelle im Dateisystem aus ausführen können.

=MapScript=

Das Kompilieren von MapScript kann eine Wissenschaft für sich sein. Im folgenden sollen Sie trotzdem den Überblick darüber gewinnen, wie der Vorgang aussieht.

==Binaries==

Vorkompilierte MapScript-Pakete sind eigentlich so gut wie kaum zu finden. Das liegt wahrscheinlich daran, dass die einzelnen Installationen von Webserver und PHP so unterschiedlich sind, dass sich eine Distribution von Binärpaketen kaum lohnen würde.

Die Firma DM Solutions hatte bis vor einiger Zeit noch vorkompilierte Pakete für PHP MapScript auf ihrer Downloadseite, aber für MapServer 4.0 ist dort bis jetzt noch nichts zu finden.

FIXME

==Aus den Quellen==

Die Installation von MapScript aus dem Quellcode soll -- schon wie bei der Beschreibung des MapServer-Quellcodes weiter oben -- hier für ein Unix-System gezeigt werden.

FIXME

Beachten Sie bitte auch, dass die PHP-Fassung von MapScript die am besten dokumentierte und am meisten gepflegte Fassung ist.

\subsubsection*{PHP}(11)

Zunächst scheint alles ganz einfach zu sein. Das Kompilieren von PHP MapScript ist einfach ein Schalter bei der Kompilierung des MapServers. Wenn Sie also wie in Abschnitt~10 beschrieben vorgehen, können Sie den Parametern einfach einen weiteren hinzufügen:

 <code>
# ./configure [...] --with-php=/usr/src/php-4.3.3
</code> 

Damit geben Sie an, in welchem Verzeichnis die Quellen von PHP liegen.

Eventuell erkennen Sie an dieser Stelle, dass einige Schwierigkeiten auf Sie zukommen. Sollten Sie PHP nicht selber aus den Quellen kompiliert haben, dann haben Sie natürlich auch dieses Verzeichnis nicht. Des weiteren müssen Sie natürlich, wenn Sie PHP aktualisieren, auch MapScript neu bauen. So kann eine Aktualisierung einen ganzen Rattenschwanz weiterer Updates nach sich ziehen, die natürlich beim Selberkompilieren entsprechend aufwendiger sind.

Zwei weitere Einschränkungen müssen Sie außerdem noch kennen. Zum einen funktioniert MapScript im Moment nicht mit einer modularen Version von PHP. PHP ''muß'' als CGI-Programm installiert sein. Wie Sie das bewerkstelligen, entnehmen Sie der PHP-Dokumentation.

Desweiteren muß PHP davon abgehalten werden, seine eigenen Routinen für reguläre Ausdrücke zu verwenden. Das geschieht beim Kompilieren von PHP, indem man =./configure= den Parameter =--with-regex=system= mitgibt. Falls diese Option nicht benutzt wird, beschwert sich MapServer bereits beim eigenen =configure= -Vorgang und bricht ab.

Beachten Sie, dass Sie für die Anbindung an PostGIS-Datenbanken keine Unterstützung für PostgreSQL in PHP benötigen. MapScript wird direkt gegen die PostGIS-Bibliotheken gelinkt.

Wie Sie dann mit PHP MapScript arbeiten, ist in Kapitel~\ref{text:mapscript} erklärt.

\subsubsection*{Die Anderen}

Die MapScript-Module für andere Programmiersprachen werden anders gehandhabt. Sie werden mithilfe des Interface-Generators SWIG~[[http:website:swig]] erstellt.

Das Konzept von SWIG sieht folgendermaßen aus: Sie erstellen Code, beispielsweise in C. Dieser Code kann wiederum gegen andere Bibliotheken gelinkt sein, wenn Sie möchten. Im Fall von MapScript beispielsweise liegt der MapServer-Code auf verschiedene Dateien verteilt vor, und darüberhinaus wird die Bibliothek GD hinzugelinkt.

Als nächstes erstellt man eine sogenannte Interfacedatei für SWIG, die die Endung =.i= trägt. Hier definieren Sie, wie die Aufrufe von Funktionen aus der anderen Programmiersprache heraus aussehen soll. So gibt es zum Beispiel in dieser Datei bei der Definition des Layer-Objektes folgende Zeilen:

 <code>
int queryByRect(mapObj *map, rectObj rect) {
return msQueryByRect(map, self->index, rect);
}
</code> 

Die nach außen hin sichtbare Methode =queryByRect= des Layer-Objektes ruft also intern die Funktion =msQueryByRect= auf.

Im Fall von MapScript wird die Interfacedatei bereits mitgeliefert, sie hat den Namen =mapscript.i= .

\subsubsection*{Perl}

Am Beispiel von Perl soll nun gezeigt werden, wie SWIG sodann im Detail gehandhabt wird. Sie wechseln in das Unterverzeichnis =mapscript/= in Ihrem MapServer-Quellcodeverzeichnis und führen aus:

 <code>
# swig -perl -DSHADOW mapscript.i
</code> 

Dieser Vorgang produziert eventuell einige Warnungen, die jedoch ignoriert werden können.

Sie werden in dem Verzeichnis nun zwei neue Dateien finden: einmal =mapscript_wrap.c= , und dazu eine sprachenabhängige Datei. Im Fall von Perl ist das =mapscript.pm= . Diese beiden Dateien kopieren Sie sich nun in das Unterverzeichnis der Sprache Ihrer Wahl, hier also nach =perl/= .

Nachdem Sie nun selber in dieses Verzeichnis gewechselt sind, können Sie ganz einfach den normalen Vorgang für die Installation eines Moduls in der jeweiligen Sprache anstoßen. Für Perl ist das:

 <code>
# perl Makefile.PL
# make
# make install
</code> 

Spätestens für den letzten Schritt müssen Sie Schreibrechte im Perl-Installationsverzeichnis besitzen.

[[Category:UMN MapServer Handbuch]]