Troubleshooting

Timeout errors

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

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.

Too many follow-up requests error

If you see errors like this on the OpenKM side:

Too many follow-up requests: 21

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

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/".