Zurückrollen nach einem Update

Übersicht

wsp rollback ist der schnelle Weg zurück auf den Stand vor dem letzten Update. In der Grundform kehren nur die Dienste auf die vorherige Version zurück, die Daten bleiben unberührt. Mit --restore werden zusätzlich Datenbank und Dateiablage aus der Update-Sicherung zurückgespielt.

Voraussetzungen

Der letzte Lauf war ein Update mit Sicherung
Root-Rechte
Für --restore: die Gewissheit, dass alles seit dem Update Entstandene verloren gehen darf

Schritt-für-Schritt-Anleitung

Prüfen, ob es wirklich am Update liegt

ls -lt /var/log/wsp/ | head -3
sudo docker stack services wsp

Nur die Programmversion zurücknehmen
```
sudo wsp --yes rollback
```
- Über die Oberfläche: Zurückrollen, dann das Wort zurückrollen tippen
- Die Daten bleiben erhalten, alles seit dem Update Entstandene ebenso
Wenn auch die Daten zurück müssen
```
sudo wsp --yes rollback --restore
```
- Nur nötig, wenn das Datenmodell der neuen Version mit der alten Programmversion nicht mehr zusammenpasst
- In der Regel nach Rücksprache mit dem Support

Wenn der letzte Lauf kein Update war

sudo wsp backup --list
sudo wsp --yes restore <kennung>

Den Vorgang melden
- Diagnosepaket schnüren und beim Support einreichen

Der Unterschied auf einen Blick

	`rollback`	`rollback --restore`	`restore <id>`
Programmversion	zurück	zurück	Stand der Sicherung
Datenbank	bleibt	zurück	zurück
Dateiablage	bleibt	zurück	zurück
Welcher Stand	vor dem Update	vor dem Update	beliebige Sicherung

Wenn die Abnahme rot ist

Wird ein Dienst nicht gesund oder antwortet die Anwendung nicht, rollt wsp von selbst zurück und meldet Rückgabewert 7. Der automatische Rückroll stellt die Dienste auf die vorherigen Abbilder zurück und wartet, bis sie gesund sind. Die Datenbank spielt er nicht zurück - das Datenmodell bleibt auf dem Stand der neuen Version.

In den allermeisten Fällen ist das richtig, denn Änderungen am Datenmodell sind in der Regel so gebaut, dass die vorherige Programmversion damit weiterläuft. Wenn nicht, nennt die Meldung die Kennung der Sicherung, die vor dem Update entstand.

Häufige Fehler und Tipps

Hinweis: Nicht mehrfach hin und her rollen.
- Jeder Wechsel erschwert die Ursachensuche. Nach dem ersten Rückroll gehört der Fall zum Support.
Hinweis: Der Rückroll setzt eine Update-Sicherung voraus.
- War der letzte Lauf kein Update mit Sicherung, bricht wsp ab und verweist auf wsp restore <id>.
Tipp: Die zwei jüngsten Update-Sicherungen in Ruhe lassen.
- Sie sind die Grundlage von wsp rollback. Aufräumskripte müssen sie aussparen.
Hinweis: Bei --restore ist die Anwendung während des Laufs nicht erreichbar.
- Bei der Grundform nur kurz.

Wie rolle ich nach einem missglückten Update zurück?