Windows Installation

Gültig ab: EBKuS 4.4.1

Die Software, mit der frühere Versionen von EBKuS auf Windows automatisch installiert wurden, ist inzwischen in die Jahre gekommen. Aber Version 4.4.1 ist nun auch eine automatische Installation mit neuerer Software möglich. Dazu ist eine komplette Neuinstallation erforderlich. Der parallele Betrieb von alter und neuer Software ist nicht möglich.

Benötigte Software

• Python 2.7.2
• MySQL-python-1.2.3
• pywin32-216
• MySQL 5.1
• Apache 2.2
• Reportlab 1.19

Alle benötigten Dateien befinden sich auf dem EBKuS FTP-Server in diesem Verzeichnis. Nur die ersten drei müssen manuell heruntergeladen und installiert werden, die übrigen können automatisch heruntergeladen (sofern eine Internetverbindung besteht) und installiert werden.

Natürlich muss noch die neueste EBKuS-Software selbst heruntergeladen werden.

Sonstige Voraussetzungen

• Betriebssystem: Erfolgreich getestet auf Windows 2000 Professional, Windows XP Professional und Windows 7 Professional. Berichte über erfolgreiche Installationen auf Windows Server 2003 und 2008 stehen noch aus, es ist aber anzunehmen, dass das funktioniert.
• Die von einer EBKuS-Installation verwendeten Ports dürfen nicht anderweitig verwendete werden:
  • Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen Vorlage:Config verändert werden)
  • Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen Vorlage:Config verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.
  • Port 3306 für den MySQL-Datenbankserver
  • Die in der ebkus.conf explizit genannten Ports für die EBKuS-Instanzen
• Administratorrechte für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.
• Die von EBKuS verwendeten Namen für Dienste dürfen nicht in Gebrauch sein: Apache, MySQL sowie mit die mit EBKuS beginnenden Namen für die Instanzen.
• Keine Reste in der Registry von früheren Installationsversuchen :-)

Python installieren

Zuerst Python

• python-2.7.2.msi

und dann PyWin und MySQL-python

• pywin32-216.win32-py2.7.exe
• MySQL-python-1.2.3.win32-py2.7.exe

installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man Start > Programme > Python 2.7 > Python (command line) aufrufen und dort folgende Eingaben machen:

 >>> import win32service
 >>>
 >>> import MySQLdb
 >>>

Beide Importe müssen ohne Fehlermeldungen funktionieren.

Erstkonfiguration erzeugen

Eine

Vollautomatische Testinstallation

Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere dass die beiden Standardport 80 und 443 zur Verfügung stehen), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):

 C:\>cd EBKuS-4.4.1
 C:\EBKuS-4.4.1>install.py c:\ebkus_installation

Den Fortgang der Installation sieht man auf der Konsole und in der Datei c:\ebkus_installation\install.log.

Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, demo und muster_efb. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL https://localhost/ebkus/demo/ bzw. /muster_efb/.

Die dabei entstandene Datei c:\ebkus_installation\ebkus\ebkus.conf sollte man sichern, da sie der Ausgangspunkt für die eigentliche Installation darstellt.

Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:

 C:\EBKuS-4.4.1>uninstall.py --all c:\ebkus_installation

bzw.

 C:\EBKuS-4.4.1>uninstall.py c:\ebkus_installation ebkus

Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.

Anpassen der Konfiguration

Installation ohne Internetzugang

Wenn alle Dateien aus diesem Verzeichnis des FTP-Servers in das Verzeichnis c:\ebkus_installation\download kopiert werden, wird kein Internetzugang benötigt. Alternativ kann bei jedem Aufruf von install.py ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:

 C:\>install.py --d c:\ebkus_download c:\ebkus_installation

Falls im Falle eine Proxies der Download nicht klappt, kann man das auch so machen.

Installationsskript ausführen

Wiederholte Ausführung

Mögliche Probleme

• Nicht vollständig deinstallierte Dienste: notfalls mit sc delete <Name> entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand Deaktiviert, muss ein Neustart gemacht werden.
• Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.

Tips

Hilfe für alle Skripte erhält man mit der Option --help oder kurz -h:

 C:\EBKuS-4.4.1>install.py --help
 C:\EBKuS-4.4.1>install.py -h