WORKSPACE.PM
Zurück zur Wissensdatenbank

Wie prüfe ich vorab, ob mein Server für WORKSPACE.PM geeignet ist?

3 Min. Lesezeit
Aktualisiert: 23.8.2026

Vorprüfung und Probelauf

Übersicht

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.

Voraussetzungen

  • Das Programm wsp liegt auf dem Server und ist ausführbar
  • Root-Rechte
  • Für die Namensprüfung: der geplante DNS-Eintrag ist bereits gesetzt

Schritt-für-Schritt-Anleitung

  1. Vorprüfung starten

    sudo wsp doctor --origin https://pm.beispiel.de
    • Ohne --origin entfällt nur die Namensprüfung, alles andere läuft

  2. Die Ergebnisse lesen

    • ✓ bestanden
    • ! Hinweis, die Installation läuft trotzdem
    • ✗ Befund, die Installation bricht ab, bevor sie etwas verändert
    • Jeder Befund nennt die Abhilfe; arbeiten Sie sie ab und starten Sie doctor erneut

  3. Wissen, was geprüft wird

    • Betriebssystem, Architektur, Kerne, Arbeitsspeicher, Auslagerungsdatei, Plattenplatz
    • Ports 80 und 443, Namensauflösung, Systemzeit, Lizenzprüfung
    • Erreichbarkeit von Helpdesk, Registry und Docker Hub

  4. Probelauf durchspielen

    sudo wsp install --dry-run
    • Im Menü heißt derselbe Weg Probelauf
    • Sie sehen die Vorprüfung, eine Zusammenfassung dessen, was eingerichtet würde, und jeden Ablaufschritt mit den Befehlen, die er ausführen würde

  5. Offene Punkte selbst nachmessen

    dig +short pm.beispiel.de
sudo ss -lptn 'sport = :80 or sport = :443'
timedatectl

Häufige Fehler und Tipps

  • Hinweis: Ein laufender nginx ist kein Hindernis.
    • Belegte Ports 80 und 443 blockieren nur dann, wenn ein anderer Dienst als nginx sie hält. wsp legt seine Seite als eigene Datei daneben.
  • Hinweis: In der Ausgabe heißt die Registry aus technischen Gründen "Harbor".
    • Das ist derselbe Dienst wie registry.workspace.pm.
  • Tipp: Auslagerungsdatei anlegen, auch wenn nur ein Hinweis erscheint.
    • Während eines Updates läuft ein Dienst kurz doppelt. Mit 4 GiB Arbeitsspeicher und ohne Swap kann das eng werden; 4 GiB Swap decken die Spitze ab.
  • Tipp: Der Probelauf läuft auch auf einem Server, der die Vorprüfung nicht besteht.
    • Dann steht der Hinweis dabei, dass der echte Lauf an dieser Stelle abbräche. Nutzen Sie ihn, um Ihre Angaben zu kontrollieren, bevor etwas passiert.
  • Hinweis: Rückgabewert 0, wenn nichts blockiert, sonst 2.
    • Damit lässt sich doctor in eine Überwachung einhängen.

Weiterführende Informationen