Genereller Ablauf von Upgrades
vorsicht
Die Upgrade-Notizen zu den jeweiligen Versionen enthalten nur die Änderungen seit der letzten vorhergehenden Version!
Vorbereitung
- Aktuell installierte Version notieren (Ausgabe des laufenden Servers beim Start bzw.
package.json/Release-Archivname). - Alle Upgrade-Notizen (unterhalb dieses Menüpunkts) prüfen, die seit der notierten Version veröffentlicht wurden, und daraus eine Aufgabenliste erstellen — insbesondere Änderungen an der Config-Struktur (
sapConnection,databaseConnection,operations). - Voraussetzungen der Zielversion prüfen.
tipp
Nicht jede Version hat eine dedizierte Upgrade-Notiz. In diesem Fall sind keine weiteren Schritte über die allgemeine Anleitung hier hinaus nötig.
Allgemeines theoretisches Beispiel
- Aktuell installierte Version ist 1.0.0
- Aktuellste verfügbare Version ist 1.0.3
- Es gibt keine Upgrade-Notizen für 1.0.1, 1.0.2 und 1.0.3
- Daher sind bei einem Upgrade von 1.0.0 auf 1.0.3 nur die allgemeinen Schritte aus dieser Anleitung zu beachten
Durchführung
- Server/Dienst stoppen.
- Neues Release-Archiv herunterladen und alle Dateien mit Ausnahme der
.env-Datei durch die neue Version ersetzen. - Config-Datei(en) gemäß der geprüften Upgrade-Notizen anpassen, falls sich das Schema geändert hat.
- Server/Dienst neu starten und die Logs auf Fehler beim Start prüfen.