Updates

Wege zum Update

Öffnen Sie System → Updates in der Weboberfläche von Phaeton. Die Seite bietet zwei Wege zum Aktualisieren, und beide installieren nur Versionen, die von Phaeton signiert sind.

• Release repository update: Wählen Sie Check for updates, wählen Sie eine Version und dann Install selected release and restart. Phaeton nutzt seinen eingebauten öffentlichen Release-Kanal; öffentliche Versionen brauchen kein Zugriffstoken.
• Local package update: Laden Sie das .phaeton-update-Paket für die Plattform Ihres Geräts von der Download-Website von Phaeton herunter, wählen Sie Choose update package, wählen Sie die Datei aus und wählen Sie dann Upload package and restart. Nutzen Sie diesen Weg, wenn das Gerät keinen Internetzugang hat.
• Nutzen Sie ein abweichendes privates Repository nur, wenn Ihr Installateur oder Ihr Support-Kontakt Sie dazu anweist.

Phaeton-Downloads

Vor dem Update

• Sichern Sie das Datenverzeichnis; siehe Sicherung und Wiederherstellung.
• Beenden Sie das Laden. Während Phaeton neu startet, ist keine Ladesteuerung möglich.
• Lesen Sie die Versionshinweise auf der Seite Updates. Neuigkeiten enthält die Hinweise der letzten Versionen.
• Behalten Sie das Paket Ihrer aktuellen Version, bis die neue Version nach dem Neustart ihre Prüfungen bestanden hat.

Sicherung und Wiederherstellung

Update-Einstellungen

Die Update-Einstellungen finden Sie unter Settings → System → Maintenance, unter Advanced.

• Enable remote updater schaltet die automatischen Prüfungen und automatischen Updates ein oder aus. Standardmäßig ist es eingeschaltet. Check for updates auf der Seite Updates funktioniert in beiden Fällen.
• Ist Auto check remote repository eingeschaltet, sucht Phaeton im Abstand von Check interval (h) nach einer neuen Version, standardmäßig einmal am Tag. Es installiert sie nur dann selbst, wenn Auto update eingeschaltet ist; standardmäßig ist das ausgeschaltet.
• Include prereleases bietet auch Testversionen an. Lassen Sie es auf einer Installation, auf die Sie sich verlassen, ausgeschaltet.
• Repository URL bleibt für den eingebauten öffentlichen Release-Kanal leer. Tragen Sie dort nur eine private Release-Quelle auf GitHub oder GitLab ein, und füllen Sie Access token (for private repos) nur aus, wenn dieses Repository eines braucht.
• Phaeton sendet das Token nur über HTTPS an den Server dieses Repositorys, bei einem GitHub-Repository auch an die GitHub-API, nie an einen Server, auf den ein Download weiterleitet. Wenn Sie das Repository ändern, wird ein gespeichertes Token gelöscht, sofern Sie es nicht erneut eingeben.

Manuelle Updates mit einem signierten Paket

• Die Seite Updates akzeptiert nur das offizielle .phaeton-update-Paket für die Plattform Ihres Geräts. Es enthält die Version und ihre signierten Prüfsummen. Ein einfaches .tar.gz-Archiv wird abgelehnt.
• Vor der Installation prüft Phaeton die Signatur der Version, die Prüfsumme des Pakets und die Plattform. Ein Paket, das eine Prüfung nicht besteht, wird nicht installiert.
• Ein Paket, das älter ist als die installierte Version, wird erst nach einer zweiten Bestätigung installiert, die beide Versionen nennt. Bis Sie bestätigen, wird nichts installiert. Dieselbe Bestätigung erscheint bei einem Paket ohne Versionsnummer, etwa einem Vorschau-Build. Wenn Sie die installierte Version erneut installieren, ist keine zusätzliche Bestätigung nötig.

Was ein Update behält

Ein Update ersetzt das Programm und die Weboberfläche und behält alles im Datenverzeichnis:

• config.yaml mit Ihren Einstellungen und config-web.json mit der Kopie des Administratorkontos.
• state.json mit dem gespeicherten Betriebszustand.
• Die Protokolldateien phaeton.<date>.log.
• Die Lizenzdateien.

Update über das VRM Control Panel

Über den GX oder das VRM Control Panel kann die Verbindung in eine Zeitüberschreitung laufen oder den Fehler 502 Bad Gateway zeigen, während die Installation weiterläuft. Eine Zeitüberschreitung oder ein Proxy-Fehler allein bedeutet nicht, dass das Update fehlgeschlagen ist.

Phaeton wertet eine verlorene Antwort als unbestätigt. Es wartet bis zu zwei Minuten, bis die neue Version bereit ist, und lädt dann die Seite neu. Die Installationsschaltflächen bleiben während des Wartens deaktiviert, sodass keine zweite Anfrage starten kann. Nach dem Neustart müssen Sie sich eventuell erneut anmelden.

Lässt sich der Neustart nicht bestätigen, laden Sie die Seite neu und prüfen Sie die installierte Version auf der Seite Updates, bevor Sie ein weiteres Update versuchen.

Wenn ein Update fehlschlägt

• Schlägt die Installation fehl, behält Phaeton die laufende Version. Kann es die vorherige Weboberfläche nicht wiederherstellen, nennt die Fehlermeldung den Sicherungsordner, den es behalten hat, und den Ordner, der wiederhergestellt werden muss. Bewahren Sie diese Sicherung auf, bis das Problem gelöst ist; ein späteres Update überschreibt sie nicht.
• Lässt sich die neue Version nicht starten, bleibt die laufende Version aktiv und schreibt den Grund ins Protokoll. Ein angenommener Upload allein bedeutet nicht, dass der Neustart gelungen ist.
• Startet die neue Version auf einem GX nicht innerhalb von etwa drei Minuten richtig, kehrt Phaeton von selbst zur vorherigen Version zurück. Das Protokoll nennt dann das Update, das zurückgenommen wurde. Automatische Updates überspringen diese Version; Sie können sie aber weiterhin von Hand installieren.
• Meldet Phaeton, dass ein früheres Update noch geprüft wird, warten Sie einige Minuten und versuchen Sie es erneut.

Updates schlagen fehl