Installationsanleitung

Da der Python Desktop Server derzeit noch im Entwicklungszustand befindet, ist die Installation hier vom Source beschrieben. Es gibt für Debian Systeme binäre Pakete, die Anleitung gibts hier: Installation über apt-get in der Debian. Zur Architektur gibt es auch einen Artikel: Architektur von PyDS.

Diese Installation installiert die Version 0.7.1 - die zum Zeitpunkt des Aktualisierens dieses Textes noch nicht released ist, aber schon als Download verfügbar ist. Eventuell hat sich mitlerweile einiges getan beim Python Desktop Server - also immer schauen, ob auch die neueste Version verwendet wird. Eventuell hinkt dieser Text in der Version nämlich der Entwicklung hinterher. Üblicherweise sollte man die letzte Stabile Version vom Python Desktop Server einsetzen, nur wenn man weiss was man tut kann man die CVS-Version verwenden. Die aktuellsten Versionsinformationen gibt es auf http://pyds.muensterland.org/.

Es gibt grundsätzlich zwei Vorgehensweisen: Installation mit vorhandenem Python und Installation mit einem eigenen Python. Ich beschreibe hier die Installation mit einem eigenen Python, da diese die wenigsten Konflikte produziert. Wer schon Python 2.2.2 installiert hat, kann die Python-Installationsschritte auslassen (genauso wie alle Pakete die er schon installiert hat). Im Zweifelsfall schadet eine Installation eines getrennten Pythons aber nichts, es belegt nur mehr Plattenplatz. Es wird aber nur Python 2.2.2 unterstützt derzeit, da nicht alle Erweiterungen unter Python 2.3 funktionieren (vor allem Metakit ist da ein Problem).

Windows-User können sich die Installationsanleitung für windows anschauen, oder den Windows-Installer ausprobieren.

Als wichtigste Voraussetzungen für die Installation aus dem Source gilt das, was Python 2.2.2 benötigt, um zu installieren. Also C-Compiler und Entwicklungsbibliotheken etc. Wenn das Development-Paket von Mac OS X installiert ist, ist eigentlich alles da. Genauso wenn die typische C-Entwicklungsumgebung unter Linux installiert ist. Es gibt zwei wichtige Ausnahmen:

1. Es muss eine libzlib installiert sein, und zwar die Entwicklerversion. In der Regel ist das eine zlib1g-dev oder ein vergleichbares Paket. Meist ist die in den Entwicklungsumgebungen enthalten.
2. Es muss eine libjpeg installiert sein. Dazu kann wieder das passende Paket vom System installiert werden, meist heisst das libjpeg62-dev. Es geht die a oder b Version.

Falls keine libjpeg als Entwicklerversion vorliegt (gilt vor allem für Mac OS X), kann das mit den folgenden Befehlen leicht von Hand gemacht werden:

wget http://www.ijg.org/files/jpegsrc.v6b.tar.gz
tar xvfz jpegsrc.v6b.tar.gz
cd jpeg-6b
./configure
make
sudo make install-lib
sudo ranlib /usr/local/lib/libjpeg.a

Unter Umständen ist das Verzeichnis /usr/local/include nicht vorhanden - dann meckert die libjpeg-Installation über fehlende Dateien. In dem Fall einfach das fehlende Verzeichnis anlegen (hier wird auch gleich noch das lib-Verzeichnis mit angelegt) und nochmal den install laufen lassen:

mkdir -p /usr/local/include
mkdir -p /usr/local/lib
sudo make install-lib
sudo ranlib /usr/local/lib/libjpeg.a

Eine Installtion von zlib kriegt man mit den folgenden Kommandos (auch hier, normalerweise nur bei Mac OS X nötig, wenn überhaupt):

wget http://www.gzip.org/zlib.tar.gz
tar xvzf zlib.tar.gz
cd zlib-1.1.4/  
./configure
make
sudo make install

Im ersten Schritt muss ein Source-Verzeichnisbaum angelegt werden mit allen Sourcen, die nötig sind. Dazu einfach ein Verzeichnis im eigenen Homeverzeichnis anlegen:

cd ~/
mkdir PyDS
mkdir PyDS/Archives
mkdir PyDS/Source

Der nächste Schritt ist das Laden der ganzen Pakete aus dem Netz. Statt curl -O kann man auch mit wget die Dateien laden (auf MacOS X ist wget nicht vorinstalliert, da gibts nur curl):

cd ~/PyDS/Archives
curl -O http://www.python.org/ftp/python/2.2.2/Python-2.2.2.tgz
curl -O http://www.amk.ca/files/python/medusa-0.5.4.tar.gz
curl -O http://www.equi4.com/pub/mk/metakit-2.4.9.2.tar.gz
curl -O http://telia.dl.sourceforge.net/sourceforge/cheetahtemplate/Cheetah-0.9.15a3.tar.gz
curl -O http://telia.dl.sourceforge.net/sourceforge/pyxml/PyXML-0.8.2.tar.gz
curl -O http://www.cosc.canterbury.ac.nz/~greg/python/Pyrex/Pyrex-0.5.tar.gz
curl -O http://telia.dl.sourceforge.net/sourceforge/docutils/docutils-0.3.tar.gz
curl -O http://simon.bofh.ms/~gb/PyDS-0.7.1.tar.gz
curl -O http://www.pythonware.net/storage/Imaging-1.1.4.tar.gz
curl -O http://osdn.dl.sourceforge.net/sourceforge/pywebsvcs/SOAPpy-0.10.1.tar.gz

