Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision | ||
anwenderwiki:classroom_management:maussk [2021/10/06 22:52] – [9.) Konfigurationsdateien] martin.res | anwenderwiki:classroom_management:maussk [2023/04/12 00:38] – [d) mausdienst.cfg] martin.res | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | {{tag> classroommanagement maussk minisk lmn7}} | ||
+ | ====== MAusSK - für linuxmuster.net 7 (Version 0.9x bis 2022) ====== | ||
+ | |||
+ | Hier gehts es zur neuen aktuellen | ||
+ | |||
+ | Ab Version MAusSK 0.88 bis Version 0.91c erkennt das Installationsscript am Server ob eine linuxmuster.net 6 oder 7 vorliegt und passt die Installation entsprechend an. An den Clients ist MAusSK mit Ubuntu-bionic, | ||
+ | Ab Version MAusSK 0.92 (Sep' | ||
+ | |||
+ | Download Version für alten Ubuntu-Client: | ||
+ | {{: | ||
+ | |||
+ | Download Version für neuen Ubuntu-Client ab 2021: | ||
+ | {{: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Bei lmn 6 betrafen die Sperren meist den aktuellen Raum in dem auch der Master-PC angemeldet war. Bei lmn7 sind die Sperren meist Benutzer-bezogen oder betreffen eine ganze Gruppe, es ändert sich somit die genaue Funktion der Sperren. Z.B wird bei der Internet-Sperre nicht der Client-PC, sondern der angemeldete Benutzer gesperrt. | ||
+ | |||
+ | |||
+ | Bisher umgesetzt und in der Testphase: | ||
+ | * Sperren der Computerbildschirme | ||
+ | * Internetsperre -> [[anwenderwiki: | ||
+ | * Intranetsperre | ||
+ | * Sperren der Drucker | ||
+ | * WLAN Sperre und Freigabe | ||
+ | * URL-Filter aktivieren / deaktivieren | ||
+ | * Nachricht senden | ||
+ | * Logout, Reboot, Herunterfahren | ||
+ | * Befehle am Client ausführen | ||
+ | * Website am Client aufrufen | ||
+ | * Thumbnails der Bildschirme | ||
+ | * Passwörter von Klassen oder einzelnen Schülern ändern | ||
+ | * Austeilen, Einsammeln -> [[anwenderwiki: | ||
+ | * Zeigen, Verbinden mit VNC -> [[anwenderwiki: | ||
+ | * Screenshots erstellen und abspeichern -> [[anwenderwiki: | ||
+ | * Wake on LAN | ||
+ | * Layout der Thumbnails dem Grundriss des Computerraumes anpassen -> [[anwenderwiki: | ||
+ | | ||
+ | Technische Dokumentation der Funktionen -> [[anwenderwiki: | ||
+ | |||
+ | |||
+ | Weitere Erläuterungen siehe auch Vorgängerversion -> [[anwenderwiki: | ||
+ | ===== 1.) Installation am server ===== | ||
+ | Installationspaket herunterladen und entpacken, man erhält ein Verzeichnis maussk.files . | ||
+ | |||
+ | |||
+ | Am server als root anmelden und Script starten: | ||
+ | < | ||
+ | # cd maussk.files | ||
+ | # ./ | ||
+ | </ | ||
+ | |||
+ | Die Konfigurations-Datei findet man danach unter ''/ | ||
+ | |||
+ | Am Server wird der schukodaemon als systemd-Service gestartet und schreibt (falls aktiviert) log-Dateien. | ||
+ | ===== 2a.) Installation am Linux-Client bis Version MAusSK 0.91c ===== | ||
+ | |||
+ | <note important> | ||
+ | < | ||
+ | sudo / | ||
+ | </ | ||
+ | Die Konfigurations-Datei findet man danach am server unter ''/ | ||
+ | Bei Anmeldung als " | ||
+ | |||
+ | ===== 2b.) Installation am Linux-Client ab Version MAusSK 0.92 ===== | ||
+ | <note important> | ||
+ | Der Client benötigt während des Installationsprozesses auch für den User root Internetzugang, | ||
+ | Am Linux-Client als ein Lehrer anmelden, ein Terminal starten und sich zum lokalen User root des Linux-Clients machen. Danach in das von Server eingebundene Programmverzeichnis wechseln und die Installation ausführen: | ||
+ | < | ||
+ | $ sudo su | ||
+ | # cd / | ||
+ | # ./ | ||
+ | </ | ||
+ | Damit am Linux-Client das Bildschirm-Sperren funktioniert, | ||
+ | |||
+ | Die Konfigurations-Datei befindet sich am Server unter ''/ | ||
+ | |||
+ | ===== 2c.) Lokale Installation am Linux-Client ab Version MAusSK 0.94 ===== | ||
+ | An Linux-Client kann man MAusSK auch komplett lokal installieren. Bei Updates oder Änderungen in der Konfigurationsdatei muss man dann allerdings immer ein neues Image schreiben. Dabei wird die MAusSK unter ''/ | ||
+ | < | ||
+ | $ sudo su | ||
+ | # cd / | ||
+ | # ./ | ||
+ | </ | ||
+ | <note important> | ||
+ | ===== 3.) Installation am Windows-Client ===== | ||
+ | |||
+ | |||
+ | ==== a) Windows Firewall für den Mausdienst vorbereiten ==== | ||
+ | |||
+ | Der Mausdient-Port kann pauschal mit einem Konsolenbefehl geöffnet werden. An der Eingabeaufforderung am Windows-Client mit Administratorberechtigung ausführen: | ||
+ | |||
+ | C:\> netsh advfirewall firewall add rule name=" | ||
+ | | ||
+ | (Alternativ kann der Mausdienst manuell gestartet werden und dann die erscheinende Firewallanfrage bestätigt werden.) | ||
+ | |||
+ | <note important> | ||
+ | |||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | ==== b) Mausdienst im Windows - logon-Script freischalten ==== | ||
+ | Bei der Installation wird am server unter ''/ | ||
+ | < | ||
+ | REM ### Mausdienst beim login starten ###" | ||
+ | |||
+ | if exist K: | ||
+ | </ | ||
+ | |||
+ | ==== c) MAusSK am Windows-Client verfügbar machen ==== | ||
+ | Nun muss das Master-Programm MAusSK am Windows-Client noch für die Lehrer verfügbar sein. Entweder durch lokale Installation am Windows-Client oder über das Netzwerk. | ||
+ | Die Programm-Datei findet man unter dem Netzwerk-Pfad: | ||
+ | |||
+ | ==== d) Thumbnails am Windows-Client verfügbar machen ==== | ||
+ | Für die Thumbnails benötigt man am Windows-Client das Programm Irfanview, das die Screenshots erstellt. Das Programm für alle User lokal mit Standard-Pfad installieren.\\ | ||
+ | In der Konfigurations-Datei am Server ''/ | ||
+ | ===== 4.) Technisches ===== | ||
+ | |||
+ | ==== a) Austeilen und Einsammeln ==== | ||
+ | |||
+ | Im Gegensatz zur WebUI verwendet MAusSK das Verzeichnis '' | ||
+ | Beim Austeilen wird im Home ein Verzeichnis '' | ||
+ | Der Einsammel-Prozess wird, falls er hängt und zu lange dauert, nach 10 Minuten terminiert. Diese Zeit kann in der '' | ||
+ | |||
+ | |||
+ | ==== b) Aktionen am Linux-Client ==== | ||
+ | |||
+ | Durch das Script '' | ||
+ | |||
+ | === i) Programminstallationen === | ||
+ | |||
+ | === ii) Konfigurationsdateien === | ||
+ | |||
+ | === iii) Mausdaemon registrieren und starten === | ||
+ | |||
+ | === iv) Zugriff für root auf den Desktop des angemeldeten Benutzers erlauben === | ||
+ | |||
+ | Datei / | ||
+ | |||
+ | <code 50xhost-root.sh> | ||
+ | #!/bin/bash | ||
+ | |||
+ | xhost +si: | ||
+ | |||
+ | </ | ||
+ | |||
+ | === v) Lokale Internetsperre === | ||
+ | In der lmn7 wird die Internetsperre Benutzer-bezogen über die Zugehörigkeit des Benutzers zur Gruppe " | ||
+ | Als Lösung wird am Linux-Client ein Script installiert, | ||
+ | Der cronjob zu dem Script muss aber nach Installation erst freigeschaltet werden, | ||
+ | |||
+ | **genaueres siehe** -> [[anwenderwiki: | ||
+ | |||
+ | ==== c) Speicherort der Zugangskennwörter ==== | ||
+ | Ab Version 0.88 liegen die Zugangskennwörter für die Clientsteuerung (Datei: md.pass) und für VNC (Dateien: x11vnc.pass, | ||
+ | ===== 5.) MAusSK im Blauen / WLAN Netzwerk ===== | ||
+ | |||
+ | Um einen Master im Blauen bzw. WLAN-Netzwerk der linuxmuster.net 7 zu betreiben benötigt man ein aktiviertes Blaues Netzwerk (oder opt1-Netzwerk) und dazu eine neue Firewallregel für Port 9731 in der OPNsense. Die Regel zum Port 4711 erlaubt den VNC-Zugriff vom Blauen Netz zum grünen Netz. | ||
+ | |||
+ | | ||
+ | |||
+ | Regel anlegen und aktivieren nicht vergessen. Die Regel erlaubt sowohl den Zugriff auf den Server, als auch den Zugriff direkt auf die Clients. | ||
+ | Den Zugriff direkt auf die Clients benötigt man um die Thumbnails abzurufen. | ||
+ | |||
+ | Falls im Netzwerk eine Client-Isolation aktiv ist, schlägt ggf. der Zugriff auf die Clients fehl. Dann muss man alles über den Server abwickeln (Option in den Einstellungen entsprechend setzen). Thumbnails kann man jedoch __nicht__ über den Server abrufen. Ebenso funktioniert dann VNC auch nicht. | ||
+ | |||
+ | |||
+ | Die Android-App ist ab Version 0.87 für linuxmuster.net 7 geeignet -> [[anwenderwiki: | ||
+ | |||
+ | ===== 6.) VNC und MAusSK ===== | ||
+ | MAusSK beherrscht selbst kein VNC, kann aber externe Tools, die Viewer, direkt ansteuern und damit automatisch eine VNC-Verbindung aufbauen. Am Linux- oder Windows-Client muss dazu ein VNC-Server aktiv sein. Der sonst übliche Port 5900 wurde beim default-cloop der linuxmuster.net auf 4711 oder 5905 geändert, um nicht mit anderen Anwendungen zu kollidieren, | ||
+ | Das bei den Clients festgelegte Kennwort des VNC-Servers muss man bei der Konfiguration der MAusSK setzen, es wird am Server gespeichert - dazu als " | ||
+ | <note warning> | ||
+ | **Sicherheitshinweis: | ||
+ | Mit der Kenntnis des VNC-Kennworts kann sich jeder an den Clients einklinken. Dies ist auch unabhängig von MAusSK möglich, wenn an den Clients ein VNC-Server läuft. An jedem Client ist jedoch das VNC-Kennwort gespeichert, | ||
+ | -> [[anwenderwiki: | ||
+ | |||
+ | |||
+ | Unter Ubuntu 20.04 wird als VNC-Viewer das Programm remmina verwendet, das leider keine passenden Konsolen-Parameter bereitstellt. Zum Ansteuern von remmina gibt es deshalb im Programmverzeichnis der MAusSK ein Shell-Script " | ||
+ | |||
+ | ===== 7.) Thumbnails und Screenshots ===== | ||
+ | Die Anzeige der Thumbnails wird in der Datei **'' | ||
+ | | ||
+ | |||
+ | Durch das Aktivieren der Thumbnails werden an den Clients reihum kleine Screenshots erstellt (voreingestellt ist ca. 2,5 Sekunden und 200x150 Pixel). Ein gesamter Durchgang eines Computerraumes von 15 Clients dauert somit ca. 40 Sekunden. Diese Werte können in der Konfiguration verändert werden, jedoch erzeugt man dadurch u.U. eine erhöhte Netzwerklast.\\ | ||
+ | Die Thumbnails sind so klein, dass in ihnen keine personenbezogenen Daten lesbar sind, was Datenschutzhinweise an die Benutzer erübrigt. Die Daten zu den Thumbnails werden direkt zwischen Lehrer-PC und Client ausgetauscht ohne Server-Beteiligung. | ||
+ | |||
+ | Zusätzlich können auch einzelne hochauflösende Screenshots erstellt und abgespeichert werden. Hier ist eine Auflösung von 800x600 voreingestellt, | ||
+ | |||
+ | Unter Windows werden die Sreenshots mit Hilfe des Programms Irfanview erzeugt, das vorab installiert sein muss. | ||
+ | |||
+ | ===== 8.) Raum Layout editieren ===== | ||
+ | |||
+ | Für einen Computerraum kann man das Layout der Thumbnails verändern um z.B. die Thumbnails dem Grundriss des Computerraumes anzupassen. | ||
+ | |||
+ | Im erscheinenden Editor ggf. zunächst die Größe der Thumbnails einstellen. Die Thumbnailgröße wird für jedes Layout getrennt gespeichert. Die Thumbnails können dann per Maus verschoben werden. Die Größe der Fläche des Layouts kann ebenfalls in gewissen Grenzen verändert werden.\\ | ||
+ | Falls man an einem Client arbeitet, der auch zum Raum gehört, kann man diesen zusätzlich im Layout einblenden, so dass er auch später in der MAusSK erscheint.\\ | ||
+ | Es wird immer das Layout des aktuellen Raumes editiert. Um weitere Räume zu layouten muss man im Hauptmenü den Menüpunkt "Raum wechseln" | ||
+ | Durch Löschen eines Layouts kehrt man wieder zur normalen Auflistung zurück.\\ | ||
+ | |||
+ | ==== a) Editieren bis Version 0.91c ==== | ||
+ | Dazu an einem Client als global-admin anmelden und anschließend auch an der MAusSK als global-admin.\\ | ||
+ | Es wird nun ein Menüpunkt " | ||
+ | Das Layout wird am Server in der Datei ''/ | ||
+ | |||
+ | |||
+ | ==== b) Editieren ab Version 0.92 ==== | ||
+ | In der Konfigurationdatei '' | ||
+ | | ||
+ | |||
+ | Nun als ein Admin-User an der MAusSK anmelden. Es wird ein Menüpunkt '' | ||
+ | Das Layout wird im User-home bzw. am Server in der Datei ''/ | ||
+ | ===== 9.) Konfigurationsdateien ===== | ||
+ | Die Konfigurationsdatein '' | ||
+ | ==== a) schukodaemon.cfg ==== | ||
+ | Pfad am Server: ''/ | ||
+ | |||
+ | ==== b) maus_sk.cfg ==== | ||
+ | Pfad am Server: ''/ | ||
+ | ==== c) mausdaemon.cfg ==== | ||
+ | Pfad am Ubuntu-Client: | ||
+ | -> [[anwenderwiki: | ||
+ | ==== d) mausdienst.cfg ==== | ||
+ | Pfad am Windows-Client: | ||
+ | |||
+ | ==== e) room_defaults ==== | ||
+ | Pfad am Server: ''/ | ||
+ | Legt fest, welchen Status die Schaltflächen (Internet/ | ||
+ | -> [[anwenderwiki: | ||
+ | ==== f) classrooms ==== | ||
+ | Pfad am Server: ''/ | ||
+ | Die Datei stammt noch aus einer linuxmuster.6, | ||
+ | -> [[anwenderwiki: | ||
+ | |||
+ | ==== g) layout.ini ==== | ||
+ | Pfad am Server: ''/ | ||
+ | Beinhaltet die Layouts der Thumbnail-Anordnungen aller Räume.\\ | ||
+ | -> [[anwenderwiki: | ||
+ | ===== X.) Fehler - Problembehebung ===== | ||
+ | **a) Verzögerter Start der MAusSK** | ||
+ | * Problem: Bei Start von MAusSK erscheint häufig nur eine weißes Fenster, es wird nicht oder nur verzögert die grafische Oberfläche aufgebaut. | ||
+ | * Lösung: Die Installation eines Paketes: < | ||
+ | **b) Sperrbild erscheint aber die vollständige Sperre des Desktops erfolgt nicht, das Sperrbild kann vom User geschlossen werden ** | ||
+ | * Problem: Der Bildschirmschoner xtrlock startet nicht, der Bildschirm wird nicht gelockt, es erscheint nur das Sperrbild, das aber weggeklickt werden kann. | ||
+ | * Ursache: für den Benutzer root ist kein Kennwort gesetzt | ||
+ | * Lösung: Kennwort für root setzen (welches ist egal) | ||
+ | **c) schukodaemon läuft nach update nicht mehr automatisch** | ||
+ | * Problem: Nach einem update des schukodaemons auf den systemd-Service startet der schukodaemon-Dienst nicht richtig | ||
+ | * Lösung: am server den schukodaemon manuell stoppen und starten:< | ||
+ | # systemctl start schukodaemon</ | ||
+ | **d) Website bei Clients öffnen** | ||
+ | * Problem: Beim Öffnen von Websites an den Clients über die MAusSK erscheint eine Proxy-Abfrage | ||
+ | * Ursache: Firefox läuft unter den User root, der die Proxy-Authentifizierung des angemeldeten Users nicht übernimmt | ||
+ | * Lösung: Version 1.x behebt das Problem | ||
+ | ===== Y.) Debugging ===== | ||
+ | |||
+ | a) Überprüfen, | ||
+ | # systemctl status schukodaemon | ||
+ | oder | ||
+ | # ps -ax | grep schuko | ||
+ | |||
+ | b) Logdatei am Server überwachen: | ||
+ | # tail -f / | ||
+ | |||
+ | c) Logging am server konfigurieren mit ausführlichen Einträgen (Datei / | ||
+ | useLog=1 | ||
+ | debug=1 | ||
+ | verbose=1 | ||
+ | und dann: | ||
+ | # systemctl restart schukodaemon |