Skip to content

4. Updates

English

4.1 Die Box-Software

Eine Box installiert neue Versionen selbst: mit Bibliothek aus der Bibliothek, ohne von GitHub. Eine neue Version startet beim nächsten Einschalten der Box, auf Probe. Funktioniert sie nicht – startet sie nicht oder scheitert sie in den ersten Sekunden –, startet die Box nach wenigen Sekunden von selbst die Version davor. Auf Probe bleibt eine Version, bis ein Tag aufgelegt wurde und deswegen ein Album gespielt hat.

  • Ohne Bibliothek sieht die Box einmal am Tag nach einem neuen Release und installiert es nach einer Wartezeit von drei Tagen; eine Korrektur in dieser Zeit ersetzt es, bevor irgendeine Box es bekommen hat.
  • Mit Bibliothek bekommt eine Box eine neue Version sofort. Im Tab „Versionen“ der Bibliothek hat jede Version einen Zustand: use (Boxen installieren sie von selbst), manual (nur von Hand), dontuse (jede Box verlässt sie sofort).
  • Die Update-Art einer Box – „automatisch“, „nur von Hand“ („nachfragen“ ohne Bibliothek) oder „aus“ – wird auf ihrer Seite eingestellt, Tab „System“, Abschnitt „Version“ (Benutzerhandbuch, Abschnitt 13.4).

Auf der Box ist dasselbe ein Befehl. Er läuft als Benutzer der Box, nie mit sudo:

tinyjukebox-slot status           # die Versionen auf der Box, die laufende, die Update-Art, die letzten Wechsel
tinyjukebox-slot check            # was die Bibliothek anbietet - ohne Bibliothek: GitHub
tinyjukebox-slot update --now     # die neueste erlaubte Version, sofort
tinyjukebox-slot update 0.45.0    # genau diese Version
tinyjukebox-slot mode manual      # automatic, manual oder off

Jeder Aufruf: library.md, Abschnitt 6.8.

4.2 Zurück zur Version davor

Ein Schritt zurück wirkt sofort, auch wenn gerade etwas spielt. Die verlassene Version installiert danach keine Box mehr von selbst.

Weg Für
Seite der Box, Tab „System“, „Zurück zur vorigen Version“ diese Box
tinyjukebox-slot revert auf der Box diese Box
eine leere Datei tinyjukebox-revert auf der Boot-Partition der SD-Karte (bootfs am PC) diese Box, ohne Netz: Der nächste Start geht zurück und schreibt an ihre Stelle tinyjukebox-ergebnis.txt
Seite der Bibliothek, Tab „Versionen“: die Version auf dontuse alle Boxen

revert wechselt in den anderen Slot, egal was darin liegt. Nach einer gescheiterten Probe kann das die gescheiterte Version sein: vorher mit tinyjukebox-slot status nachsehen. Startet keine Version mehr, ist die Box im Notfall-Modus (Benutzerhandbuch, Abschnitt 13.4; library.md, Abschnitt 6.10).

4.3 Die Bibliothek

Die Bibliothek aktualisiert sich nie selbst.

  • Auf dem NAS: das neuere Paket genauso installieren, Paket-Zentrum, „Manuelle Installation“ – ohne Dialog; die Daten bleiben. Aus einem Klon des Repositorys auf dem PC erledigt das ./update_library.sh <nas>: Es holt das Paket des neuesten Releases und fragt nach Benutzer und Passwort von DSM, die es nicht speichert – oder nimmt NAS, Benutzer und Passwort aus dem Vault des Playbooks (library.md, Abschnitt 3.7).
  • In Docker: Die Seite zeigt, dass es eine neuere Version gibt. Das neuere Image holen und den Container neu starten; mit compose docker compose pull, dann docker compose up -d.
  • Auf einem PC: pip install --upgrade tinyjukebox, dann die Bibliothek neu starten.

Eine Bibliothek, die älter ist als die Version einer Box, hält die Box an: Die LED wechselt zwischen rot, weiß, magenta und gelb, und die Box spielt nichts. Dann zuerst die Bibliothek aktualisieren.

4.4 Das Betriebssystem der Box

Ihr Betriebssystem aktualisiert die Box nie selbst. Von Hand, ab und zu:

sudo apt update && sudo apt full-upgrade

Nach einem Upgrade von Python, ALSA oder BlueZ die Zeile des Installers noch einmal ausführen (Abschnitt 2.3) – auf einer Box des Playbooks ./update_box.sh – und Ton, Tasten und Kopfhörer prüfen. Braucht eine Version ein neueres System, sagt sie das auf der Seite der Box: Dann muss der Installer ebenfalls noch einmal laufen.