FGS installieren
FGS ist ein vorkompiliertes Paket für LINUX-Systeme mit allen für WebGIS-Anwendungen notwendigen Komponenten. FGS gibt es als Installer-Pakete und dazugehörige Module, die einzeln nach Bedarf dazugeladen werden können.
Wenn man nicht das vorkompilierte Paket verwenden, sondern aus irgendeinem Grund die Pakete und Module selbst kompilieren möchte, kann man FGS-DEV verwenden. Siehe dazu
Inhaltsverzeichnis
Vorarbeiten
Einen Benutzer "fgs" in Yast anlegen.
Die Installation von FGS soll mit einem Benutzer "fgs" erfolgen, d.h. nicht als root. FGS kann auch mit dem Benutzer root installiert werden, es ergeben sich dann aber einige schwerwiegende Probleme:
- Der Benutzer root darf den Apache nicht starten
- Wenn man für das starten des Apache einen unterprivilegierten User anlegt, darf der nicht in /opt/fgs schreiben
Der FGS-Benutzer kann natürlich statt "fgs" auch ganz anders heißen.
Download Link von FGS unter: http://dl.maptools.org/dl/fgs/releases/1.0/1.0.0/self-installers/
Den Download Button der gewünschten Version (aktuell: fgs-mapserver_5.2.1-fgs_1.0.0-linux-i386.bin) wählen.
Unter fgs-mapserver_5.2.1-fgs_1.0.0-linux-i386.versions kann man die dazugehörigen reinkompilierten Module und deren Versionen abfragen:
mapserver-php:5.2.1 mapserver-base:5.2.1 libstdc++-lib:6.0.8 libgcc-lib:1 apache-base:2.2.8 expat-base:2.0.1 gd-lib:2.0.35 jpeg-lib:6b freetype-lib:2.3.5 libpng-lib:1.2.8 zlib-lib:1.2.3 curl-lib:7.16.4 openssl-lib:0.9.8a proj-lib:4.5.0 postgresql-lib:8.3.1 gdal-base:1.5.0 tiff-lib:3.8.2 libgeotiff-lib:1.2.4 xerces_c-base:2_8_0 unixODBC-base:2.2.10 libungif-base:4.1.3 libiconv-base:1.9.1 proj4_epsg42xxx-support:1.0.0 geos-lib:3.0.0 libxml2-base:2.6.19 agg-lib:2.4 php-base:5.2.5 python_mapscript-module:5.2.1 python-base:2.5.2 gdal_ecw-module:1.5.0 libecw-base:3.3.20060906 postgis-lib:1.3.2
Den Installer im Home-Verzeichnis von fgs verstauen.
Installation
Installationsdatei ausführbar machen mit
#>chmod 700 fgs-mapserver_5.2.1-fgs_1.0.0-linux-i386.bin
und ausführen:
#>./fgs-mapserver_5.2.1-fgs_1.0.0-linux-i386.bin
Verzeichnis angeben, in dem fgs installiert werden soll. Default ist /opt/fgs (für die Installation als root). Das ändern in /home/fgs/fgs:
Port festlegen unter dem Apache laufen soll. Default ist 8080:
Letzte Ausgaben auf jeden Fall mal sichern (und wenn es nur ein Screenshot ist). Denn da steht, wie man fgs so startet, dass fgs nach dem Booten automatisch hochfährt und wie man die Umgebungsvariablen für fgs einrichtet und wie man das automatisiert für jedes login.
Vor dem händischen Starten müssen die Umgebungsvariablen gesetzt sein. Das geht durch das Ausführen der Datei setenv.sh. Erstmal nach /home/fgs/fgs wechseln:
#>cd /home/fgs/fgs
Dann die setenv.sh ausführbar machen mit:
#>chmod 700 setenv.sh
und ausführen mit:
#>source setenv.sh
Wenn man möchte, dass setenv.sh automatisch nach dem Einloggen ausgeführt wird, führt man folgendes aus:
#>echo "source /home/fgs/fgs/setenv.sh" >> ~/.bashrc
Damit wird der Aufruf der setenv.sh an die Datei .bashrc des Users angehängt, die immer ausgeführt wird, wenn man sich als fgs anmeldet.
Damit FGS beim Booten des Servers automatisch startet, wird der Startbefehl in die rc.local geschrieben (den Befehl als root ausführen!):
#>echo "su root -c \"( . /home/fgs/fgs/setenv.sh ; fgs start )\"" >> /etc/rc.d/rc.local
und prüfen ob der Aufruf auch in der Datei anschließend drin steht:
#>less /etc/rc.d/rc.local
FGS starten
Nun können wir fgs starten. Einmal abmelden, wieder anmelden und fgs starten:
#>exit #>fgs start
Dabei stellen wir fest, dass er fgs nicht kennt. setenv.sh wurde ja auch noch nicht ausgeführt. Das machen wir aber nicht, sondern melden uns mal ab und wieder an und probieren dann noch mal und siehe da: Apache läuft schon. Macht nichts, den fahren wir runter mit:
#>fgs stop
Was bei der Gelegenheit gleich beschreibt, wie man fgs runter- und wieder hochfährt. Nu geht’s aber. "+Starting 'apache' :" ist ein gutes Zeichen:
Um zu prüfen, ob nun alles eingerichtet ist, einmal abmelden, als root neu booten und danach wieder anmelden als fgs:
#>exit #>shutdown –r now
Danach sollten die Umgebungsvariablen gesetzt sein und fgs schon laufen.
Nun können wir uns fgs auch mal vom Internet aus ansehen. Dazu die Adresse des Servers eingeben plus Port 8080, z.B. http://www.pkorduan.de:8080/ Dann erscheint in einem leeren fgs:
Jetzt haben wir den Mapserver, PHP, Apache, Unterstützung für PostgreSQL (die Datenbank selbst aber noch nicht) sowie all die für den Mapserver wichtigen Pakete. Die Unterstützung für MySQL fehlt noch und wird später als Modul installiert (MySQL selbst muss separat installiert werden, wenn nicht schon vorhanden).
SSL Unterstützung für Apache
Die SSL-Unterstützung für den WebServer muss nur eingerichtet werden, wenn mit den Clients per https kommuniziert werden soll.
Das notwendige Modul heißt apache_mod_ssl-module:2.2.8 und kann entweder
- von der Seite http://dl.maptools.org/dl/fgs/releases/1.0/1.0.0/modules/ runtergeladen und in /home/fgs entpackt werden oder
- (der bequemere Weg) per Kommandozeile installiert werden:
#>fgs install apache_mod_ssl-module:2.2.8 http://dl.maptools.org/dl/fgs/releases/1.0/1.0.0/modules/
Dabei werden wir nach dem Port für HTTPS gefragt. Default ist 443.
Nun muss man eigentlich gar nichts mehr machen außer fgs stop und fgs start. Dabei wird Apache im SSL Mode gestartet. Wenn der SSL-Schlüssel mit Passwort versehen wurde, muß dieser vorher manuell eingegeben werden, was zu einem Problem beim automatischen Hochfahren wird.
So sieht es dann jedenfalls nach einem erfolgreichen Start aus:
Und so nach einem erfolgreichen Stop:
Eigenes Zertifikat erstellen
Eine gute Doku zur Erstellung von selbstgebauten Zertifikaten gibt es unter: http://www.schirmacher.de/display/INFO/Apache+SSL+Zertifikat+erstellen+und+installieren
Zunächst sollte geprüft werden, ob das Modul openssl bereits im fgs packet enthalten ist. Es sollte unter /home/fgs/fgs/bin stehen. Dann einen Ort suchen, wo man die Dateien ablegt, z.B. unter /home/fgs/fgs/etc/ssl/certs.
Schlüssel mit 1024 Byte erzeugen. Der Name ist eigentlich egal (im Beispiel "nvp-geoport"). Diese müssen dann später nur in der httpd-ssl.conf richtig eingesetzt werden.
#>openssl genrsa -out /home/fgs/fgs/etc/ssl/certs/nvp-geoport.key 1024
Wenn man den Schlüssel mit einem Passwort schützen möchte, folgender Befehl:
#>openssl genrsa -des3 -out nvp-geoport.key 1024
Problem dabei ist, dass man dann fgs nicht im Batch Modus nach dem Hochfahren des Rechners starten kann, weil fgs bis zum St. Nimmerleinstag auf ein Passwort wartet.
Als nächstes ein Certificate Signing Request (CSR) erzeugen mit:
#>openssl req -new -key /home/fgs/fgs/etc/ssl/certs/nvp-geoport.key -out /home/fgs/fgs/etc/ssl/certs/nvp-geoport.csr
Dabei wird man so einiges gefragt. Wenn man nicht antworten will, gibt man einen Punkt ein, z.B. bei Password (und das vermeidet die Abfrage des Passworts beim Booten!):
Jetzt kann man noch mal prüfen, ob alle Angaben richtig sind:
#>openssl req -noout -text -in /home/fgs/fgs/etc/ssl/certs/nvp-geoport.csr
Zum Schluss erstellt man schließlich das Zertifikat, welches dann von den Browsern akzeptiert werden muss:
#>openssl x509 -req -days 3650 -in /home/fgs/fgs/etc/ssl/certs/nvp-geoport.csr -signkey /home/fgs/fgs/etc/ssl/certs/nvp-geoport.key -out /home/fgs/fgs/etc/ssl/certs/nvp-geoport.crt
Fertig! fgs start kann nun ohne Eingabe eines Passwort erfolgen.
Wenn man später den Apache-SSL mit einem anderen Port laufen lassen möchte, den Port in der Datei /home/fgs/fgs/etc/fgs/pkgs/apache_mod_ssl-module/apache_mod_ssl.conf anpassen, z.B. SSLPORT=8443 => SSLPORT=443
Nach der Einstellung fgs neu starten.
Welcher Port nach dem fgs start belegt wird, kann man mit folgendem Befehl prüfen:
#>netstat –ln
Weitere FGS-Module hinzufügen
Im Weiteren sind einige Module nachzuinstallieren, die für kvwmap gebraucht werden. Das betrifft Postgresql Server, PostGIS Support sowie pgsql- und mysql-Support für PHP. Nach der Installation des postgres Datenbankservers müssen User, Datenbank als Template sowie die Unterstütztung für PostGIS innerhalb des Template eingerichtet werden und die kvwmap-Datenbank erzeugt werden. Siehe dazu die folgenden Abschnitte.
Für die Nutzung von Mysql in php brauchen wir das Modul fgs-php_mysql-module-5.2.5-linux-i386.tar.gz.
Die Installation erfolgt über:
#>fgs install php_mysql-module:5.2.5 http://dl.maptools.org/dl/fgs/releases/1.0/1.0.0/modules/
Das Gleiche für pgsql:
#>fgs install php_pgsql-module:5.2.5 http://dl.maptools.org/dl/fgs/releases/1.0/1.0.0/modules/
php.ini
Damit die Erweiterungen in PHP auch laufen, müssen die Bibliotheken als shared object library (*.so) in PHP eingebunden werden.
Dazu in /home/fgs/fgs/www/conf/php5.ini.template (nicht in php5.ini!!!!!! Die wird beim fgs start jedes mal neu erzeugt) im Abschnitt Dynamic Extension die folgenden Einträge vornehmen:
extension=php_mysql.so extension=php_pgsql.so
Für kvwmap sind außerdem folgende Einträge zu ändern:
session.auto_start = 1
und
magic_quotes_gpc = Off
Postgresql-Server installieren
Das Modul wie gehabt installieren:
#>fgs install postgresql-server:8.3.1 http://dl.maptools.org/dl/fgs/releases/1.0/1.0.0/modules/
(Falls man upgraden will: fgs erstmal runterfahren und force-install statt install verwenden. Dabei wird man nach dem Port für die Datenbank gefragt. Defailt ist 5432. Wenn man schon eine DB auf diesem Port laufen hat, kann man z.B. 5433 nehmen und die neue erstmal parallel laufen lassen. Der Port steht hinterher in der Datei /home/fgs/fgs/etc/fgs/pkgs/postgresql-server/pgsql.conf und kann angepasst werden)
Die Datenbank wird zunächst initialisiert:
#>initdb –locale=POSIX –E LATIN1 –U fgs –D /home/fgs/fgs/apps/pgsql/data
Wenn der Parameter -E weggelassen wird, wird die Datenbank auf Encoding=UTF-8 festgelegt und es ist nicht möglich, Datenbanken mit anderen Encodings zu erzeugen. kvwmap benötigt Latin1.
Bei einer Fehlermeldung, dass die Datei snowball_create.sql nicht existiert, wie hier im Screenshot, muss die Option –L angeben mit Verweis auf /home/fgs/fgs/share. Oder man kopiert alle Dateien aus /home/fgs/fgs/apps/pgsql/share nach /home/fgs/fgs/share und startet ohne Option –L.
So sieht es aus nach Kopieren der Dateien und ohne Option –L:
Und die Ausschrift sollte so enden:
Danach die Konfiguration der Rechte in pg_hba.conf eintragen im Verzeichnis /home/fgs/fgs/apps/pgsql/data. In /home/fgs/fgs/apps/pgsql/postgresql.conf das Kommentarzeichen vor Parameter listen_addresses = 'localhost' rausnehmen und auf '*' setzen.
Anschließend fgs stop / fgs start nicht vergessen. Man kann auch nur die PgSQL-DB stoppen und starten:
#>fgs stop pgsql #>fgs start pgsql
PostGIS installieren
kvwmap-Datenbank für Postgresql
