{{tag> drucken schulkonsole}}

====== Verwaltung von Pykota in der Schulkonsole ======
<note important>Änderung für linuxmuster.net ab 6.1</note>
Die Installation hat sich jetzt völlig geändert. Es gibt das Paket **linuxmuster-pk-schulkonsole**. Es ist für
die Schulkonsole ab Version **0.19** vorhanden. Es muss nur noch das Paket linuxmuster-pk-schulkonsole installiert werden.
Dadurch ist **Pykota** voll einsatzfähig. Alle Anweisungen auf dieser Wiki-Seite sind obsolet.

<note important>Diese Anleitung gilt nur für linuxmuster.net 6. </note>

<note warning>Die Scripte beinflussen ggf. die Funktionssicherheit der Schulkonsole. Durch die Updates der Schulkonsole werden die Änderungen u.U. überschrieben!</note>

Die folgenden Perl-Scripte erweitern die Schulkonsole um eine einfache Administrationsoberfläche für Pykota, das zunächst installiert sein muss. Die Scripte sind mit der Version 0.9.29 der Schulkonsole entwickelt worden. Die Scripte arbeiten die Befehle direkt ab, so dass u.U. der Seitenaufbau bei vielen Änderungen sehr lange dauern kann. Es werden im Gegensatz wie z.B. beim Benutzeranlegen **keine** Hintergrundprozesse gestartet. \\
Der hier verwendete Wrapper ist nun abgesichert -> nur der User "administrator" darf ihn uneingeschränkt benutzen. Ein beliebiger User kann mit dem Wrapper nur seine eigene Druckquota abfragen.

=== 1. Kopieren der Dateien ===
Die zip-Datei enthält die Scripte {{anwenderwiki:drucken:druckquotas-sk8.zip|Download-SK8}} 
  - Wrapper zu Pykota, der mit root-Rechten auf die pykota-Datenbank zugreift und Konfigurations-Dateien verändert: \\ Kopieren Sie die Datei <code>druckquota.pl</code> nach **''/usr/lib/schulkonsole/bin/''**
  - Kopieren Sie die CGI-Scripte <code>druckquotas
druckquotas_teachers
druckquotas_classes
druckquotas_students
druckquotas_projects
druckquotas_printers
druckquotas_others
druckquotas_settings</code> nach **''/usr/lib/schulkonsole/cgi-bin/''**
  - Kopieren des Perl-Package <code>Druckquota.pm</code>nach **''/usr/share/schulkonsole/Schulkonsole''**
  - Kopieren Sie die shtml-Dateien <code>druckquotas.shtml
druckquotas_teachers.shtml
druckquotas_classes.shtml
druckquotas_students.shtml
druckquotas_projects.shtml
druckquotas_printers.shtml
druckquotas_others.shtml
druckquotas_settings.shtml
druckquotas.subm.shtml.inc</code> nach **''/usr/share/schulkonsole/shtml''**

----

=== 2. Änderungen an Dateien ===
Ergänzen der Datei **''/etc/linuxmuster/schulkonsole/permissions.conf''** um die Zeile:
  [Pages]
  ...
  domadmins=druckquotas druckquotas_teachers druckquotas_classes druckquotas_printers druckquotas_others druckquotas_students druckquotas_settings druckquotas_projects
  ...

Ergänzen der Datei **''/usr/share/schulkonsole/shtml/menu.shtml.inc''** um die drei Zeilen:
  ...
  <!--#if expr="$link_druckquotas" -->
     <a href="druckquotas"><gettext>DruckQuota</gettext></a>
  <!--#endif -->
  ...

----

=== 3. Rechte anpassen ===
Die Scripte müssen auf ausführbar gesetzt sein:
  chmod 755 /usr/lib/schulkonsole/cgi-bin/druckquotas*
  chmod 755 /usr/lib/schulkonsole/bin/druckquota.pl


----

=== 4. sudoers anpassen ===
Das Script **''druckquota.pl''** muss mit SUID-Rechten ausgeführt werden. Im Script wird überprüft, ob der Benutzer "administrator" das Script aufgerufen hat, ansonsten beendet sich das Script selbst. Dazu eine Datei anlegen: **''/etc/sudoers.d/druckquota-suid''**: (//Hinweis: Dateiname darf keinen Punkt enthalten//)
  
<code text druckquota-suid>
# /etc/sudoers.d/druckquota-suid
# MR 14.04.2013
#

Cmnd_Alias  DRUCKQUOTA=/usr/lib/schulkonsole/bin/druckquota.pl
www-data  ALL=NOPASSWD: DRUCKQUOTA

</code>

----
**Nun als "administrator" in der Schulkonsole anmelden und den neuen Menü-Punkt "DruckQuota" auswählen.**