Uebungsutils - Eine Arbeit im Zuge des Projekts MML an der TU Graz

Bei dem vorliegenden Programmpaket handelt es sich um einen Satz von Pythonskripten, die der Verwaltung von an Computern durchgeführten Übungen dienen. Es soll sowohl die Abgabe von Beispielen durch Studierende als auch die Korrektur der Arbeiten durch die Lehrenden erleichtert werden.

Download & Installation

Die aktuelle Version 1.0 ist am ftp Server des Institut f. Theoretische Physik unter Uebungsutils-1.0.tar.gz erhältlich. Alternativ gibt es binary und source rpm Pakete für RedHat 7.3 auf dem FTP-Server

Die Installation erfolgt durch Auspacken der Datei in ein temporäres Verzeichnis:

      % tar zxfv uebungsutils-1.0.tar.gz

und ein anschließendes Exekutieren von:

      % cd Uebungsutils-1.0
      % python setup.py install

um es direkt in das root directory zu installieren, oder:

      % make rpm && rpm -Uvh dist/Uebungsutils-1.0-?.noarch.rpm

um ein rpm Packet zu erzeugen und zu installieren.

Konfiguration

Um die Installation für eine Vorlesung zu konfigurieren, ist durch den Besitzer bzw. den Systemadministrator der Abgabebaum zu initialisieren. Dies geschieht durch folgenden Aufruf:

      % /usr/sbin/uebungssetup <user> <path> <group>

Dabei ist "user" der Besitzer des Abgabebaums, "path" der Pfad zum Baum und "group" die Unix Benutzergruppe, die Verwaltungsrechte im Abgabebaum hat.

Die Konfiguration der Übung muss anschließend vom Systemadministrator in der globalen Konfigurationsdatei /etc/Uebungsutils/uebungsutils.conf durch anfügen einen entsprechendend Eintrag vorgenommen werden:

      % echo "<user>:<path>:<group>:<Bezeichnug der Übung>" >> /etc/Uebungsutils/uebungsutils.conf

Im Abgabebaum wird eine Datei "path"/etc/filelist.ex erzeugt. Diese ist den eigenen Gegebenheiten anzupassen und unter dem Namen "path"/etc/filelist abzuspeichern. Sie enthält eine Liste mit möglichen Dateinamen für die Abgabe.

Existiert die Datei "filelist" sowie der entsprechende Eintrag in "uebungsutils.conf" können Übungen abgegeben werden.

Benutzerprogramme

Für den normalen Benutzer stehen drei Programme zur Verfügung:

1. uebungsabgabe - dient der Abgabe der fabrizierten Dateien

2. uebungsstatus - stellt den Status der eigenen abgegebenen sowie der noch ausstehenden Übungen fest

3. uebungsdaten - lädt für den Benutzer bestimmte Dateien aus dem Repository

Verwaltung

Zur Verwaltung verfügt der Besitzer eines Abgabebaums über folgende Programme:

1. uebungsstatus - erzeugt eine Liste der abgegebenen Dateien

2. uebungskorrektur - erlaubt die Bewertung abgegebener Dateien

3. uebungschecktrees - dieses Programm hat einen Sonderstatus; es überprüft Abgabebäume auf korrekt gesetzte Berechtigungen; es sollte nie direkt aufgerufen werden und über einen "cron job" laufen.

Zur Verteilung von Daten gibt es die Möglichkeit im Verzeichnis "path"/Repository numerierte Unterverzeichnise anzulegen (z.B.: "path"/Repository/1). Darin abgelegte Dateien können mit dem Benutzerprogramm "uebungsdaten" abgerufen werden.

Zur Gruppeneinteilung genügt es, im Verzeichnis "path"/Users die Gruppen als Verzeichnis zu erstellen und die Benutzer einzutragen:

        % mkdir -p Users/Gruppe_A Users/Andere_Gruppe Users/1}
        % touch Users/Gruppe_A/alf Users/1/heidi Users/1/maja}

Diese Befehle legen drei Gruppen namens "Gruppe_A", "Andere_Gruppe" und "1" an und weisen die Unixbenutzer "alf", "heidi" und "maja" den Gruppen zu.

Die Beurteilung von agegebenen Dateien erfolgt mit "uebungskorrektur". Der Aufruf des Programmes muss im Abgabebaum und im Verzeichnis des Delinquenten erfolgen.

BUGS

Keine gravierenden.

REPORTING BUGS

Sollten irgendwo Fehler auftreten, Anregungen oder Wünsche vorhanden sein, wenden Sie sich bitte an den Author Christian Pfaffel.