uVersion
Deutsch
Herunterladen →

Wiki

Unter Windows installieren

PowerShell-Einzeiler: Aktivierungscode, PostgreSQL über winget, Windows-Dienst, Firewall.

Windows 10, 11 oder Windows Server 2019+ (x64). Installation mit einer PowerShell-Zeile.

Installieren

  1. PowerShell als Administrator öffnen

    Rechtsklick auf das PowerShell-Symbol → Als Administrator ausführen.

  2. Befehl einfügen

    iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex

    Das Skript:

    • fragt nach Ihrem Aktivierungscode (UV-XXXX-XXXX-XXXX)
    • lädt die Binärdatei herunter und prüft das Archiv
    • installiert PostgreSQL über winget, falls nicht vorhanden (~2 Min. bei einer frischen Installation)
    • erstellt die Datenbank, die Rolle und den Windows-Dienst und öffnet die Firewall (8443 + 8080 Fallback)
    • registriert den Eintrag unter Programme und Features
    • startet den Dienst, erzeugt das selbstsignierte TLS-Zertifikat und zeigt das Admin-Passwort UND den SHA-256-Fingerabdruck des Zertifikats an

    Alles läuft in Ihrem PowerShell-Fenster ab, Sie sehen jeden Schritt. Es ist das Windows-Äquivalent zu Linux' sudo apt install.

  3. Notieren Sie das Passwort, das am Ende der Installation angezeigt wird (oder holen Sie es über Get-Content "C:\ProgramData\uVersion\initial-admin-password").

Die am Ende der Installation ausgegebene Übersicht: Admin-Benutzername, temporäres Passwort und Serveradresse.

Anschließend können Sie Erste Anmeldung folgen.

Nicht-interaktive Variante (CI, skriptgesteuerte Bereitstellung)

& ([scriptblock]::Create((iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing).Content)) `
    -LicenceKey "UV-XXXX-XXXX-XXXX"

Alle verfügbaren Parameter: -LicenceKey, -InstallDir, -DataDir, -Port, -BindAddress, -DownloadUrl, -Reconfigure.

Installation überprüfen

Get-Service uVersionServer                                          # Status: Running
Get-NetTCPConnection -LocalPort 8443 -State Listen                  # HTTPS auto-signe
Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"        # empreinte TLS
Get-EventLog -LogName Application -Source uVersionServer -Newest 20 # logs recents

Deinstallieren

Achtung: Die folgenden Befehle löschen Ihre Repositories, den Verlauf, Benutzerkonten und Konfigurationen. Erstellen Sie ein PostgreSQL-Backup und kopieren Sie C:\ProgramData\uVersion\, wenn Sie wiederherstellen können möchten.

Zwei gleichwertige Wege. Beide führen dasselbe Skript (uninstall.ps1) aus, das den Dienst, die Firewall, die Maschinen-Umgebungsvariable, das Datenverzeichnis, die Binärdatei, den Eintrag unter Programme und Features sowie die PostgreSQL-Datenbank verwaltet.

1. Über Programme und Features

  1. Win+R → appwiz.cpl → Enter
  2. Suchen Sie uVersion Server in der Liste
  3. Rechtsklick → Deinstallieren
  4. Ein Administrator-PowerShell-Fenster öffnet sich und führt das Skript sichtbar aus

2. Über PowerShell als Administrator

iwr https://uversion.io/downloads/server/uninstall.ps1 -UseBasicParsing | iex

Das Skript zeigt am Ende einen Prüfblock: Für den Dienst, das Installationsverzeichnis, das Datenverzeichnis und den Eintrag unter Programme und Features sollten Sie grün "OK absent" sehen.

PostgreSQL ebenfalls deinstallieren?

Standardmäßig rührt uninstall.ps1 PostgreSQL nicht an (möglicherweise nutzen andere Anwendungen es). Um es ebenfalls zu entfernen:

$body = (iwr "https://uversion.io/downloads/server/uninstall.ps1" -UseBasicParsing).Content
if ($body -is [byte[]]) { $body = [Text.Encoding]::UTF8.GetString($body) }
& ([scriptblock]::Create($body)) -RemovePostgreSQL

Die [byte[]]-Prüfung ist notwendig: Je nach ausgeliefertem Content-Type kann Invoke-WebRequest -UseBasicParsing den Body als Byte-Array oder als String zurückgeben. Das obige Muster funktioniert in beiden Fällen.

Achtung: -RemovePostgreSQL entfernt jede PostgreSQL-Installation auf der Maschine, nicht nur die uVersion-Datenbank. Verwenden Sie es nur, wenn Sie sicher sind, dass nichts anderes diesen Cluster nutzt.