OSGeo - User contributions [en]

File:A73aaac82.9940942,2.jpg

2011-05-31T13:58:13Z

Wiki-Peter panther: uploaded a new version of "File:A73aaac82.9940942,2.jpg"

Florian Thürkow

Komitee für Bildung und Dokumentationserstellung

2009-10-03T09:59:20Z

Wiki-Peter panther: /* 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)]

* [http://www.selbstverwaltung-bundesweit.de/java_umn/java_umn.pdf Einführung Java-Programmierung mit UMN MapServer]

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 Fehler

2009-04-01T14:53:37Z

Wiki-Peter panther:

= Fehler (Florian Thürkow)

Den größten Fehler, den man im Leben machen kann, ist, immer Angst zu haben, einen Fehler zu machen. (Dietrich Bonhoeffer)

=drawEPP(): EPPL7 support is not available=

Diesen Fehler erhalten Sie, wenn Sie keine EPPL7-Daten (Raster) verwenden, obwohl Sie es angegeben haben.
Der UMN MapServer versucht Rasterdaten mit allen zugehörigen Treibern (evtl. bei der Installation mit with einkompiliert) anzuzeigen,
wobei der EPPL-Treiber einer der letzten Treiber in der Versuchsreihe ist.
Andere Möglichkeiten die diesen Fehler hervorrufen:
Der MapServer wirft eine Ausnahmebehandlung (Exception) oder versucht ein Bild in einem unbekannten Format zurückzugeben.

=loadMapInternal(): Given map extent is invalid=
Der Fehler wird angezeigt, sobald Ihr Mapfile (bzw. bestimmte Layer) vom MapServer geladen und dabei
fehlerhafte Angaben (ungültiger Extent) festgestellt werden.
Dieser Fehler tritt ebenfalls auf, wenn z.B. minx größer als maxx (miny größer als maxy) ist.
Punkte die nach Auftreten des Fehlers überprüft werden sollten:
- Extent des MapFiles
- Extent der Layer
- wms_extent
Sollten Sie nicht wissen wie Sie an den Extent eines gegebenen MapFiles kommen, mit Hilfe von:
ogrinfo hamburg.shp hamburg -summary
erhalten Sie unter Anderem auch den Extent.

=msSaveImageGD(): Unable to access file=
Wie Sie wissen generiert der MapServer anhand des MapFiles ein Bild zur Ausgabe. Sollte
dieses Bild nicht generiert werden können, erscheint diese Fehlermeldung. Prüfen
Sie folgende Dinge:
-IMAGEPATH und IMAGEURL im MapFile
-(cgi-Mode) gesetzte Variablen im Quellcode
-Linux/Unix: WWW-Benutzer sollte Schreibrechte auf den IMAGEPATH haben

=msLoadMap(): Failed to open map file=
Der MapServer kann das MapFile nicht finden und hat daher auch Probleme das Bild zuliefern.
Stellen Sie sicher, dass der Pfad zum MapFile korrekt angegeben wurde und/oder die
Leserechte gesetzt sind.

=msQueryByPoint: search returned no results=
Das sogenannte Query-Feature erlaubt Ihnen die genaue Abfrage von Attributen Ihrer Geodaten. Hierzu definieren Sie
im entsprechenden Layer ein Template, welches zu einer HTML- oder PHP-Teil führt. Wenn die Stelle allerdings keine
Attribute innerhalb der spezifischen Geodaten findet, erscheint dieser Fehler.

=msLoadFontset(): Error opening fontset=
Wenn Sie ein FONTSET im Mapfile angegeben haben, kann der MapServer dieses entweder
nicht finden oder hat Probleme die Datei zu laden. Überprüfen Sie in jedem Fall
die Korrektheit des Pfades im Mapfile.

=msGetLabelSize(): Requested font not found=
Wenn Sie bestimmte Schriftarten für die Beschriftung von Daten
benutzen und der MapServer diese nicht finden kann, erscheint die oben
genannte Fehlermeldung. Überprüfen Sie die Pfadangabe von FONTSET im
Mapfile.

=msProcessProjection(): No such file or directory=
Dieser Fehler erscheint, wenn die angegebene EPSG-Datei nicht gefunden wird.
Unter Windows liegt diese unter: c:\proj\nad. Nutzer des MS4W Paketes sollten die Datei unter: \ms4w\proj\nad
ablegen. Beachten Sie auch die Definition im Mapfile. Es ist ein Unterschied ob
Sie init=epsg:4326 oder init=EPSG:4326 schreiben, da der Mapserver hier zwischen
Groß-und Kleinschreibung unterscheidet und dann die jeweilige Form im Dateisystem
sucht.

[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Fehler

2009-04-01T14:47:30Z

Wiki-Peter panther:

HBUMNMapServer ger Capter Fehler

2009-04-01T14:44:52Z

Wiki-Peter panther:

= Fehler (Florian Thürkow)

Den größten Fehler, den man im Leben machen kann, ist, immer Angst zu haben, einen Fehler zu machen. (Dietrich Bonhoeffer)

=drawEPP(): EPPL7 support is not available=

Diesen Fehler erhalten Sie, wenn Sie keine EPPL7-Daten (Raster) verwenden, obwohl Sie es angegeben haben.
Der UMN MapServer versucht Rasterdaten mit allen zugehörigen Treibern (evtl. bei der Installation mit with einkompiliert) anzuzeigen,
wobei der EPPL-Treiber einer der letzten Treiber in der Versuchsreihe ist.
Andere Möglichkeiten die diesen Fehler hervorrufen:
Der MapServer wirft eine Ausnahmebehandlung (Exception) oder versucht ein Bild in einem unbekannten Format zurückzugeben.

=loadMapInternal(): Given map extent is invalid=
Der Fehler wird angezeigt, sobald Ihr Mapfile (bzw. bestimmte Layer) vom MapServer geladen und dabei
fehlerhafte Angaben (ungültiger Extent) festgestellt werden.
Dieser Fehler tritt ebenfalls auf, wenn z.B. minx größer als maxx (miny größer als maxy) ist.
Punkte die nach Auftreten des Fehlers überprüft werden sollten:
- Extent des MapFiles
- Extent der Layer
- wms_extent
Sollten Sie nicht wissen wie Sie an den Extent eines gegebenen MapFiles kommen, mit Hilfe von:
ogrinfo hamburg.shp hamburg -summary
erhalten Sie unter Anderem auch den Extent.

=msSaveImageGD(): Unable to access file=
Wie Sie wissen generiert der MapServer anhand des MapFiles ein Bild zur Ausgabe. Sollte
dieses Bild nicht generiert werden können, erscheint diese Fehlermeldung. Prüfen
Sie folgende Dinge:
-IMAGEPATH und IMAGEURL im MapFile
-(cgi-Mode) gesetzte Variablen im Quellcode
-Linux/Unix: WWW-Benutzer sollte Schreibrechte auf den IMAGEPATH haben

=msLoadMap(): Failed to open map file=
Der MapServer kann das MapFile nicht finden und hat daher auch Probleme das Bild zuliefern.
Stellen Sie sicher, dass der Pfad zum MapFile korrekt angegeben wurde und/oder die
Leserechte gesetzt sind.

=msQueryByPoint: search returned no results=
Das sogenannte Query-Feature erlaubt Ihnen die genaue Abfrage von Attributen Ihrer Geodaten. Hierzu definieren Sie
im entsprechenden Layer ein Template, welches zu einer HTML- oder PHP-Teil führt. Wenn die Stelle allerdings keine
Attribute innerhalb der spezifischen Geodaten findet, erscheint dieser Fehler.

=msLoadFontset(): Error opening fontset=
Wenn Sie ein FONTSET im Mapfile angegeben haben, kann der MapServer dieses entweder
nicht finden oder hat Probleme die Datei zu laden. Überprüfen Sie in jedem Fall
die Korrektheit des Pfades im Mapfile.

=msGetLabelSize(): Requested font not found=
Wenn Sie bestimmte Schriftarten für die Beschriftung von Daten
benutzen und der MapServer diese nicht finden kann, erscheint die oben
genannte Fehlermeldung. Überprüfen Sie die Pfadangabe von FONTSET im
Mapfile.

=loadLayer(): Unknown identifier. Maximum number of classes reached=
[[Category:UMN MapServer Handbuch]]

HBUMNMapServer ger Capter Fehler

2009-04-01T14:40:14Z

Wiki-Peter panther:

HBUMNMapServer ger Capter Fehler

2009-04-01T14:34:03Z

Wiki-Peter panther: /* msSaveImageGD(): Unable to access file */

