Logs und Fehlersuche

English

7. Logs und Diagnose

7.1 Die Logs einer Box

Log	Inhalt
Seite, Tab „Log“ (admin)	die letzten 5000 Einträge, live, mit Filtern für Stufe und Text; „Als Datei speichern“
/srv/tinyjukebox/log/tinyjukebox.log (+ .1 … .4)	das vollständige Log; es bleibt über einen Neustart
journalctl -u tinyjukebox	Warnungen und Fehler, und was das Start-Skript sagt; nach einem Neustart weg
/srv/tinyjukebox/state/history.log	eine Zeile je Wechsel der Version: wann, von, nach, warum, durch wen
/var/log/tinyjukebox-install.log	was der Installer getan hat

Der Dienst selbst: sudo systemctl status tinyjukebox, sudo systemctl restart tinyjukebox. Nach einem Absturz startet systemd ihn von selbst neu.

7.2 Die Logs der Bibliothek

Log	Inhalt
Seite der Bibliothek, Tab „Log“	das Log der Bibliothek und das jeder Box: Warnungen, Fehler und Ereignisse, die die Boxen geschickt haben, mit Filtern; „Als Datei speichern“
NAS: /var/packages/tinyjukebox-library/var/library.log	das Log der Bibliothek; beim Start ihr Fingerabdruck
NAS: var/server.log	warum ein Start fehlgeschlagen ist
NAS: /var/log/packages/tinyjukebox-library.log	was die Skripte des Pakets ausgegeben haben
Docker: docker logs library	die Ausgabe der Bibliothek, das erzeugte Passwort von admin

Der Tab „Log“ der Bibliothek hilft, wenn eine Box nicht zur Hand ist: Die Boxen schicken ihre Warnungen und Fehler an die Bibliothek, ohne Passwörter, Schlüssel oder UIDs von Tags. Eine Box, die nicht starten kann, meldet auch das; der Tab „Boxen“ zeigt sie dann mit „startet seit … nicht“ (library.md, Abschnitt 4.22).

7.3 Mehr Details im Log

Die Box schreibt ins Log auf der Stufe INFO. Für eine Fehlersuche auf DEBUG stellen:

1. Eine Box des Installers hat keine eigene Konfigurationsdatei. Zuerst die ihres Slots kopieren: cp /srv/tinyjukebox/current/config/tinyjukebox.yaml /srv/tinyjukebox/config/.
2. In /srv/tinyjukebox/config/tinyjukebox.yaml log-level: DEBUG setzen.
3. sudo systemctl restart tinyjukebox.
4. Nach der Fehlersuche die Kopie wieder entfernen und den Dienst neu starten: Sonst wäre die Datei ab da die Konfiguration jeder Version, auch jeder späteren.

7.4 Tasten, LED und Leser

Der Tab „System“ hat für Admins die Karte „Hardware“: was die Treiber über die Tasten, die LED und den RFID-Leser sagen, zweimal pro Sekunde. Hat eine Taste keine Wirkung, zeigt sie, ob die Taste überhaupt an der Box ankommt. Die Hardware von Hand auf der Konsole prüfen: operations.md, Abschnitt 9.2.

---

9. Wenn etwas nicht funktioniert

Das Benutzerhandbuch nennt, was ein Benutzer tun kann (Benutzerhandbuch, Abschnitt 12). Für einen Admin:

Symptom	Nachsehen	Ursache und Abhilfe
LED bleibt rot	sudo systemctl status tinyjukebox, journalctl -u tinyjukebox	der Dienst läuft nicht oder scheitert beim Start, z. B. an einer ungültigen Konfiguration: die Meldung nennt den Pfad
Kein Tag wird erkannt	das Log: RFID - …	die Zeile sagt, warum: Der Leser lässt sich nicht starten, er antwortet nicht (Verdrahtung, Versorgung), oder dem Programm der Version wird nicht vertraut – dann den Installer noch einmal ausführen
Webseite nicht erreichbar	sudo systemctl status tinyjukebox	der Dienst läuft nicht; oder der Name ….local wird nicht gefunden: die Adresse der Box verwenden
LED abwechselnd rot, weiß, magenta, gelb; nichts spielt	Tab „System“; tinyjukebox-slot status	die Bibliothek ist zu alt für die Version der Box: die Bibliothek aktualisieren (Abschnitt 4.3) oder an der Box zurückgehen (Abschnitt 4.2)
Die Box bekommt keine neue Version	tinyjukebox-slot status, tinyjukebox-slot check; Tab „Versionen“ der Bibliothek	Update-Art „nur von Hand“ oder „aus“; die Version ist nicht use; die Box ist schon einmal von ihr zurückgegangen; die Bibliothek hat keinen Zugang zu den Releases (Abschnitt 3.7)
Die Box läuft wieder mit einer älteren Version	/srv/tinyjukebox/state/history.log, Tab „Boxen“ der Bibliothek	die neue Version hat ihre Probe nicht bestanden, und die Box ist zurückgegangen; die Zeile sagt, warum
Die Seite der Box sagt, die Bibliothek sei nicht verbunden	Tab „System“, Abschnitt „Bibliothek“; das Log	das NAS ist aus oder nicht in diesem WLAN: Die Box spielt, was sie hat, und liefert ihre Änderungen später ab
Die Bibliothek startet nicht	var/server.log auf dem NAS; docker logs library	die Zeile sagt, warum, z. B. fehlt var/library.yaml

Weitere Symptome, mit den Zeilen des Logs: operations.md, Abschnitt 9.3.