Skip to content

Troubleshooting

If you see these kinds of errors, the problem is that the workflow engine is taking longer than expected to respond:

Terminal window
WorkflowException caused by timeout.

You can increase this timeout by modifying the OpenKM rest.client.call.timeout configuration property. By default, it is set to 15 seconds, but you can increase it to 30 or 60 seconds.

If you see errors like this on the OpenKM side:

Please verify the user and password configured in these configuration properties:

  • workflow.adapter.login
  • workflow.adapter.password

Also, take a look at openkm.log and okmflow.log files for more information.

The request was rejected because the URL was not normalized

Section titled “The request was rejected because the URL was not normalized”

The most common cause is a slash at the end of the OpenKM configuration property workflow.adapter.url. To fix it, remove the final slash.

It should be something like “http://localhost:8080/okmflow” and not “http://localhost:8080/okmflow/”.