User:Peter panther

2009-02-19T22:11:15Z

Wiki-Peter panther:

Florian Thürkow

Mitarbeiter am Helmholtz Zentrum für Umweltforschung

florian.thuerkow@ufz.de

www.ufz.de

Permoserstr. 15

04318 Leipzig

[[Image:A73aaac82.9940942,2.jpg]]

File:A73aaac82.9940942,2.jpg

2009-02-19T22:10:34Z

Wiki-Peter panther: Florian Thürkow

Florian Thürkow

User:Peter panther

2009-02-19T22:08:19Z

Wiki-Peter panther:

Florian Thürkow

Mitarbeiter am Helmholtz Zentrum für Umweltforschung

florian.thuerkow@ufz.de

www.ufz.de

Permoserstr. 15

04318 Leipzig

[[Image:http://www.xing.com/img/users/b/1/f/a73aaac82.9940942,2.jpg]]

HBUMNMapServer ger Capter Bezug

2009-02-19T22:03:05Z

Wiki-Peter panther: /* Bibliotheken */

HBUMNMapServer ger Capter Fehler

2009-02-15T20:16:08Z

Wiki-Peter panther:

HBUMNMapServer ger Capter Fehler

2009-02-15T20:06:54Z

Wiki-Peter panther: New page: = Fehler (Florian Thürkow) Den größten Fehler, den man im Leben machen kann, ist, immer Angst zu haben, einen Fehler zu machen. (Dietrich Bonhoeffer) =drawEPP(): EPPL7 support is not ...

HBUMNMapServer ger Capter Bezug

2009-01-24T11:45:26Z

Wiki-Peter panther: /* 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.

==Vorkompilierte Binaries==

===Windows===

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden Pakete

ms4w

osgeo4w

===Linux===

FGS & Co.

==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

Die Installation des Mapservers ist nicht trivial, da diese in Abhängigkeit vom verwendeten Betriebssystem und der Erfahrung des Benutzers immer eine Individuelle ist.
Die praktischen Tests ergaben folgendes Fazit: Die Reihenfolge, in der die einzelnen Pakete installiert werden, ist für die erfolgreiche Installation entscheidend. Tabelle 1 vermittelt einen Überblick über den in der Praxis evaluierten Installationsvorgang des Mapservers.

{|
| Reihenfolge
| Bibliothek
| Version
| Optional (j/n)
| Link
|-
| 1 zlib 1.2.3 n www.zlib.net
| 2 libpng 1.2.32 n www.libpng.org/pub/png
| 3 libJPEG 6 j www.ijg.org/files
| 4 Freetype 2.3.5 j www.freetype.org
| 5 GD 2.0.35 j www.libgd.org
| 6 Proj.4 4.5.0 j http://proj.maptools.org
| 7 GDAL 1.4.2 j www.gdal.org
| 8 shapelib 1.2.9 j http://shapelib.maptools.org
| 10. Mapserver 4.10.3 http://mapserver.gis.umn.edu
|}

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.

=Kompilieren der Quelltexte=(3)

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

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

==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:

=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-24T11:40:45Z

Wiki-Peter panther: /* 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.

==Vorkompilierte Binaries==

===Windows===

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden Pakete

ms4w

osgeo4w

===Linux===

FGS & Co.

==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

Die Installation des Mapservers ist nicht trivial, da diese in Abhängigkeit vom verwendeten Betriebssystem und der Erfahrung des Benutzers immer eine Individuelle ist.
Die praktischen Tests ergaben folgendes Fazit: Die Reihenfolge, in der die einzelnen Pakete installiert werden, ist für die erfolgreiche Installation entscheidend. Tabelle 1 vermittelt einen Überblick über den in der Praxis evaluierten Installationsvorgang des Mapservers.

{|
| Reihenfolge
| Bibliothek
| Version
| Optional (j/n)
| Link
|-
| 1 zlib 1.2.3 n www.zlib.net
| 2 libpng 1.2.32 n www.libpng.org/pub/png
|}

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.

=Kompilieren der Quelltexte=(3)

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

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

==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:

=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-24T11:36:24Z

Wiki-Peter panther: /* 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.

==Vorkompilierte Binaries==

===Windows===

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden Pakete

ms4w

osgeo4w

===Linux===

FGS & Co.

==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

Die Installation des Mapservers ist nicht trivial, da diese in Abhängigkeit vom verwendeten Betriebssystem und der Erfahrung des Benutzers immer eine Individuelle ist.
Die praktischen Tests ergaben folgendes Fazit: Die Reihenfolge, in der die einzelnen Pakete installiert werden, ist für die erfolgreiche Installation entscheidend. Tabelle 1 vermittelt einen Überblick über den in der Praxis evaluierten Installationsvorgang des Mapservers.

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.

=Kompilieren der Quelltexte=(3)

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

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

==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:

=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-24T11:35:15Z

Wiki-Peter panther:

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

==Vorkompilierte Binaries==

===Windows===

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden Pakete

ms4w

osgeo4w

===Linux===

FGS & Co.

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

=Kompilieren der Quelltexte=(3)

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

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

==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:

=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-24T11:34:38Z

Wiki-Peter panther:

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

Die Installation des Mapservers ist nicht trivial, da diese in Abhängigkeit vom verwendeten Betriebssystem und der Erfahrung des Benutzers immer eine Individuelle ist.
Die praktischen Tests ergaben folgendes Fazit: Die Reihenfolge, in der die einzelnen Pakete installiert werden, ist für die erfolgreiche Installation entscheidend. Tabelle 1 vermittelt einen Überblick über den in der Praxis evaluierten Installationsvorgang des Mapservers.

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

==Vorkompilierte Binaries==

===Windows===

Für Windows erhalten Sie von der oben genannten Website die beiden folgenden Pakete

ms4w

osgeo4w

===Linux===

FGS & Co.

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

=Kompilieren der Quelltexte=(3)

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

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

==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:

=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]]

User:Peter panther

2008-05-24T17:38:38Z

Wiki-Peter panther:

Florian Thürkow

Mitarbeiter am Helmholtz Zentrum für Umweltforschung

florian.thuerkow@ufz.de

www.ufz.de

Permoserstr. 15

04318 Leipzig

HBUMNMapServer ger

2008-05-24T17:38:12Z

Wiki-Peter panther: /* Inhaltsverzeichnis des 'neuen' Handbuchs */

= Links =
* [[UMNHB_ger_Lizenzen | Klärung der Lizenzfrage]]
* [[ Komitee_f%C3%BCr_Bildung_und_Dokumentationserstellung | Komitee für Bildung und Dokumentationserstellung ]]

__TOC__

= Inhaltsverzeichnis des 'aktuellen' Handbuchs =

1 Einfährung 
1.1 Aufbau dieses Buches 
1.2 Was ist ein Mapserver? 
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 
2 Mapﬁle 
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 
2.5 Layer 
2.5.1 Gruppierungen von Layern 
2.5.2 Weitere Layer-Optionen 
2.6 Classes 
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 
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¨ abe 
2.15 Legenden 
2.15.1 Die klassische MapServer-Legende 
2.15.2 HTML-Legenden 
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¨ anken . 
2.23.2 Variablensubstitution 
3 OGC-Konformit¨ at
3.1 Warum macht man das? 
3.2 Web Mappping Server (WMS) 
3.2.1 Servermodi . 
3.2.2 Der aufrufende URL 
3.2.3 WMS-Metadaten im Mapﬁle . 
3.2.4 Exceptions 
3.2.5 getFeatureInfo 
3.2.6 WMS Clients 
3.2.7 Exceptions 
3.2.8 Hinweise 
3.3 Web Feature Server (WFS) 
3.3.1 WFS Server 
3.3.2 Projektionen in WFS-Servern 
3.3.3 Schemas 
3.3.4 Aufruf & Capabilities 
3.3.5 WFS Client 
3.4 Map Context 
3.4.1 Das Context-Dokument 
3.4.2 Den Kontext verwenden 
4 Datenbankanbindungen 
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 
5 Demos 
5.1 Itasca 
5.2 GMap 
6 MapScript 
6.1 PHP MapScript 
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.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.17 Struktur von PHP MapScript-Seiten 
6.1.18 Speichern von Map-Objekten in PHP-Sessions 
6.1.19 Speicherverwaltung mit MapScript 
6.2 Weitere Sprachen 
6.2.1 Perl 
6.2.2 Java 
6.2.3 Python 
7 Zus¨ atzliche 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.3 Werkzeuge der GDAL-Bibliothek 
7.3.1 gdaltindex . 
II Anhang 
A Referenz 
A.1 Limits 
A.2 Organisation der Daten 
A.3 ¨ Anderungen 
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.5 CGI-Parameter 
A.5.1 Normale Parameter . 
A.5.2 CGI-Modus . 
A.5.3 Parameter für Java-Applets 
B Bezug und Installation 
B.1 Bezug 
B.1.1 Vorkompiliert 
B.1.2 Quelltexte 
B.1.3 ¨ Anderungen 
B.1.4 CVS . 
B.2 Installation von Binaries 
B.2.1 Binaries für Windows 
B.2.2 Binaries für Linux . . . 
B.3 Die MapMedia MapServer Suite 
B.4 Kompilieren der Quelltexte 
B.4.1 GD 
B.4.2 Proj.4-Unterstüzung 
B.4.3 EPPL7-Unterstützung 
B.4.4 Funktionalit¨ at als WMS-Server 
B.4.5 Funktionalit¨ at als WMS-Client 
B.4.6 Funktionalit¨ at als WFS-Server 
B.4.7 Funktionalit¨ at als WFS-Client 
B.4.8 Unterstützung für PostGIS 
B.4.9 GDAL und OGR 
B.4.10 Unterstützung für PDF-Output 
B.4.11 Unterstützung für Shockwave Flash 
B.4.12 Kompilieren des MapServers 
B.5 MapScript 
B.5.1 Binaries . . 
B.5.2 Aus den Quellen 
C Migration 239
C.1 Von Version 3.6 nach Version 4.0 
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 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 Tips zur Performance 
E.1 Vermeiden Sie unn¨ otige Funktionalität 
E.2 Nutzen Sie MINSCALE und MAXSCALE 
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 
F 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.2 Schreibbare Formate 
F.3 Nicht unterstützte Formate 
G MapServer im Internet 
G.1 Website 
G.2 Mailinglisten 
G.2.1 Archiv 
G.2.2 Wiki 
G.3 Beispielseiten 
G.3.1 Capabilities XML 
H 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 

= Inhaltsverzeichnis des 'neuen' Handbuchs =

- Änderungen bitte unter das jeweilige Thema fett schreiben 
- Zuständigkeiten / Autoren im besten Fall mit angeben 

1 Einführung 
1.1 Aufbau dieses Buches 
1.2 Was ist ein Mapserver? 
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 
2 Mapﬁle 
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 
2.5 Layer 
2.5.1 Gruppierungen von Layern 
2.5.2 Weitere Layer-Optionen 
'''2.5.3 Diagramme (Kai Behncke? / Nicol Hermann)''' 
2.6 Classes 
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 
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 
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¨ anken . 
2.23.2 Variablensubstitution 
3 OGC-Konformit¨ at
3.1 Warum macht man das? 
3.2 Web Mappping Server (WMS) 
3.2.1 Servermodi . 
3.2.2 Der aufrufende URL 
3.2.3 WMS-Metadaten im Mapﬁle . 
3.2.4 Exceptions 
3.2.5 getFeatureInfo 
3.2.6 WMS Clients 
3.2.7 Exceptions 
'''3.2.8 Styled Layer Descriptor (SLD)''' 
3.2.9 Hinweise 
3.3 Web Feature Server (WFS) 
3.3.1 WFS Server 
3.3.2 Projektionen in WFS-Servern 
3.3.3 Schemas 
3.3.4 Aufruf & Capabilities 
3.3.5 WFS Client 
3.4 Map Context 
3.4.1 Das Context-Dokument 
3.4.2 Den Kontext verwenden 
4 Datenbankanbindungen 
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.''' 
5 Demos 
5.1 Itasca 
5.2 GMap 
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)''' 
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.3 Werkzeuge der GDAL/'''OGR'''-Bibliothek 
7.3.1 gdaltindex 
'''7.3.2 gdalinfo''' 
'''7.3.3 ogrinfo''' 
'''7.3.4 FWTools''' 
II Anhang 
A 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 Bezug und Installation ''' (Nur als Kapitel im Anhang?, finde ich zu wenig, nh)''' 
B.1 Bezug 
B.1.1 Vorkompiliert 
B.1.2 Quelltexte 
B.1.3 Änderungen 
B.1.4 CVS . 
B.2 Installation von Binaries 
B.2.1 Binaries für Windows 
'''Nicht wirklich? Link zu ms4w!''' 
B.2.2 Binaries für Linux . . . 
'''Hinweis auf: FGS Installer''' 
B.3 Die MapMedia MapServer Suite 
B.4 Kompilieren der Quelltexte 
'''mit Zusatzinformationen für besondere *Unixe''' 
B.4.1 GD 
B.4.2 Proj.4-Unterstüzung 
B.4.3 EPPL7-Unterstützung 
B.4.4 Funktionalit¨ at als WMS-Server 
B.4.5 Funktionalit¨ at als WMS-Client 
B.4.6 Funktionalit¨ at als WFS-Server 
B.4.7 Funktionalit¨ at als WFS-Client 
B.4.8 Unterstützung für PostGIS 
B.4.9 GDAL und OGR 
B.4.10 Unterstützung für PDF-Output 
B.4.11 Unterstützung für Shockwave Flash 
B.4.12 Kompilieren des MapServers 
B.5 MapScript 
B.5.1 Binaries . . 
B.5.2 Aus den Quellen 
C 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 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 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 
F 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 MapServer im Internet 
G.1 Website 
G.2 Mailinglisten 
G.2.1 Archiv 
G.2.2 Wiki 
G.3 Beispielseiten 
G.3.1 Capabilities XML 
H Lizenz der Software 
H.1 Die Lizenz aus der Datei README 
H.2 Erläuterungen

HBUMNMapServer ger

2008-05-01T16:42:05Z

Wiki-Peter panther:

= Links =
* [[UMNHB_ger_Lizenzen | Klärung der Lizenzfrage]]
* [[ Komitee_f%C3%BCr_Bildung_und_Dokumentationserstellung | Komitee für Bildung und Dokumentationserstellung ]]

__TOC__

= Inhaltsverzeichnis des 'aktuellen' Handbuchs =

1 Einfährung 
1.1 Aufbau dieses Buches 
1.2 Was ist ein Mapserver? 
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 
2 Mapﬁle 
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 
2.5 Layer 
2.5.1 Gruppierungen von Layern 
2.5.2 Weitere Layer-Optionen 
2.6 Classes 
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 
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¨ abe 
2.15 Legenden 
2.15.1 Die klassische MapServer-Legende 
2.15.2 HTML-Legenden 
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¨ anken . 
2.23.2 Variablensubstitution 
3 OGC-Konformit¨ at
3.1 Warum macht man das? 
3.2 Web Mappping Server (WMS) 
3.2.1 Servermodi . 
3.2.2 Der aufrufende URL 
3.2.3 WMS-Metadaten im Mapﬁle . 
3.2.4 Exceptions 
3.2.5 getFeatureInfo 
3.2.6 WMS Clients 
3.2.7 Exceptions 
3.2.8 Hinweise 
3.3 Web Feature Server (WFS) 
3.3.1 WFS Server 
3.3.2 Projektionen in WFS-Servern 
3.3.3 Schemas 
3.3.4 Aufruf & Capabilities 
3.3.5 WFS Client 
3.4 Map Context 
3.4.1 Das Context-Dokument 
3.4.2 Den Kontext verwenden 
4 Datenbankanbindungen 
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 
5 Demos 
5.1 Itasca 
5.2 GMap 
6 MapScript 
6.1 PHP MapScript 
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.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.17 Struktur von PHP MapScript-Seiten 
6.1.18 Speichern von Map-Objekten in PHP-Sessions 
6.1.19 Speicherverwaltung mit MapScript 
6.2 Weitere Sprachen 
6.2.1 Perl 
6.2.2 Java 
6.2.3 Python 
7 Zus¨ atzliche 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.3 Werkzeuge der GDAL-Bibliothek 
7.3.1 gdaltindex . 
II Anhang 
A Referenz 
A.1 Limits 
A.2 Organisation der Daten 
A.3 ¨ Anderungen 
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.5 CGI-Parameter 
A.5.1 Normale Parameter . 
A.5.2 CGI-Modus . 
A.5.3 Parameter für Java-Applets 
B Bezug und Installation 
B.1 Bezug 
B.1.1 Vorkompiliert 
B.1.2 Quelltexte 
B.1.3 ¨ Anderungen 
B.1.4 CVS . 
B.2 Installation von Binaries 
B.2.1 Binaries für Windows 
B.2.2 Binaries für Linux . . . 
B.3 Die MapMedia MapServer Suite 
B.4 Kompilieren der Quelltexte 
B.4.1 GD 
B.4.2 Proj.4-Unterstüzung 
B.4.3 EPPL7-Unterstützung 
B.4.4 Funktionalit¨ at als WMS-Server 
B.4.5 Funktionalit¨ at als WMS-Client 
B.4.6 Funktionalit¨ at als WFS-Server 
B.4.7 Funktionalit¨ at als WFS-Client 
B.4.8 Unterstützung für PostGIS 
B.4.9 GDAL und OGR 
B.4.10 Unterstützung für PDF-Output 
B.4.11 Unterstützung für Shockwave Flash 
B.4.12 Kompilieren des MapServers 
B.5 MapScript 
B.5.1 Binaries . . 
B.5.2 Aus den Quellen 
C Migration 239
C.1 Von Version 3.6 nach Version 4.0 
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 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 Tips zur Performance 
E.1 Vermeiden Sie unn¨ otige Funktionalität 
E.2 Nutzen Sie MINSCALE und MAXSCALE 
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 
F 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.2 Schreibbare Formate 
F.3 Nicht unterstützte Formate 
G MapServer im Internet 
G.1 Website 
G.2 Mailinglisten 
G.2.1 Archiv 
G.2.2 Wiki 
G.3 Beispielseiten 
G.3.1 Capabilities XML 
H 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 

= Inhaltsverzeichnis des 'neuen' Handbuchs =

- Änderungen bitte unter das jeweilige Thema fett schreiben 
- Zuständigkeiten / Autoren im besten Fall mit angeben 

1 Einführung 
1.1 Aufbau dieses Buches 
1.2 Was ist ein Mapserver? 
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 
2 Mapﬁle 
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 
2.5 Layer 
2.5.1 Gruppierungen von Layern 
2.5.2 Weitere Layer-Optionen 
'''2.5.3 Diagramme (Kai Behncke?)''' 
2.6 Classes 
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 
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 
2.15.1 Die klassische MapServer-Legende 
2.15.2 HTML-Legenden 
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¨ anken . 
2.23.2 Variablensubstitution 
3 OGC-Konformit¨ at
3.1 Warum macht man das? 
3.2 Web Mappping Server (WMS) 
3.2.1 Servermodi . 
3.2.2 Der aufrufende URL 
3.2.3 WMS-Metadaten im Mapﬁle . 
3.2.4 Exceptions 
3.2.5 getFeatureInfo 
3.2.6 WMS Clients 
3.2.7 Exceptions 
3.2.8 Hinweise 
3.3 Web Feature Server (WFS) 
3.3.1 WFS Server 
3.3.2 Projektionen in WFS-Servern 
3.3.3 Schemas 
3.3.4 Aufruf & Capabilities 
3.3.5 WFS Client 
3.4 Map Context 
3.4.1 Das Context-Dokument 
3.4.2 Den Kontext verwenden 
4 Datenbankanbindungen 
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.''' 
5 Demos 
5.1 Itasca 
5.2 GMap 
6 MapScript 
6.1 PHP MapScript 
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.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.17 Struktur von PHP MapScript-Seiten 
6.1.18 Speichern von Map-Objekten in PHP-Sessions 
6.1.19 Speicherverwaltung mit MapScript 
6.2 Weitere Sprachen 
6.2.1 Perl 
6.2.2 Java 
6.2.3 Python 
'''6.2.3 Mapservers goes Web 2.0 - AJAX mit msCross (Florian Thuerkow)''' 
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.3 Werkzeuge der GDAL-Bibliothek 
7.3.1 gdaltindex . 
'''7.3.2 FWTools''' 
II Anhang 
A 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 Bezug und Installation 
B.1 Bezug 
B.1.1 Vorkompiliert 
B.1.2 Quelltexte 
B.1.3 Änderungen 
B.1.4 CVS . 
B.2 Installation von Binaries 
B.2.1 Binaries für Windows 
'''Nicht wirklich? Link zu ms4w!''' 
B.2.2 Binaries für Linux . . . 
'''Hinweis auf: FGS Installer''' 
B.3 Die MapMedia MapServer Suite 
B.4 Kompilieren der Quelltexte 
'''mit Zusatzinformationen für besondere *Unixe''' 
B.4.1 GD 
B.4.2 Proj.4-Unterstüzung 
B.4.3 EPPL7-Unterstützung 
B.4.4 Funktionalit¨ at als WMS-Server 
B.4.5 Funktionalit¨ at als WMS-Client 
B.4.6 Funktionalit¨ at als WFS-Server 
B.4.7 Funktionalit¨ at als WFS-Client 
B.4.8 Unterstützung für PostGIS 
B.4.9 GDAL und OGR 
B.4.10 Unterstützung für PDF-Output 
B.4.11 Unterstützung für Shockwave Flash 
B.4.12 Kompilieren des MapServers 
B.5 MapScript 
B.5.1 Binaries . . 
B.5.2 Aus den Quellen 
C 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 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 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 
F 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 MapServer im Internet 
G.1 Website 
G.2 Mailinglisten 
G.2.1 Archiv 
G.2.2 Wiki 
G.3 Beispielseiten 
G.3.1 Capabilities XML 
H Lizenz der Software 
H.1 Die Lizenz aus der Datei README 
H.2 Erläuterungen

User:Peter panther

2008-03-11T07:45:24Z

Wiki-Peter panther:

Florian Thürkow

Mitarbeiter am Helmholtz-Zentrum für Umweltforschung

florian.thuerkow@ufz.de

www.ufz.de

Permoserstr. 15

04318 Leipzig

User:Peter panther

2008-03-11T07:44:15Z

Wiki-Peter panther:

Florian Thürkow

Mitarbeiter am Helmholtz-Zentrum für Umweltforschung

florian.thuerkow@ufz.de

www.ufz.de

Permoserstr. 15

04318 Leipzig

[[Image:Beispiel.jpg]]

D-A-CH

2007-08-02T17:28:43Z

Wiki-Peter panther: /* Mitgliederliste */

''This is the start page of the German Local Chapter as per [[Local Chapter Guidelines]]''

''Das ist die deutschsprachige Einstiegsseite zur OSGeo Foundation, die zu einer regionalen Gruppe werden könnte wie sie in den [[Local Chapter Guidelines]] beschrieben wird.

== Einführung ==
Bitte tragen Sie sich in die [[Deutsch#Mitgliederliste | Mitgliederliste]] ein, wenn Sie Interesse an einem deutschsprachigen [[Local Chapters]] haben. Der Eintrag ist freiwillig, dieses Wiki und alle enthaltenen Informationen sind öffentlich sichtbar. Die Kommunikation erfolgt über die [http://lists.osgeo.org/mailman/listinfo/viscom-discuss-de Mailing-Liste discuss-de] ([http://lists.osgeo.org/pipermail/viscom-discuss-de/ Archiv]) oder dieses Wiki.
Eingeladen an dem deutschsprachigen Local Chapter mitzuwirken sind ausdrücklich alle Interessierten, völlig unabhängig davon ob Anwender oder Entwickler, völlig unabhängig davon ob erfahren im Umgang mit OS-GIS-Software oder "Neuling". Die OSGeo lebt von der Beteiligung jedes Einzelnen, jeder Beitrag ist willkommen.

== Unser Name ==
Wir brauchen einen offiziellen Namen für die deutschsprachige Gruppe der OSGeo, Vorschläge bitte hier einstellen oder an die Mailing Liste schicken. Der Begriff der "Foundation" lässt sich ebenfalls nicht gut [http://dict.leo.org/ende?lp=ende&lang=de&searchLoc=0&cmpType=relaxed&sectHdr=on&spellToler=on&search=Foundation&relink=on direkt übersetzen], in vielen Dokumenten ist deshalb immer "OSGeo Foundation" zu lesen.

== Rechtsform, Konto ==
Die OSGeo Foundation ist als non-profit Firma in Delaware, USA gegründet worden. Dort gibt es auch ein Konto und wird das Budget verwaltet. Für formale Arbeiten und als zentrale Anlaufstelle für Fragen rund um die OSGeo wurde Tyler Mitchell als Executive Director angestellt, seine Stelle wird auch aus diesem Budget finanziert. Unabhängig davon werden wir nationale Konten benötigen, da die Transferkosten und der Aufwand, Geld über internationale Grenzen zu transportieren, nach wie vor unsinnig ist. In Deutschland gibt es bereits ein Netzwerk und Organisation für die Förderung freier Software, den GAV e.V. (GRASS Anwender-Vereinigung), eine formale Organisation mit der Rechtsform "eingetragener Verein". Der GAV und OSGeo sind im Gespräch, wie eine Kooperation gestaltet werden kann. Eine erste, pragmatische Kooperation betrifft die Überschüsse der letzten FOSSGIS-Konferenzen, die das Organisationsteam der FOSSGIS-Konferenzen zweckgebunden an den GAV e.V. spenden wird. Bei den nächsten Konferenzen kann das Organisationsteam auf diesen Puffer zurückgreifen.
* [http://www.grass-verein.de/ GAV] (GRASS Anwender-Vereinigung e.V.)
* [http://www.fossgis.de FOSSGIS.de] (Organisationsteam der FOSSGIS-Konferenzen)

== Ziele ==
Die Ziele der deutschsprachigen OSGeo Arbeitsgruppe entwickeln sich durch die Beiträge der Mitglieder. Eine erste Orientierung geben die [[Local Chapter Guidelines | Richtlinien für lokale Gruppen]], einzelne Schwerpunkte werden sich im Laufe der Arbeit herauskristallisieren.
* Bereitstellung eines Netzwerkes für die Mitglieder, ggf. mit Job-Börse.
* Organisation der jährlichen deutschsprachigen Konferenz (siehe [[FOSSGIS 2006]])
* Kontaktstelle für neue Mitglieder und Sponsoren
* Führung eines Regionalbüros mit Konto, Telefon, Ansprechpartner
* Übersetzung von Dokumenten, Inhalten, Webseiten und Lokalisierung von Software (Anpassung an örtliche Besonderheiten)
* Lösungen im deutschsprachigen Raum bewerben
* Erstellung von regionalisierten Software-Paketen
* Training, Support und Entwicklung von e-Learning Inhalten in deutscher Sprache
* Förderung von offenen Standards und freien Zugang zu räumlichen Daten im deutschsprachigen Umfeld.
* Förderung der OSGeo Foundation durch Präsentationen, Informationsveranstaltungen, Messestände, etc.

== Komitees ==

An dieser Stelle folgen nach und nach die Komitees der deutschsprachigen OSGeo Gemeinschaft.

* [[Komitee für Bildung und Dokumentationserstellung | Komitee für Bildung und Dokumentationserstellung]]

== Kommunikation ==
Die Kommunikaiton läuft über dieses Wiki, Mailing Listen, Webseite und natürlich das persönliche Gespräch auf Messen, Konferenzen und Anwendertreffen. Das neue OSGeo Portal bietet eine einfache Möglichkeit zur Übersetzung ins Deutsche. Falls Sie bei der Übersetzung gerne helfen möchten wenden Sie sich bitte an die Translation Group des [[WebCom | Website Committee]].

== Steuerung ==
Die deutschprachige Gruppe der OSGeo ist noch informell. Beteiligen Sie sich an der Gestaltung, indem Sie sich einbringen. Entscheidungen werden wie bei Open Source üblich per Email an die Mailing Liste geschickt und diskutiert. Beschlussfähige Vorschläge werden von einem Mitglied vorgeschlagen und von einem zweiten Mitglied unterstützt.

=== Wahl ===
Die Wahl erfolgt über Ablehung, Zustimmung oder Gleichgültigkeit:
-1 = Veto, Ablehung
-0 = nicht einverstanden, beugt sich aber der Mehrheit
0 = trägt die Entscheidung der anderen mit, kann aber nicht beurteilen, ob sie gut ist (zu wenig Information, keine Zeit sich zu informieren, etc.)
+0 = unterstützt den Antrag passiv, kann aber nicht aktiv zum Thema beisteuern
+1 = Zustimmung, unterstützt den Antrag voll und arbeitet auch mit

=== Veto ===
Wer mit -1 wählt legt ein Veto ein. Damit das Veto angenommen werden kann muss es innerhalb der Wahlfrist begründet und am besten gleich mit einem Alternativvorschlag eingebracht werden.

=== Unterstützung ===
Wer mit +1 wählt muss auch bereit sein aktiv mit der Lösung mitzumachen. Sonst gibt es zu viele faule Beobachter und zu wenige Arbeiter.

=== Veto überstimmen ===
Ein Veto kann überstimmt werden
* durch eine absolute Mehrheit der Mitglieder
* oder wenn mindestens vier Mitglieder mit einer +1 wählen.

Alle Ergebnis können immer angefochten werden (bis uns was besseres einfällt).

== Offizieller Status und Dokumente ==
Die OSGeo Foundation ist eine rechtliche Organisation die aus mittlerweile 59 Mitgliedern und 9 Direktoren besteht. Alle offiziellen Projekte und Dokumente müssen von dem Direktorium abgenommen werden bevor sie offiziellen Status erreichen. Offizielle Dokumente werden in den statischen Dokumenten-Ordner auf osgeo.org hinterlegt und werden dadurch "Official Policy" der OSGeo Foundation. Sobald die Mitgliederliste 10 bis 15 Einträge hat, die sich aktiv einbringen wollen, können wir einen Antrag auf einen eigenen Projektbereich mit Dokumentenordner, SVN, Webseite, etc. und offiziellem Status beantragen.

Die Sammlung deutschsprachiger Dokumente ist der Migration zum Opfer gefallen, wird aber nach und nach wieder aufgebaut. Falls Sie selbst Dokumente beisteuern können wenden Sie dich bitte an das [[Promotion and Visibility Committee]].
* [[Intern: Entwurf Artikel GIS BUSINESS | ]]

== Weitere Wiki-Seiten zu regionalen (''local'') Themen und Veranstaltungen ==
* [http://wiki.osgeo.org/index.php/Deutsch/NAS Entwicklung freier NAS-Schnittstelle]
* [http://wiki.osgeo.org/index.php/LinuxTag_2007 LinuxTag 2007]
* [[AGIT_2007]]
* [[Intergeo_2007]]
* [[FOSSGIS 2008]]

== Mitgliederliste ==
* [[User:Arnulf Christl | Arnulf Christl]]
* [[User:Ofreier | Olaf Freier]] ([http://www.hinte-messe.de/ Hinte GmbH])
* [[User:Peter Stamm | Peter Stamm]]
* [[User:Schmitz | Sebastian Schmitz]]
* [[User:Astrid Emde | Astrid Emde]]
* [[User:Uli Rothstein | Uli Rothstein]]
* [[User:Garand | Michel Garand]]
* [[User:christoph | Christoph Baudson]]
* [[User:dietmar | Dietmar Fleischhauer]]
* [[User:Georgloesel | Georg Lösel]]
* [[User:Olaf Knopp | Olaf Knopp]]
* [[User:Torsten Brassat | Torsten Brassat]]
* [[User:Jtmapmedia | Jörg Thomsen]]
* [[User:Silke Reimer | Silke Reimer]]
* [[User:Till Adams | Till Adams]]
* [[User:Athina Trakas | Athina Trakas]]
* [[User:mlechner | Marco Lechner]]
* [[User:maltehm | Malte Halbey-Martin]]
* [[User:Kai Behncke | Kai Behncke]]
* [[User:Cplass | Christian Plass]]
* [[User:Thomas Kastler | Thomas Kastler]]
* [[User:Constanze Tschritter | Constanze Tschritter]]
* [[User:Marko Samson | Marko Samson]]
* [[User:Markus Weißmann | Markus Weißmann]]
* [[User:Robert.Dettmann | Robert Dettmann]] ([http://www.creata-software.de/ creaTa Software GmbH])
* [[User:Verena Diewald | Verena Diewald]]
* [[User:sholl | Stephan Holl]]
* [[User:GEppelt | Gunter Eppelt]]
* [[User:Sholler | Sebastian Holler]]
* [[User:Thomas Baschetti | Thomas Baschetti]]
* [[User:Peter Loewe| Peter Löwe]]
* [[User:Peter_panther| Florian Thürkow]]
* [[User:Fjbehr| Dr. Franz-Josef Behr]]
* [[User:crischan| Christian Wygoda (FH Eberswalde)]]

* Bitte tragen Sie sich hier mit Link auf Ihren OSGeo-Wiki Account ein

[[Category:Local Chapters]]

Komitee für Bildung und Dokumentationserstellung

2007-08-02T17:28:13Z

Wiki-Peter panther: /* Mitglieder */

Komitee für Bildung und Dokumentationserstellung

2007-07-31T15:23:02Z

Wiki-Peter panther: /* Mitglieder */

User:Peter panther

2007-07-31T15:21:15Z

Wiki-Peter panther:

Florian Thürkow

Mitarbeiter am Helmholtz-Zentrum für Umweltforschung

florian.thuerkow@ufz.de

www.ufz.de

Permoserstr. 15

04318 Leipzig

User:Peter panther

2007-07-31T15:21:01Z

Wiki-Peter panther:

Florian Thürkow

Mitarbeiter am Helmholtz-Zentrum für Umweltforschung

florian.thuerkow@ufz.de
www.ufz.de

Permoserstr. 15

04318 Leipzig

User:Peter panther

2007-07-31T15:20:27Z

Wiki-Peter panther:

Florian Thürkow

Mitarbeiter am Helmholtz-Zentrum für Umweltforschung
florian.thuerkow@ufz.de
www.ufz.de
Permoserstr. 15
04318 Leipzig

D-A-CH

2007-07-31T15:17:53Z

Wiki-Peter panther: /* Mitgliederliste */

''This is the start page of the German Local Chapter as per [[Local Chapter Guidelines]]''

''Das ist die deutschsprachige Einstiegsseite zur OSGeo Foundation, die zu einer regionalen Gruppe werden könnte wie sie in den [[Local Chapter Guidelines]] beschrieben wird.

== Einführung ==
Bitte tragen Sie sich in die [[Deutsch#Mitgliederliste | Mitgliederliste]] ein, wenn Sie Interesse an einem deutschsprachigen [[Local Chapters]] haben. Der Eintrag ist freiwillig, dieses Wiki und alle enthaltenen Informationen sind öffentlich sichtbar. Die Kommunikation erfolgt über die [http://lists.osgeo.org/mailman/listinfo/viscom-discuss-de Mailing-Liste discuss-de] ([http://lists.osgeo.org/pipermail/viscom-discuss-de/ Archiv]) oder dieses Wiki.
Eingeladen an dem deutschsprachigen Local Chapter mitzuwirken sind ausdrücklich alle Interessierten, völlig unabhängig davon ob Anwender oder Entwickler, völlig unabhängig davon ob erfahren im Umgang mit OS-GIS-Software oder "Neuling". Die OSGeo lebt von der Beteiligung jedes Einzelnen, jeder Beitrag ist willkommen.

== Unser Name ==
Wir brauchen einen offiziellen Namen für die deutschsprachige Gruppe der OSGeo, Vorschläge bitte hier einstellen oder an die Mailing Liste schicken. Der Begriff der "Foundation" lässt sich ebenfalls nicht gut [http://dict.leo.org/ende?lp=ende&lang=de&searchLoc=0&cmpType=relaxed&sectHdr=on&spellToler=on&search=Foundation&relink=on direkt übersetzen], in vielen Dokumenten ist deshalb immer "OSGeo Foundation" zu lesen.

== Rechtsform, Konto ==
Die OSGeo Foundation ist als non-profit Firma in Delaware, USA gegründet worden. Dort gibt es auch ein Konto und wird das Budget verwaltet. Für formale Arbeiten und als zentrale Anlaufstelle für Fragen rund um die OSGeo wurde Tyler Mitchell als Executive Director angestellt, seine Stelle wird auch aus diesem Budget finanziert. Unabhängig davon werden wir nationale Konten benötigen, da die Transferkosten und der Aufwand, Geld über internationale Grenzen zu transportieren, nach wie vor unsinnig ist. In Deutschland gibt es bereits ein Netzwerk und Organisation für die Förderung freier Software, den GAV e.V. (GRASS Anwender-Vereinigung), eine formale Organisation mit der Rechtsform "eingetragener Verein". Der GAV und OSGeo sind im Gespräch, wie eine Kooperation gestaltet werden kann. Eine erste, pragmatische Kooperation betrifft die Überschüsse der letzten FOSSGIS-Konferenzen, die das Organisationsteam der FOSSGIS-Konferenzen zweckgebunden an den GAV e.V. spenden wird. Bei den nächsten Konferenzen kann das Organisationsteam auf diesen Puffer zurückgreifen.
* [http://www.grass-verein.de/ GAV] (GRASS Anwender-Vereinigung e.V.)
* [http://www.fossgis.de FOSSGIS.de] (Organisationsteam der FOSSGIS-Konferenzen)

== Ziele ==
Die Ziele der deutschsprachigen OSGeo Arbeitsgruppe entwickeln sich durch die Beiträge der Mitglieder. Eine erste Orientierung geben die [[Local Chapter Guidelines | Richtlinien für lokale Gruppen]], einzelne Schwerpunkte werden sich im Laufe der Arbeit herauskristallisieren.
* Bereitstellung eines Netzwerkes für die Mitglieder, ggf. mit Job-Börse.
* Organisation der jährlichen deutschsprachigen Konferenz (siehe [[FOSSGIS 2006]])
* Kontaktstelle für neue Mitglieder und Sponsoren
* Führung eines Regionalbüros mit Konto, Telefon, Ansprechpartner
* Übersetzung von Dokumenten, Inhalten, Webseiten und Lokalisierung von Software (Anpassung an örtliche Besonderheiten)
* Lösungen im deutschsprachigen Raum bewerben
* Erstellung von regionalisierten Software-Paketen
* Training, Support und Entwicklung von e-Learning Inhalten in deutscher Sprache
* Förderung von offenen Standards und freien Zugang zu räumlichen Daten im deutschsprachigen Umfeld.
* Förderung der OSGeo Foundation durch Präsentationen, Informationsveranstaltungen, Messestände, etc.

== Komitees ==

An dieser Stelle folgen nach und nach die Komitees der deutschsprachigen OSGeo Gemeinschaft.

* [[Komitee für Bildung und Dokumentationserstellung | Komitee für Bildung und Dokumentationserstellung]]

== Kommunikation ==
Die Kommunikaiton läuft über dieses Wiki, Mailing Listen, Webseite und natürlich das persönliche Gespräch auf Messen, Konferenzen und Anwendertreffen. Das neue OSGeo Portal bietet eine einfache Möglichkeit zur Übersetzung ins Deutsche. Falls Sie bei der Übersetzung gerne helfen möchten wenden Sie sich bitte an die Translation Group des [[WebCom | Website Committee]].

== Steuerung ==
Die deutschprachige Gruppe der OSGeo ist noch informell. Beteiligen Sie sich an der Gestaltung, indem Sie sich einbringen. Entscheidungen werden wie bei Open Source üblich per Email an die Mailing Liste geschickt und diskutiert. Beschlussfähige Vorschläge werden von einem Mitglied vorgeschlagen und von einem zweiten Mitglied unterstützt.

=== Wahl ===
Die Wahl erfolgt über Ablehung, Zustimmung oder Gleichgültigkeit:
-1 = Veto, Ablehung
-0 = nicht einverstanden, beugt sich aber der Mehrheit
0 = trägt die Entscheidung der anderen mit, kann aber nicht beurteilen, ob sie gut ist (zu wenig Information, keine Zeit sich zu informieren, etc.)
+0 = unterstützt den Antrag passiv, kann aber nicht aktiv zum Thema beisteuern
+1 = Zustimmung, unterstützt den Antrag voll und arbeitet auch mit

=== Veto ===
Wer mit -1 wählt legt ein Veto ein. Damit das Veto angenommen werden kann muss es innerhalb der Wahlfrist begründet und am besten gleich mit einem Alternativvorschlag eingebracht werden.

=== Unterstützung ===
Wer mit +1 wählt muss auch bereit sein aktiv mit der Lösung mitzumachen. Sonst gibt es zu viele faule Beobachter und zu wenige Arbeiter.

=== Veto überstimmen ===
Ein Veto kann überstimmt werden
* durch eine absolute Mehrheit der Mitglieder
* oder wenn mindestens vier Mitglieder mit einer +1 wählen.

Alle Ergebnis können immer angefochten werden (bis uns was besseres einfällt).

== Offizieller Status und Dokumente ==
Die OSGeo Foundation ist eine rechtliche Organisation die aus mittlerweile 59 Mitgliedern und 9 Direktoren besteht. Alle offiziellen Projekte und Dokumente müssen von dem Direktorium abgenommen werden bevor sie offiziellen Status erreichen. Offizielle Dokumente werden in den statischen Dokumenten-Ordner auf osgeo.org hinterlegt und werden dadurch "Official Policy" der OSGeo Foundation. Sobald die Mitgliederliste 10 bis 15 Einträge hat, die sich aktiv einbringen wollen, können wir einen Antrag auf einen eigenen Projektbereich mit Dokumentenordner, SVN, Webseite, etc. und offiziellem Status beantragen.

Die Sammlung deutschsprachiger Dokumente ist der Migration zum Opfer gefallen, wird aber nach und nach wieder aufgebaut. Falls Sie selbst Dokumente beisteuern können wenden Sie dich bitte an das [[Promotion and Visibility Committee]].
* [[Intern: Entwurf Artikel GIS BUSINESS | ]]

== Weitere Wiki-Seiten zu regionalen (''local'') Themen und Veranstaltungen ==
* [http://wiki.osgeo.org/index.php/Deutsch/NAS Entwicklung freier NAS-Schnittstelle]
* [http://wiki.osgeo.org/index.php/LinuxTag_2007 LinuxTag 2007]
* [[AGIT_2007]]
* [[Intergeo_2007]]
* [[FOSSGIS 2008]]

== Mitgliederliste ==
* [[User:Arnulf Christl | Arnulf Christl]]
* [[User:Ofreier | Olaf Freier]] ([http://www.hinte-messe.de/ Hinte GmbH])
* [[User:Peter Stamm | Peter Stamm]]
* [[User:Schmitz | Sebastian Schmitz]]
* [[User:Astrid Emde | Astrid Emde]]
* [[User:Uli Rothstein | Uli Rothstein]]
* [[User:Garand | Michel Garand]]
* [[User:christoph | Christoph Baudson]]
* [[User:dietmar | Dietmar Fleischhauer]]
* [[User:Georgloesel | Georg Lösel]]
* [[User:Olaf Knopp | Olaf Knopp]]
* [[User:Torsten Brassat | Torsten Brassat]]
* [[User:Jtmapmedia | Jörg Thomsen]]
* [[User:Silke Reimer | Silke Reimer]]
* [[User:Till Adams | Till Adams]]
* [[User:Athina Trakas | Athina Trakas]]
* [[User:mlechner | Marco Lechner]]
* [[User:maltehm | Malte Halbey-Martin]]
* [[User:Kai Behncke | Kai Behncke]]
* [[User:Cplass | Christian Plass]]
* [[User:Thomas Kastler | Thomas Kastler]]
* [[User:Constanze Tschritter | Constanze Tschritter]]
* [[User:Marko Samson | Marko Samson]]
* [[User:Markus Weißmann | Markus Weißmann]]
* [[User:Robert.Dettmann | Robert Dettmann]] ([http://www.creata-software.de/ creaTa Software GmbH])
* [[User:Verena Diewald | Verena Diewald]]
* [[User:sholl | Stephan Holl]]
* [[User:GEppelt | Gunter Eppelt]]
* [[User:Sholler | Sebastian Holler]]
* [[User:Thomas Baschetti | Thomas Baschetti]]
* [[User:Peter Loewe| Peter Löwe]]
* [[User:Peter Panther| Florian Thürkow]]

* Bitte tragen Sie sich hier mit Link auf Ihren OSGeo-Wiki Account ein

[[Category:Local Chapters]]