On-Premises-Installer (wsp)

Diese Übersicht fasst zusammen, was `wsp` kennt: Kommandos, globale Schalter, Dateien und Verzeichnisse, Ports, ausgehende Ziele, Dienste im Stack und die Rückgabewerte. Hilfe zu einem einzelnen Kommando gibt `wsp <kommando> --help`.

Es gibt keine Telemetrie: Ihre Instanz meldet nichts an uns. Das Diagnosepaket ist der einzige Weg, auf dem der Support den Zustand Ihres Servers sehen kann - und Sie schnüren und verschicken es selbst. Vor dem Schreiben listet `wsp` auf, was hineinkommt.

Bei einer Störung führt eine feste Reihenfolge am schnellsten zur Ursache: Zustand ansehen, Server prüfen, Dienste ansehen, letztes Protokoll lesen, Diagnosepaket schnüren. Die häufigsten Fehlerbilder lassen sich damit in wenigen Minuten eingrenzen.

`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.

Nach der Installation bleiben drei Dinge, die Aufmerksamkeit brauchen: das TLS-Zertifikat, der Plattenplatz und die Protokolle. `wsp` räumt nach jedem erfolgreichen Update nicht mehr benötigte Container-Abbilder ab; was wächst, sind Sicherungen und Dateiablage.

Bei einer eigenbetriebenen Instanz ist die Kommandozeile der einzige Weg, einen Mandanten zu löschen - die Anwendung bietet das dort nicht mehr an. Wer löschen darf, ist damit dieselbe Person, die Zugang zum Server hat.

`wsp` erzeugt und verwaltet die Passwörter und Schlüssel Ihrer Instanz selbst. Sie werden nie angezeigt und nie protokolliert. `wsp rotate` listet auf, welche Werte sich erneuern lassen und welche Dienste dabei neu starten - und erneuert sie auf Zuruf im laufenden Betrieb.

`/etc/wsp/env` ist die einzige Datei, die Sie selbst bearbeiten. Sie enthält Einstellungen, aber keine Passwörter und Schlüssel - die liegen je Wert in einer eigenen Datei unter `/etc/wsp/secrets/`. Wichtig ist der Zeitpunkt: Eine Änderung wird nicht sofort wirksam, sondern erst beim nächsten Lauf, der die Dienste neu ausrollt.

Läuft auf Ihrem Server bereits eine WORKSPACE.PM-2.x-Installation, die nicht mit `wsp` eingerichtet wurde, stellt `wsp adopt` sie unter dessen Verwaltung. Danach stehen Update, Sicherung, Wiederherstellung und alle übrigen Kommandos zur Verfügung. Kein Dienst wird dabei angefasst: Die Übernahme ist reine Buchhaltung, Ihre Anwendung läuft ohne Unterbrechung weiter.

Der Import macht aus einem Mandanten Ihrer alten 1.x-Installation einen neuen Mandanten Ihrer laufenden 2.x-Instanz. Übernommen werden Projekte, Aufgaben, Kosten, Risiken, Nutzer samt Passwörtern sowie Anhänge, Avatare und Projektbilder. Das Altsystem wird dabei nicht gestartet - gelesen wird ein kalter Abzug.

`/var/lib/wsp/backups/` liegt auf demselben Server wie die Anwendung. Gegen Bedienfehler und misslungene Updates hilft das, gegen einen Plattenausfall oder den Verlust des Servers nicht. Eine Kopie auf ein getrenntes Medium und eine tägliche Sicherung per Cronjob schließen diese Lücke.

`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.

Eine Sicherung ist ein benannter Wiederherstellungspunkt aus Datenbank, Dateiablage, einer Kopie von `/etc/wsp/env` und der Angabe, welche Programmversion zu diesen Daten gehört. Die Versionsangabe ist der Grund, warum eine Wiederherstellung funktioniert: `wsp` rollt den passenden Programmstand mit aus.

Ein Update ist kein Austausch von Dateien, sondern ein Ablauf mit Sicherung und Abnahme. Drei Zusagen gelten: Ohne erfolgreiche Sicherung beginnt nichts. Im Regelfall läuft das Update ohne Ausfall, weil Swarm erst den neuen Dienst startet und den alten danach stoppt. Und ist die Abnahme rot, rollt `wsp` selbsttätig auf die vorherige Version zurück.

Die Installation führt von einem frisch aufgesetzten Server bis zur ersten Anmeldung. Rechnen Sie mit 20 bis 40 Minuten, überwiegend Wartezeit beim Herunterladen der Abbilder. Vor der ersten Veränderung sehen Sie die vollständige Liste dessen, was auf dem Server verändert würde - erst Ihre Bestätigung startet den Lauf.

Zwei Kommandos prüfen einen Server, ohne ihn zu verändern: `wsp doctor` prüft die Voraussetzungen, `wsp install --dry-run` spielt die vollständige Installation durch, ohne einen einzigen Befehl auszuführen. Beide laufen auch auf einem Server, auf dem noch nichts installiert ist.

`wsp` ist ein einzelnes Programm, das WORKSPACE.PM auf einem Linux-Server einrichtet und über seine gesamte Lebenszeit betreut: installieren, aktualisieren, sichern, wiederherstellen, zurückrollen, übernehmen, warten und entfernen. Es hat keine Abhängigkeiten - eine Datei, ausführbar machen, starten.