System-Update in den Einstellungen
Überblick
Diese Seite tut zwei Dinge, die man auseinanderhalten sollte: Sie prüft, ob eine neue Version vorliegt, und sie führt die Update-Routine aus. Beides ist unabhängig voneinander nutzbar.
Die Update-Routine umfasst Datenbank-Migrationen, den Abgleich von Berechtigungen und Standard-Daten, den Cache-Neuaufbau und den Neubau der Oberfläche. Sie ist auch dann sinnvoll, wenn der Code auf anderem Weg aktualisiert wurde — etwa per Deployment.
Kernaufgaben
Version prüfen. Jetzt prüfen fragt den Update-Feed ab. Ist keiner eingerichtet, sagt die Seite das ausdrücklich — die Update-Schritte lassen sich trotzdem ausführen.
Verfügbares Update beurteilen. Zum Update werden Version, Veröffentlichungsdatum, die Mindest-PHP-Version und die Release-Notes angezeigt. Vier Gründe können ein Update verhindern, und die Seite benennt sie:
| Hinweis | Bedeutung |
|---|---|
| PHP-Version nicht ausreichend | der Server muss zuerst gehoben werden |
| Zwischenversion nötig | erst auf eine ältere Version aktualisieren, dann weiter |
| Plan berechtigt nicht | die Lizenz deckt dieses Update nicht ab |
| Es läuft bereits ein Lauf | abwarten |
Update ausführen. Update ausführen startet die Routine nach einer Rückfrage. Die Datenbanksicherung ist optional und empfohlen — sie legt vor dem Update einen Dump ab. Während des Laufs kann die Anwendung kurzzeitig eingeschränkt reagieren; beim Code-Austausch geht sie in den Wartungsmodus.
Den Lauf verfolgen. Der Status durchläuft Wartet, Läuft, Erfolgreich oder Fehlgeschlagen, und die letzten Ausgabezeilen sind einsehbar. Nach Erfolg sollten Sie die Oberfläche neu laden — sie kann sich geändert haben.
Hinweise der Schritte lesen. Warnt ein Schritt — etwa die Prüfung der Plugin-Einrichtung mit einem Hinweis zu Sendcloud —, steht seine Ausgabe unter Hinweise der Schritte, und zwar für jeden warnenden Schritt, auch wenn danach noch weitere Schritte warnen und auch nach einem erfolgreichen Lauf.
Felder im Detail
| Angabe | Woher | Was sie bedeutet |
|---|---|---|
| Aktuelle Version | Installation | Was gerade läuft. |
| Verfügbare Version | Update-Quelle | Was es gibt, mit den Änderungen dazu. |
| Änderungen | Changelog der neuen Fassung | Was sich ändert. Vor dem Einspielen lesen — hier steht, ob etwas Bestehendes anders funktioniert. |
| Handlung | Was sie bewirkt |
|---|---|
| Prüfen | Fragt die Update-Quelle ab. Ändert nichts. |
| Einspielen | Holt die neue Fassung, sichert den bisherigen Stand und wechselt. Datenbank-Anpassungen laufen mit; währenddessen ist das System kurz nicht erreichbar. |
| Zurückrollen | Stellt den vorherigen Stand wieder her. Zeitlich begrenzt und nicht in jedem Fall möglich: Was eine Datenbank-Anpassung geändert hat, lässt sich nicht in jedem Fall zurücknehmen. |
Vor jedem Einspielen gehört eine Sicherung dazu. Das Update legt zwar einen Rückweg an, aber ein Rückweg ist keine Sicherung: Er bringt den Programmstand zurück, nicht zwingend die Daten.
Ihre Anpassungen überleben ein Update: geänderte Hilfe-Seiten, Mailvorlagen, Rollen und Einstellungen bleiben, weil der Abgleich nur nachzieht, was unverändert ist.
Einstellungen & Rechte
- Recht
platform.system.update. Ohne dieses Recht ist die Seite nicht erreichbar. - Die Update-Schritte sind wiederholbar. Schlägt ein Lauf fehl, kann er nach Behebung der Ursache
gefahrlos erneut gestartet werden — ein zweiter Lauf richtet keinen zusätzlichen Schaden an.
- Ohne Update-Feed keine Versionsprüfung, wohl aber die Routine.
- Der Update-Kanal bestimmt, welche Versionen angeboten werden.
FAQ & Fehlerbilder
Es wird kein Update gefunden, obwohl eines veröffentlicht ist. Prüfen Sie, ob ein Update-Feed eingerichtet ist und welcher Kanal eingestellt ist.
Der Lauf ist fehlgeschlagen. Lesen Sie die Ausgabe — sie nennt den Schritt. Nach Behebung erneut starten; die Schritte sind wiederholbar.
Die Oberfläche sieht nach dem Update kaputt aus. Laden Sie sie neu. Der Neubau der Oberfläche ist Teil des Laufs, aber Ihr Browser hält den alten Stand.
Sollen wir vorher sichern? Ja. Die Sicherung ist optional, weil manche Häuser eigene Sicherungswege fahren — nicht, weil sie verzichtbar wäre.