Debian Paket

Achtung: Das Debian-Paket fordert nicht automatisch die Installation der MySQL 5 Datenbank an. Wenn diese also auf dem Computer noch nicht installiert ist und kein externer Datenbankserver genutzt werden soll, muss unbedingt vor Installation des Programms das Paket mysql-server-5.0 extra installiert werden!

Das Debian Paket ist mit Debian sid und etch, sowie Ubuntu edgy, gutsy und hardy kompatibel. Alle erforderlichen Abhängigkeiten werden vom Paket automatisch angefordert. Verwenden Sie zur Installation am besten ein grafisches Werkzeug wie gdebi oder synaptic. In der Konsole kann es sonst mit folgendem Befehl installiert werden:

sudo dpkg --install /pfad/zur/wslehrerzimmer-paketdatei.deb
("pfad/zur/wslehrerzimmer-paketdatei.deb" durch den korrekten Pfad ersetzen)

Installation des Quellpaketes

Für die Installation des Quellpaketes ist die manuelle Installation zusätzlicher Systemkomponenten erforderlich. Diese müssen separat heruntergeladen und installiert werden. Es handelt sich dabei jedoch um Standardkomponenten, die bei allen gängigen Linux-Distributionen über das jeweilige Paketverwaltungssystem einfach installiert werden können. Die meisten Komponenten dürften in einem durchschnittlichen Linux System abhängig von der verwendeten Desktopumgebung sogar bereits installiert sein. Das endgültige Programm wird in verschiedenen Paketversionen für gängige Linux-Distributionen verfügbar sein, die dann diese Abhängigkeiten automatisch erfüllen.

Die Installation der Testversion unter Linux erfolgt in 3 Arbeitsschritten:

1. Vorbereitung des Systems, Installation der erforderlichen Erweiterungen

2. Installation des Programms

3. Einrichtung des Programms

Gehen Sie bitte bei der Installation Schritt für Schritt in der angegebenen Rehienfolge wie hier beschrieben vor.

Vorbereitung des Systems, Installation der erforderlichen Erweiterungen

Installieren Sie mit dem Paketmanager Ihrer Linux Distribution die unten aufgeführten Pakete.

Nachdem Sie alle Komponenten erfolgreich installiert haben, folgen Sie bitte den Hinweisen zur Installation des eigentlichen Programms weiter unten auf dieser Seite.

Achten Sie bitte bei der Installation aller Python bezogenen Komponenten darauf, die Versionen für Python 2.5 herunterzuladen!

Folgende Komponenten müssen heruntergeladen werden:

• Python 2.5

  Python ist die Laufzeit-/Programmierumgebung, in der wslehrerzimmer entwickelt ist.
  

• MySQL 5.x­
  
  ­MySQL ist das Datenbanksystem, in dem wslehrerzimmer seine Daten speichert und verwaltet. Wenn Sie auf Ihrem System bereits MySQL 4 verwenden, müssen Sie entweder MySQL 5 manuell parallel einrichten, oder auf einem separaten Rechner installieren und über das Netzwerk zugreifen.

• GTK 2.10 (oder neuer)

  GTK ist das Window-toolkit, der "Fenster- und Objektbaukasten" aus dem die Benutzeroberfläche von wslehrerzimmer erstellt ist. Daher ist dieser erforderlich, um das Programm überhaupt anzuzeigen.

• Glade 2.10 (oder neuer)
  
  Glade ist eine Erweiterung/ergänzung zur grafischen Erstellung von GTK Programmen.

• Pygtk 2.10 (oder neuer)

  Python-GTK ist die Schnittstelle von Python zu GTK.

• Pygobject 2.12 (oder neuer)

  Eine zusätzlich erforderliche Erweiterungsbibliothek für Pygtk.

• pycairo 1.2 (oder neuer)

  Eine zusätzlich erforderliche Erweiterungsbibliothek für Pygtk.

Installation des Programms

Das Programm selbst kann hier heruntergeladen werden:

Zur Downloadseite

Nachdem Sie das Programmarchiv an einen beliebigen Ort auf Ihrem Computer heruntergeladen haben, entpacken Sie es zunächst mit einem Zip-Programm Ihrer Wahl. Alle Teile des eigentlichen Programms befinden sich nun in dem entpackten Ordner "wslehrerzimmer" und seinen Unterverzeichnissen.

Verschieben Sie diesen Ordner an einen Platz Ihrer Wahl auf der Festplatte, dort wo Sie ihn auf jeden Fall wieder finden.

Wechseln Sie nun in das Unterverzeichnis wslehrerzimmer/bin. Erzeugen Sie Verknüpfungen auf dem Desktop zu den folgenden Dateien: "wsl-admin", "wsl-planner" und "wsl-viewer".

Wenn Sie die Programme ohne Pfadangabe global im System starten möchten, legen Sie mit root Benutzerrechten symbolische Verknüpfungen zu den oben genannten Dateien im Verzeichnis /usr/bin oder /usr/local/bin an.

Damit ist die Installation des eigentlichen Programms abgeschlossen. Nun muß im letzten Schritt nur noch die Datenbank eingerichtet werden.

Einrichtung des Programms

Nach erfolgter Installation muß die Datenbank eingerichtet und dem Programm mitgeteilt werden, wie und wo sie erreichbar ist.

1. Datenbank einrichten

   Stellen Sie sicher, daß der mysql-Server auf Ihrem System gestartet wurde.
   
   Alle folgenden Befehle müssen mit den Rechten eines MySQL-Benutzers ausgeführt werden, der volle Berechtigung zum Anlegen und Verändern von Datenbanken hat.

   1. Anlegen einer neuen Datenbank:
      
      Öffnen Sie eine Konsole und führen Sie darin die folgenden Kommandos aus:
      
      # mysqladmin create -u mysqluser -p wslehrerzimmer
      Enter password: mysqlpasswort
      
      wobei mysqluser durch den Benutzernamen des Datenbankbenutzers ersetzt wird, z.B. root und mysqlpasswort durch dessen Passwort.

   2. importieren der mitgelieferten Musterdaten
      
      wechseln Sie im Installationsverzeichnis "wslehrerzimmer" in das Unterverzeichnis "mysql":
      
      # cd ./mysql
      
      Und führen Sie von dort aus folgenden Befehl aus:
      
      # mysql -D testwsl -u mysqluser -p < ./WS_STUNDENPLAN.sql
      Enter password: mysqlpasswort
      
      Wobei mysqluser und mysqlpasswort wie im letzten Schritt ersetzt werden müssen.
      
      Wenn auf Ihrem System phpmyadmin installiert ist, können Sie die beiden Schritte auch entsprechend dort ausführen.

2. Einrichtungsdatei anpassen

   1. wechseln Sie vom Installationsverzeichnis "wslehrerzimmer" in das Unterverzeichnis "usr/lib/wslehrerzimmer"

   2. Dort befindet sich eine Datei namens 'config.py'. Öffnen Sie diese mit einem Texteditor ihrer Wahl.

   3. Passen Sie alle Einstellungen für die Datenbank entsprechend den Daten aus Schritt 1 an und speichern sie das Dokument. Alle anderen Daten in der Datei bitte unbedingt unverändert lassen.