WICHTIG: Diese Beschreibung ist veraltet.
Bitte doc/install.de.html fr die Installation von MapIt! verwenden!

Mapit! Installation
===================

bersicht
---------

Eine Mapit!-Installation besteht im wesentlichen aus drei Teilen: dem
CGI-code, den Daten (Rasterkarten HTML-Schablonen und Markierungen) und
Icons, die von den generierten HTML-Seiten bentigt werden.

Wo der CGI-Code und die Icons diese Teile auf ihrem System installiert
werden mssen, hngt von ihrer Webserverkonfiguration ab. Die Daten
knnen an beliebiger Stelle untergebracht werden, sie mssen lediglich
die Konfigurationsdatei entsprechend anpassen.


Allgemeine Installationsschritte
--------------------------------

MapIt! kann auf mehrere verschiedene Arten in einen Webserver
eingebunden werden, etwa ber CGI, fast CGI oder mod_python. In diesem
Abschnitt werden die Installationsschritte beschrieben, die bei alle
Varianten gleich sind. Weiter unten folgen Abschnitte mit
schnittstellenspezifischen Anweisungen.


 1. Installation der Quelltexte
 
    Kopieren Sie die Quelltextdateien in ein geeignetes Verzeichnis. Die
    Quelltexte sind in den Basiscode (src/base) und die Schnittstellen
    (src/frontends) aufgeteilt. Der Basiscode wird immer bentigt, Sie
    brauchen aber nur einige der Schnittstellen-Dateien, je nachdem,
    welche Schnittstelle sie verwenden mchten:

	Schnittstelle	Datei in src/frontends
	--------------------------------------
	CGI		showmap
			genmap

	FastCGI		showmap.cgi
			showmap.fcgi
			showmap.py
			genmap.cgi
			genmap.fcgi
			genmap.py
			fcgi.py

	mod_python	showmap.py
			genmap.py
			modmapit.py

    Wohin diese Dateien kopiert werden mssen ist in dem entsprechenden
    Abschnitt weiter unten beschrieben.

    Sie knnen den Basiscode und den Schnittstellencode in ein
    gemeinsames Verzeichnis oder in getrennte Verzeichnisse kopieren.
    Bei getrennten Verzeichnissen mussen Sie jedoch darauf achten, da
    der Schnittstellencode den Basiscode finden kann.

 2. Installation der Daten

 2.1 Installation der Kacheln

    Kopieren Sie die Dateien aus mapit-0.5/examples/simple bis auf das
    icons/ Unterveerzeichnis in ein geeignetes Verzeichnis. Bei uns ist
    das z.B. .../www-adm/tools/mapit/simple.

 2.2 Installation der Icons

    Kopieren Sie die Icons aus mapit-0.5/examples/simple/icons/ an eine
    geeignete Stelle fr Ihren Webserver. Bei uns ist das z.B.
    www-adm/www/public/mapit/simple/Icons

    Die mit den Voreinstellungen von Mapit! generierte Seite bezieht
    sich auf die Icons mit URLs der Form "/simple/Icons/image.png".
    Bitte achten Sie also darauf, da die Icons auf Ihren Webserver auch
    so erreicht werden knnen oder passen sie, wie weiter unten
    beschrieben, die Schablone an Ihre gegebenheiten an.

 3. MapIt! Konfiguration

 3.1 Anpassen von mapconfig.py

    Passen Sie die Konfigurationsdatei mapconfig.py an ihre Bedrfnisse
    an. Der wichtigste Eintrag, den sie ndern mssen, ist _base_dir,
    welcher auf das Verzeichnis verweist, in dem sich die Datendateien
    befinden.

    Falls Sie Windows verwenden, beachten Sie bitte, da, wenn Sie
    Backslashes (\) als Verzeichnistrennzeichen verwenden mchten, sie
    diese doppelt schreiben, so da aus C:\Programme\Mapit
    "C:\\Programme\\Mapit" wird. Einfacher ist es aber, auch unter
    Windows einfach die normalen Schrgstriche (/) als Trennzeichen zu
    verwenden.

 3.2 Anpassen der Schablone

    Wenn ntig, passen Sie die Schablone (data/simple/simple.template)
    an Ihre Bedrfnisse an. Die hufigste nderung, die dort ntig ist,
    sind die Verweise auf die Icons. Eine Erluterung der <mapit:> Tags
    finden Sie in src/simple/pagetemplate.py (in Englisch).


Installation als CGI-Skript
---------------------------

Die MapIt! CGI-Skripte showmap und genmap mssen in ein Verzeichnis
gelegt werden, das in Ihrem Webserver dr CGI konfiguriert ist.

Unter Unix und, wenn Sie Apache verwenden, auch unter Windows mssen Sie
eventuell die erste Zeile in jeder Datei anpassen, so da sie auf Ihren
Python-Interpreter verweist. Auf unserem NT-System sieht sie z.B. so
aus:

#!c:\programme\python\python -u -O

Der -u Parameter ist wichtig unter Windows, da das genmap Skript
Binrdaten nach stdout schreibt.



Installation als FastCGI Skript
-------------------------------

Die FastCGI Schnittstelle luft im Moment nur unter Unix. Ein einfacher
Weg, um FastCGI mit den meisten Servern zu verwende, ist das fcgi-cgi
Programm aus dem Devkit von http://www.fastcgi.com. Die .cgi-Versionen
von showmap und genmap sind normale CGI-Skripte, die fcgi-cgi als
Interpreter verwenden und darber showmap.fcgi and genmap.fcgi als
separate Prozesse starten und ansprechen. Die .fcgi-Versionen erledigen
die eigentliche Arbeit.

Zur Installation mssen Sie typischerweise noch den Inhalt der
.cgi-Dateien an Ihre Bedrfnisse anpasssen.


Installation mit mod_python
---------------------------

mod_python ist ein Modul fr den Apache Webserver, das von
http://www.modpython.org/ erhltlich ist. Diese Lsung lft
offensichtlich nur mit Apache, aber sie funktioniert sowohl unter Unix
als auch unter Windows. Die Beispiele hier stammen aus unserer
NT-Installation.

Kopieren Sie die Quelldateien in ein geeignetes Verzeichnis -- auf unserem
NT-System ist das z.B. C:/Programme/Apache Group/Apache/cgi-bin/mapit/ --
und richten Sie dieses Verzeichnis in Apaches http.conf ein:

<Directory "C:/Programme/Apache Group/Apache/cgi-bin/mapit/">
	SetHandler python-program
	PythonHandler modmapit
	PythonDebug on
</Directory>

Mit diesen Anweisungen wird Apache so konfiguriert, da fr alle URLs,
die auf das angegeben Verzeichnis verweisen die Funktion "handler" aus
modmapit aufgerufen wird. modmapit erkennt, ob showmap oder genmap
verlangt wird und ruft die entsprechenden Funktionen im Basiscode auf.

Wenn Sie mchten, knnen Sie auch noch einen Alias definieren, etwa:

ScriptAlias /mapit-scripts/ "C:/Programme/Apache Group/Apache/cgi-bin/mapit/"

damit knnen Sie MapIt! ber http://localhost/mapit-scripts/showmap
aufrufen.
