Zum Hauptinhalt springen

Updates

Updates

Achtung

Bitte immer zunächst prüfen, ob es eine entsprechende UPDATE-X.XX.md gibt, in der möglicherweise auf Inkompatibilitäten oder Hinweise zum Update veröffentlicht werden.

Datensicherung​

Bitte zunächst eine Datensicherung anfertigen.

Achtung

Um ein Backup einzuspielen, muss die entsprechende Version des Quelltextes bekannt sein. Der folgende Befehl liefert den aktuellen Git Commit-Hash, sodass dieser später wiederhergestellt werden kann:

$ git log --pretty=format:'%H' -n 1

Hintergrunddienste stoppen (optional)​

Sofern die Hintergrunddienste z.B. mittels systemd realisiert werden, sollten diese zunächst gestoppt werden:

$ systemctl --user stop sc-background.service
$ systemctl --user stop sc-mail.service

Quelltext aktualisieren​

Der Quelltext wird mittels Git aktualisiert:

$ git pull
$ git checkout -b 1.0.0

Dabei ist 1.0.0 durch die entsprechende Version zu ersetzen.

Abhängigkeiten aktualisieren​

$ composer install --no-dev --classmap-authoritative --no-scripts

CSS- und JavaScript-Dateien erstellen​

$ php bin/console assets:install
$ php bin/console importmap:install
$ php bin/console asset-map:compile

Aktualisierung der Anwendung und Datenbank​

# Cache leeren und aufwärmen
$ php bin/console cache:clear
# Datenbank migrieren
$ php bin/console doctrine:migrations:migrate --no-interaction
# Anwendung installieren (führt ggf. durch das Update neue Schritte aus - bisherige Schritte werden übersprungen)
$ php bin/console app:setup
# Cronjobs registrieren
$ php bin/console shapecode:cron:scan
Erfolg

Die Anwendung ist nun aktualisiert.

Hintergrunddienste starten (optional)​

Sofern die Hintergrunddienste z.B. mittels systemd realisiert werden, sollten diese wieder gestartet werden:

$ systemctl --user start sc-background.service
$ systemctl --user start sc-mail.service

Wiederherstellen einer vorherigen Version​

Quelltext wiederherstellen​

Zunächst die entsprechende Version wiederherstellen:

$ git checkout HASH

HASH entsprechend durch den Hash ersetzen (siehe oben).

Datenbank wiederherstellen​

Siehe Backup

Abhängigkeiten aktualisieren​

$ composer install --no-dev --classmap-authoritative --no-scripts

CSS- und JavaScript-Dateien erstellen​

$ php bin/console assets:install
$ php bin/console importmap:install
$ php bin/console asset-map:compile

Aktualisierung der Anwendung und Datenbank​

# Cache leeren und aufwärmen
$ php bin/console cache:clear
# Anwendung installieren (führt ggf. durch das Update neue Schritte aus - bisherige Schritte werden übersprungen)
$ php bin/console app:setup
# Cronjobs registrieren
$ php bin/console shapecode:cron:scan