Troubleshooting

After following the installation guide we hope that everything works just fine. If you do experience some issues, we have written some troubleshooting guides to help you solve the issue.

InvalidOptionsException from the Changelog summarization service

Symptoms:

Logs: 

Application startup exception: FontoXml.Apps.DocumentHistory.Options.InvalidOptionsException: The options CompareOptions are invalid. 

Application startup exception: FontoXml.Apps.DocumentHistory.Options.InvalidOptionsException: The options CmsOptions are invalid.

Resolution:

  • The reason why options are invalid are logged to the output of Docker. Please consult the logs for more information on why the options are invalid.
  • If you are running on a Linux environment, the colon may not work. Please use "__" (double underscore) as delimiters.

Authentication failed while requesting the history for document 'document-id' with correlation-id ''

Symptoms:

Logs:

Authentication failed while requesting the history for document 'document-id' with correlation-id ''.

Resolution:

  • If you are using the Fonto-Correlation-Id header for authentication, please make sure you set it when proxying requests to the Document History App. The empty quotation marks ('') indicate that NO correlation id has been sent to the CMS.


Was this page helpful?