System-Update im Betrieb
Überblick
Ein Update tauscht den Code und fährt danach eine feste Schrittfolge. Sie ist bei jedem Weg dieselbe — ob das Update über die Konsole, über die Oberfläche oder über einen Deploy-Lauf angestoßen wird. Ein Update ist damit kein Sonderfall, sondern immer derselbe Vorgang.
Vor den Schritten wird die Datenbank gesichert. Fehlt das Sicherungswerkzeug auf dem Server, gibt es eine Warnung statt eines Abbruchs — ein Update, das an einem fehlenden Hilfsprogramm scheitert, hilft niemandem.
Die Schritte
- Anwendungscache leeren
- Migrationen fahren
- Rechte und Rollen synchronisieren
- Standard-Daten nachziehen (bestehende Anpassungen bleiben erhalten)
- Plugin-Eigentum nachtragen
- Oberfläche neu bauen, falls nötig
- Cache vorwärmen
- Werkzeug-Katalog für den KI-Zugang neu erzeugen
- Hintergrund-Prozesse beenden, damit sie mit dem neuen Code neu starten
Alle Schritte sind idempotent. Die Wiederherstellung nach einem Fehlschlag ist deshalb: erneut ausführen.
Vorher prüfen
Ein Prüflauf sagt, ob überhaupt ein Update vorliegt, ohne etwas zu ändern. Er eignet sich für einen Zeitplan: ein Rückgabewert je Lage — aktuell, Update verfügbar, Fehler.
Was ein Update nicht anfasst
- Ihre Anpassungen an Standard-Daten. Was in dieser Instanz geändert wurde, bleibt.
- Ihre Hilfe-Texte. Überschriebene Hilfe-Seiten überleben jedes Update; die Rückkehr zum
Auslieferungsstand ist ein bewusster Schritt.
- Ihre Belege. Festgeschriebene Belege sind unveränderlich, auch über Versionen hinweg.
Häufige Fehlerbilder
Das Update bricht bei den Migrationen ab. Prüfen Sie die Meldung und den Datenbank-Nutzer; nach der Behebung erneut ausführen.
Nach dem Update laufen alte Hintergrund-Prozesse weiter. Sie werden am Ende des Updates beendet und starten von selbst neu. Bleibt etwas hängen, hilft ein Neustart des Dienstes.
Die Oberfläche zeigt alte Inhalte. Ein Neuladen ohne Zwischenspeicher genügt in der Regel.