Fehlerbehebung · 15.6
Fehlerbehebung: WebUI und HTTPS-Bindung
Die WebUI läuft als Windows-Dienst iTrainTLSPilotWebService. Ihr Log ist %ProgramData%\iTrain\TLSPilot\logs\webservice-<date>.log.
| Symptom | Ursache | Lösung |
|---|---|---|
| Log: Web UI is disabled (webUi.enabled=false). Idle mode - no HTTP listener. | Die WebUI ist ausgeschaltet. | Schalten Sie die WebUI in den Einstellungen auf dem Tab WebUI ein und starten Sie den Dienst neu, siehe Kapitel WebUI. |
| Log: License expired. Web UI idle until a valid license is installed., License deactivated. Web UI idle until a valid license is active. oder This license does not include WebUI & RBAC. Web UI idle. | Die Lizenz ist abgelaufen oder deaktiviert oder enthält WebUI und RBAC nicht. | Installieren Sie eine gültige Lizenz, die WebUI und RBAC enthält. |
| Port <port> is already in use by <process> oder Port <port> could not bind. Pick another port, or finish without starting Web UI. | Ein anderes Programm verwendet den Port der WebUI. | Wählen Sie in den Einstellungen auf dem Tab WebUI einen anderen Port. |
| Log: Web UI HTTPS certificate thumbprint <thumbprint> not found in LocalMachine\My oder HTTPS is enabled but no usable certificate was found … Skipping HTTPS bind so HTTP can still work. | Das WebUI-Zertifikat fehlt in LocalMachine\My. | Verteilen Sie das WebUI-Zertifikat erneut (Deployments This host - LocalMachine\My und TLSPilot Web UI HTTPS), siehe Kapitel WebUI-Zertifikat. |
| Web UI HTTPS bind did not take. Listener thumbprint is <thumbprint>, expected <thumbprint> | Die WebUI verwendet das bisherige Zertifikat. | Verteilen Sie das Deployment TLSPilot Web UI HTTPS erneut. |
| Log: Web TLS certificate changed to thumbprint <thumbprint> … Restart the WebService Windows service to load the new HTTPS certificate into Kestrel. | Ein neues WebUI-Zertifikat wurde gebunden. | Starten Sie den WebUI-Dienst in der Desktop Admin Console mit Service, Restart Web UI service… oder in services.msc (iTrainTLSPilotWebService) neu. |
| WebService process is <state> but nothing accepts connections on 127.0.0.1:<port> oder … /healthz did not respond. The process may still be starting or stuck in idle mode. | Der Dienst läuft, nimmt aber keine Verbindungen an. | Prüfen Sie das Log webservice-*.log und Ereignisanzeige → Application. |
| Log: No valid HTTP/HTTPS listener configured - falling back to http://0.0.0.0:8080 | Weder HTTP noch HTTPS ist korrekt konfiguriert. | Prüfen Sie die Listener-Einstellungen auf dem Tab WebUI. |