KB-2009 Data server fails to start due to invalid license
Symptoms
When attempting to start data server in Appian versions 18.1 or later, the data server fails to start with the following error observed in the watchdog.log:
{"level":"ERROR","time":"YYYY-MM-DDTHH:MM:SS.mmmZ","logger":"watchdog","caller":"Watchdog.java:652","thread":"ForkJoinPool.commonPool-worker-2","msg":"Failed to start RTS-0 engine (port=port)"}
com.appian.data.server.UnrecoverableError: Could not establish WebSocket connection with hostname:port. The target q process exited abnormally. Check for earlier errors (e.g. license or startup errors).
Additionally, the rts-engine.log reports:
'YYYY.MM.DDTHH:MM:SS.mmm host
Cause
The output from the rts-engine.log is seen when the license issued does not match the hostname of the server it is deployed on.
Action
The data server requires a valid k4.lic license file. Generate the q output and compare the hostname from the output to the hostname of the server for which license was requested. If the hostnames do not match, request and install a new license.
Affected Versions
This article applies to Appian 18.1 and later.
Last Reviewed: October 2019
