Troubleshooting

Registry nicht lesbar

Symptom: Schritt 1 zeigt leere Felder, obwohl JTL-Wawi installiert ist.

Ursache: Der Win32-Registry-Zugriff (winreg-Crate) braucht User-Rechte. In seltenen Fällen blockt Anti-Virus den Zugriff.

Lösung:

1. Felder manuell ausfüllen
2. JTL-Wawi-Registry-Pfad prüfen: regedit → HKEY_CURRENT_USER\Software\JTL\WAWI\Database
3. Werte übernehmen

Verbindung schlägt fehl mit „Login failed“

Symptom: test_connection gibt Login failed for user 'sa'. zurück.

Ursache: Falscher SQL-Auth-Modus oder falsches Passwort.

Lösung:

1. In SSMS prüfen, ob die Windows-Authentifizierung funktioniert
2. Wenn ja: Im Wizard auf Windows-Authentifizierung umstellen
3. Wenn nein: SQL-Server-Auth aktivieren, Passwort vom JTL-Admin holen

Verbindung schlägt fehl mit „Cannot connect to server“

Symptom: Timeout oder A network-related or instance-specific error occurred.

Ursache: SQL-Server läuft nicht, Firewall blockt, oder falscher Server-Name.

Lösung:

# 1. SQL-Server-Status prüfen
services.msc → SQL Server (JTLWAWI) → Status: Running?

# 2. TCP/IP aktiviert?
sqlservermanager.msc → SQL-Server-Network-Configuration → TCP/IP → Enabled

# 3. Firewall?
netsh advfirewall firewall add rule name="SQL Server JTL" ^
  dir=in action=allow protocol=TCP localport=1433

Sidecar startet nicht

Symptom: Tauri öffnet sich, aber Workspace bleibt leer. In Logs: Failed to start sidecar.

Diagnose:

# Sidecar manuell starten
"%APPDATA%sellx-hubsellx-sidecarSellxSidecar.exe"

# Sollte Konsole öffnen mit:
# "Now listening on: http://localhost:54321"

Häufigste Ursache: Fehlende DLLs. Sidecar-Ordner muss enthalten:

SellxSidecar.exe
e_sqlite3.dll
Microsoft.Data.SqlClient.SNI.dll
msalruntime.dll
WebView2Loader.dll

Sidecar startet mit Konsolen-Fenster

Symptom: Beim Hub-Start öffnet sich kurz ein leeres CMD-Fenster.

Ursache: <OutputType>Exe</OutputType> statt <OutputType>WinExe</OutputType> in SellxSidecar.csproj.

Lösung:

<PropertyGroup>
  <OutputType>WinExe</OutputType>
  <TargetFramework>net8.0</TargetFramework>
  <RuntimeIdentifier>win-x64</RuntimeIdentifier>
</PropertyGroup>

Dann dotnet publish erneut ausführen.

Port bereits belegt

Symptom: Sidecar-Log: Address already in use.

Ursache: Mehrere Hub-Instanzen gleichzeitig laufen, oder Sidecar-Prozess hängt.

Lösung:

# Alle SellxSidecar-Prozesse beenden
taskkill /F /IM SellxSidecar.exe

# Alle Hub-Instanzen schließen
taskkill /F /IM sellx-hub.exe

SQL_SECURITY_VIOLATION

Symptom: Plugin-Ausführung scheitert mit SQL_SECURITY_VIOLATION.

Diagnose: SqlSecurityValidator hat etwas gefunden. Log-Eintrag enthält das verbotene Pattern.

Häufigste Ursachen:

PARSE_ERROR bei Installation

Symptom: .sellxpkg lässt sich nicht installieren: PARSE_ERROR.

Diagnose: ZIP korrupt oder manifest.json fehlt.

Lösung:

# Inhalt prüfen
unzip -l mein-plugin.sellxpkg

# Manifest lesen
unzip -p mein-plugin.sellxpkg manifest.json | jq .

Falls manifest.json fehlt: ZIP falsch erstellt. Keine führende Verzeichnis-Ebene!

LICENSE_INACTIVE

Symptom: Plugin startet, scheitert aber mit LICENSE_INACTIVE.

Ursache:

• Subscription abgelaufen
• Heartbeat > 7 Tage her (Grace-Period gestartet)
• Token-Version in Central erhöht → lokales JWT ungültig

Lösung:

1. Internet-Verbindung prüfen → Heartbeat triggern
2. In Central prüfen, ob Subscription aktiv ist
3. Falls Token-Version erhöht: Hub neu aktivieren über Setup-Wizard

Plain white window

Symptom: Hub-Fenster öffnet sich, bleibt aber weiß.

Diagnose:

1. DevTools öffnen (in main.rs aktiviert: win.open_devtools())
2. Console-Tab prüfen — typischer Fehler:
   • Cannot find module '@tauri-apps/api'
   • Uncaught (in promise) Error: Failed to invoke ...
   • Error: ENOENT: no such file or directory

Häufigste Ursachen:

DevTools automatisch öffnen

Datei: sellx-hub/src-tauri/src/main.rs, setup-Hook:

.setup(|app| {
    if let Some(win) = app.get_webview_window("main") {
        win.open_devtools();
    }
    // …
})

Vor Release: Mit #[cfg(debug_assertions)] verstecken.