Equisys technical notes

Technical guidance, explanations and fixes for our products

PRB: Zetadocs Approval Connector fails to start

Print

ZTN4439

ID: ZTN4439

This Zetadocs technical note applies to:

  • Zetadocs Approval Connector 2.2.75.24

Symptom

The Zetadocs Approval Connector service does not start. The log file generated (usually found in “%temp%\Zetadocs\Zetadocs.Approval.Connector.log”) shows the following error:

Zetadocs.Exceptions.BaseException: The HTTP request is unauthorized with client authentication scheme 'Negotiate'. The authentication header received from the server was 'NTLM'. ---> System.ServiceModel.Security.MessageSecurityException: The HTTP request is unauthorized with client authentication scheme 'Negotiate'. The authentication header received from the server was 'NTLM'. ---> System.Net.WebException: The remote server returned an error: (401) Unauthorized.

This may occur on older Windows Server operating systems (prior to Server 2008 R2)

Cause

Older Windows Server operating systems do not recognise the credential type specified as default by the Zetadocs Approval Connector.

Resolution

A change to the credential type is required within the Zetadocs.Approval.Connector.Service.exe.config to enable NTLM credentials rather than Windows credentials. Please follow the steps below:

  1. Open the Zetadocs.Approval.Connector.Service.exe.config file and find the following line:
  2. Replace “Windows” with “NTLM”
  3. Save the file and restart the Zetadocs Approval Connector service.

Status

Equisys is aware of this issue and will update this technical note when a solution has been found.

Last updated: 4th November 2015 (NT) 

Keywords: service started and stopped

Equisys Logo, Document Management and Expense Management for Business Central
 

Replaced by script