Generell sind alle oben aufgeführten Files auch unterhalb http://simon.bofh.ms/~gb/ verfügbar, einfach den Dateinamen hinten dranhängen. Damit kann man auch an die von mir geprüften und benutzten Versionen drankommen, wenn die Maintainer der jeweiligen Pakete eine neue Version rausbringen und die alten Versionen entsorgen. Ich kann nicht dauernd die Downloadlinks hier aktualisieren. Ok, ich kann schon, aber ich will nicht .

PyRex ist derzeit nicht verwendet, ich installiere es nur generell mit, da man sich damit zeitkritische Bereiche vornehmen kann um sie durch C-Source zu ersetzen. Jetzt werden die Pakete ausgepackt:

cd ~/PyDS/Source

tar xvfz ../Archives/Python-2.2.2.tgz
tar xvfz ../Archives/PyXML-0.8.3.tar.gz
tar xvfz ../Archives/Cheetah-0.9.15a3.tar.gz
tar xvfz ../Archives/medusa-0.5.4.tar.gz
tar xvfz ../Archives/metakit-2.4.9.2.tar.gz
tar xvfz ../Archives/Pyrex-0.5.tar.gz
tar xvfz ../Archives/docutils-0.3.tar.gz
tar xvfz ../Archives/PyDS-0.7.1.tar.gz
tar xvfz ../Archives/Imaging-1.1.4.tar.gz
tar xvfz ../Archives/SOAPpy-0.10.1.tar.gz

Metakit muss auf Mac OS X gepatcht werden, da das Makefile kein gültiges dynamisches Bundle erstellt, so das es nicht geladen werden können. Ein passendes Makefile.in liefere ich in PyDS mit.

cd ~/PyDS/Source/metakit-2.4.9.2/unix
cp ~/PyDS/Source/pyds-0.7.1/metakit-Makefile.in Makefile.in

Jetzt wird Python installiert und Pyrex installieren wir gleich mit. Python wird nach /opt/pyds installiert, alle Libraries landen auch da. Damit kann man den Python Desktop Server schnell löschen.

cd ~/PyDS/Source/Python-2.2.2
./configure --prefix=/opt/pyds
make
sudo make install

cd ~/PyDS/Source/Pyrex-0.5
sudo /opt/pyds/bin/python setup.py install

/opt/pyds/bin/pyrexc hat bei der Installation eine Startzeile bekommen, die den Python Interpreter über den Pfad lädt, anstatt direkt. Diese Zeile muss ausgetauscht werden. Die falsche Zeile:

#!/usr/bin/env python2.2

Sollte so aussehen:

#!/opt/pyds/bin/python2.2

Jetzt wird das ganze weitere Gesumse installiert.

cd ~/PyDS/Source/PyXML-0.8.3
sudo /opt/pyds/bin/python setup.py install

cd ~/PyDS/Source/Cheetah-0.9.15a3
sudo /opt/pyds/bin/python setup.py install

cd ~/PyDS/Source/medusa-0.5.4
sudo /opt/pyds/bin/python setup.py install

cd ~/PyDS/Source/docutils-0.3
sudo /opt/pyds/bin/python setup.py install

cd ~/PyDS/Source/SOAPpy-0.10.1
sudo /opt/pyds/bin/python setup.py install

cd ~/PyDS/Source/metakit-2.4.9.2/unix
./configure --prefix=/opt/pyds --with-python=/opt/pyds
make
sudo make install

cd ~/PyDS/Source/Imaging-1.1.4
cd libImaging
./configure
make
cd ..
sudo /opt/pyds/bin/python setup.py install

Damit ist die Entwicklungsumgebung fertig installiert. Jetzt wird der Python Desktop Server installiert. Die Installation ist ähnlich einfach wie die Installation der ganzen anderen Pakete.

cd PyDS-0.7.1
sudo /opt/pyds/bin/python setup.py install

Ok, jetzt ist das Paket installiert, jetzt kann man es benutzen. Dazu gibt es drei wichtige Kommandos. Die ersten beiden sind selbstsprechend:

/opt/pyds/bin/python /opt/pyds/bin/pyds-start
/opt/pyds/bin/python /opt/pyds/bin/pyds-stop

Mit diesen Kommandos wird der Server gestartet oder gestoppt. Die Dateien legt er in ~/.PyDS/ ab, also für jeden Benutzer getrennt. Im Verzeichnis ~/.PyDS/etc/ sollte jetzt noch eine Datei mit dem Namen PyDSConfig.py angelegt werden, mit folgendem Inhalt (damit wird auf Deutsch umgestellt):

# local config

language = 'de'

# folgende Zeile auskommentieren und einen anderen Port wählen
# wenn mehrere PyDS auf einem Rechner laufen:
#serverport = 4334

Das nächste Kommando dient zum Start des Webbrowsers auf dem richtigen Port. Der Aufruf kann zum Beispiel so aussehen:

/opt/pyds/bin/python /opt/pyds/bin/pyds-browse netscape | sh

Alternativ kann man sich auch einfach ein Bookmark auf die Adresse des Servers anlegen: http://localhost:4334/

Einer der Parameter kann auch ein "%s" enthalten, wenn ja, wird dort die URL für den Desktopserver eingetragen. Ansonsten wird sie einfach hinten drangehängt. Nach dem ersten Zugriff müssen einige Optionen gesetzt werden. Zusätzlich bitte dran denken in den Optionen das Upstreaming anzuschalten, sobald alle Einstellungen vollständig sind, sonst wird die Homepage nicht gespeichert!

Mac OS X User wollen sich vielleicht auch den folgenden Text durchlesen: Installation von PyDS unter einem eigenen User mit OS X. Dort wird beschrieben wie man unter MacOS X den Server automatisch mitstartet bei Systemstart, so das er im Prinzip immer läuft. Der Server braucht im laufenden Betrieb nur sehr wenig Resourcen, er sollte also nicht stören.