Entfernen und Umzug

Übersicht

wsp uninstall kennt zwei Stufen. Ohne --purge-data wird die Anwendung abgeräumt und alle Daten bleiben liegen; das ist umkehrbar. Mit --purge-data verschwindet alles: Ablagen, Konfiguration, Geheimnisse und Sicherungen. Ein Umzug ist ein Entfernen auf der einen und ein Einrichten auf der anderen Seite.

Voraussetzungen

Eine aktuelle Sicherung, ausgelagert auf ein anderes Medium
Eine Kopie von /etc/wsp
Benachrichtigte Nutzer, denn die Anwendung ist sofort nicht mehr erreichbar

Schritt-für-Schritt-Anleitung

Vorher sichern und auslagern

sudo wsp backup
sudo tar czf /root/wsp-etc-$(date +%F).tar.gz -C / etc/wsp

Prüfen, wo Ihre Daten liegen

sudo wsp backup --list
sudo docker volume ls | grep wsp_

Entfernen, Daten behalten
```
sudo wsp --yes uninstall
```
- Über die Oberfläche: Entfernen, dann das Wort entfernen tippen
- Entfernt werden Stack, Netz und die eigene nginx-Datei; andere Seiten bleiben unberührt
Entfernen samt Daten
```
sudo wsp --yes uninstall --purge-data
```
- Nur über die Kommandozeile; die Oberfläche bietet diese Stufe bewusst nicht an
- Unwiederbringlich: Nur eine ausgelagerte Kopie hilft dann noch
Wieder in Betrieb nehmen
```
sudo wsp install
```
- Die Installation erkennt vorhandene Datenablagen und übernimmt sie; bestehende Geheimnisse werden nicht neu erzeugt

Umzug auf einen anderen Server

Auf dem alten Server einpacken

sudo wsp backup
sudo tar czf /root/wsp-etc.tar.gz -C / etc/wsp
sudo tar czf /root/wsp-backups.tar.gz -C /var/lib/wsp backups

Auf dem neuen Server vorbereiten: wsp beziehen, wsp doctor laufen lassen

Geheimnisse und Sicherungen einspielen, bevor Sie installieren

sudo tar xzf wsp-etc.tar.gz -C /
sudo mkdir -p /var/lib/wsp && sudo tar xzf wsp-backups.tar.gz -C /var/lib/wsp

Installieren. Die vorhandenen Geheimnisse werden übernommen, nicht neu erzeugt

Sicherung zurückspielen

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

DNS-Eintrag umstellen, prüfen, erst danach den alten Server abräumen

Was nach dem Entfernen bleibt

Ohne --purge-data: /etc/wsp/, /var/lib/wsp/state.json, /var/lib/wsp/backups/, /var/log/wsp/ und die Docker-Ablagen wsp_*. In beiden Stufen bleiben außerdem Docker samt Paketquelle, nginx samt Ihren übrigen Seiten, der Swarm-Betrieb des Servers sowie certbot und Ihre Zertifikate. Wollen Sie den Server vollständig zurückbauen, entfernen Sie diese Bestandteile mit den Mitteln Ihrer Distribution.

Häufige Fehler und Tipps

Hinweis: Ein Umzug zeigt, ob Ihre Auslagerung vollständig war.
- Planen Sie ihn mit Zeitpuffer und halten Sie den alten Server bereit, bis der neue nachweislich läuft.
Hinweis: Lässt sich das Netz nicht entfernen, hängt noch ein Container daran.
- sudo docker ps -a zeigt ihn; stoppen, entfernen, dann wsp uninstall erneut.
Hinweis: Meldet nginx nach dem Entfernen einen Fehler, verweist meist eine andere Seite auf unsere.
- sudo nginx -t zeigt die Datei, anpassen und sudo systemctl reload nginx.
Hinweis: Gibt es keinen vermerkten Zustand, räumen Sie Reste mit Docker-Bordmitteln ab.
- docker stack rm wsp.

Wie entferne ich eine Installation oder ziehe auf einen anderen Server um?