Troubleshooting · 15.6
WebUI and HTTPS binding
The WebUI runs as Windows service iTrainTLSPilotWebService. Its log is %ProgramData%\iTrain\TLSPilot\logs\webservice-<date>.log.
| Symptom | Cause | Solution |
|---|---|---|
| Log: Web UI is disabled (webUi.enabled=false). Idle mode - no HTTP listener. | The WebUI is switched off. | Switch on the WebUI in the settings on the tab WebUI and restart the service, see chapter WebUI. |
| Log: License expired. Web UI idle until a valid license is installed., License deactivated. Web UI idle until a valid license is active. or This license does not include WebUI & RBAC. Web UI idle. | The license is expired or deactivated, or does not include WebUI and RBAC. | Install a valid license that includes WebUI and RBAC. |
| Port <port> is already in use by <process> or Port <port> could not bind. Pick another port, or finish without starting Web UI. | Another program uses the port of the WebUI. | Select another port in the settings on the tab WebUI. |
| Log: Web UI HTTPS certificate thumbprint <thumbprint> not found in LocalMachine\My or HTTPS is enabled but no usable certificate was found … Skipping HTTPS bind so HTTP can still work. | The WebUI certificate is missing in LocalMachine\My. | Deploy the WebUI certificate again (deployments This host - LocalMachine\My and TLSPilot Web UI HTTPS), see chapter WebUI certificate. |
| Web UI HTTPS bind did not take. Listener thumbprint is <thumbprint>, expected <thumbprint> | The WebUI uses the previous certificate. | Deploy the deployment TLSPilot Web UI HTTPS again. |
| Log: Web TLS certificate changed to thumbprint <thumbprint> … Restart the WebService Windows service to load the new HTTPS certificate into Kestrel. | A new WebUI certificate was bound. | Restart the WebUI service in the Desktop Admin console with Service, Restart Web UI service…, or in services.msc (iTrainTLSPilotWebService). |
| WebService process is <state> but nothing accepts connections on 127.0.0.1:<port> or … /healthz did not respond. The process may still be starting or stuck in idle mode. | The service runs but does not accept connections. | Check the log webservice-*.log and Event Viewer → Application. |
| Log: No valid HTTP/HTTPS listener configured - falling back to http://0.0.0.0:8080 | Neither HTTP nor HTTPS is configured correctly. | Check the listener settings on the tab WebUI. |