Update-System
Das CMS hat ein eingebautes Update-System, mit dem Sie eine neue Version einspielen, ohne Dateien manuell zu kopieren. Der Update-Lauf prüft die aktuelle Version, lädt das passende Update vom Update-Server, legt vorher ein Backup an und führt die nötigen Migrationen aus.
Voraussetzung
Updates installieren darf, wer zur Gruppe Administratoren gehört oder das Häkchen Darf Updates installieren hat — siehe Benutzergruppen & Spezialrechte. Alle anderen sehen das Dashboard mit dem Hinweis «nur Lesezugriff» und können nichts ausführen.
Aufruf
Unter Busapp Einstellungen → Wartung → Update-Dashboard. Sie sehen oben einen Hinweis, ob eine neue Version verfügbar ist, dazu CMS-Version, Update-Server, API-Token und Berechtigung. Darunter folgen die Reiter:
- Allgemein — Einstellungen zu Update und Backup.
- Meine Installationen — die erkannten Instanzen.
- Versionen und Migrationen — der installierte Stand.
- Historie — Protokoll der letzten Aktionen.
- Backups — die vorhandenen Backups.
Updates prüfen
Klick auf Nach Updates suchen. Das CMS fragt beim Update-Server an, welche Versionen bereitstehen. Die Tabelle zeigt je Version:
- Version (z.B. 3.7.64) und Channel.
- Ab Vorversion — liegt Ihre Version darunter, steht statt des Knopfs «Erst vX installieren»: Spielen Sie zuerst die Zwischenversion ein.
- Assets und Promoted (Datum).
- Changelog anzeigen — was ist neu.
Update einspielen
- Klick auf Jetzt installieren ... bei der gewünschten Version.
- Das CMS:
- legt ein Backup der aktuellen Dateien und Datenbank an;
- lädt die neuen Dateien herunter und ersetzt die alten;
- führt die zugehörigen Migrationen aus;
- aktualisiert die Versionsangabe;
- meldet das Resultat zurück an den Update-Server (für Monitoring).
- Im Ergebnis und im Reiter Historie sehen Sie die einzelnen Schritte mit Erfolg/Fehler.
Backups
Pro Update-Lauf legt das CMS ein Backup an. Die Liste finden Sie im Reiter Backups mit den Spalten Zeitpunkt, Backup-ID, DB-Größe, Dateien-Größe, Notizen und Aktion.
Standardmässig bleiben die letzten 3 Backups erhalten, ältere werden gelöscht. Hochgeladene Bilder und Downloads sind nicht Teil des Backups, weil ein Update sie nicht verändert. Unter Wartung lassen sich Datei-Backup vor Update aktiv und DB-Dump vor Update aktiv abschalten; das schliesst den entsprechenden Rollback aus.
Rollback
Wenn ein Update Probleme verursacht hat, können Sie auf einen früheren Stand zurückrollen:
- Im Reiter Backups das gewünschte Ziel-Backup wählen.
- Auf Rollback ... klicken und die Warnung bestätigen.
- Das CMS extrahiert das Backup, ersetzt die aktuellen Dateien und stellt die Datenbank zurück.
Rollback ist eine ernste Aktion — alle Inhaltsänderungen seit dem Backup gehen verloren. Vorher unbedingt mit der Administration absprechen.
Ältere Version installieren
Bei älteren Versionen steht der Knopf ⚠ Downgrade .... Er nimmt Datenbank-Migrationen nicht zurück; der reguläre Rückweg ist ein Rollback im Reiter Backups.
Installation manuell melden
Wenn auf dem Server mehrere CMS-Installationen liegen (z.B. Hauptauftritt + Mikrosite), sollten sie alle vom Update-System erfasst werden. Mit Lokalen Scan neu laufen lassen sucht das CMS erneut danach. Eine nicht erkannte Installation melden Sie über Installation manuell melden ...: Typ wählen (CMS-Backend oder CMS-Frontend (Ausgabe)), absoluten Pfad eintragen und An Anbieter senden. Der Eintrag wird vom Anbieter bestätigt oder korrigiert.
Häufige Fragen
Wie oft sollte ich Updates einspielen?
Sicherheits-Updates zeitnah (innerhalb von Tagen). Feature-Updates können nach Bedarf eingespielt werden — keine Eile.
Was passiert mit meinen Inhalten?
Inhalte und Konfiguration bleiben erhalten. Migrationen passen das Datenbank-Schema an die neue Code-Basis an, ohne Inhalt zu verlieren.
Kann ich ein Update einspielen während die Site online ist?
Ja, der Update-Lauf dauert je nach Umfang Sekunden bis wenige Minuten. In dieser Zeit kann es zu kurzen Ausfällen kommen — Lucee-Anwendung muss intern neu initialisiert werden.
Update schlug fehl — was tun?
Im Reiter Historie die Fehlermeldung lesen. Häufig: Datei-Berechtigungen, fehlender Master-Key, Migrations-Konflikt. Falls nicht sofort klärbar: Rollback zum letzten Backup.
Zurück zu: Busapp Einstellungen
