Troubleshoot Errors

If you run the connector and find that it stops immediately, check the logs to see if any errors occurred at the time you tried to start it. You can also try running the connector from the command prompt to see if any messages are output to the console.

The following table provides the solutions for some common problems:

Symptom Resolution

The connector stops immediately, writing this line to the console and to connectorLibDotNet.log:

EXCEPTION: Could not find the requested file: connectorLibDotNet.cfg

Ensure the configuration file is present in the connector directory. The configuration file must have the same name as the executable, but with the extension cfg instead of exe. For example:

connectorLibDotNet.cfg

The connector stops immediately, writing this line to the console:

EXCEPTION: Failed to Create class

DotNetConnector.dll is not present, or the wrong version is present. Ensure that the version of DotNetConnector.dll provided with connectorLibDotNet.exe is present in the connector directory.

The connector stops immediately, logging this line to the application log:

ERROR: Method objConnector.constructor failed ... Could not load file or assembly '....dll' or one of its dependencies.

Ensure your connector DLL and all of its dependencies are present in the connector directory. Also ensure that the configuration parameter DotNetConnectorLibrary is set correctly in the configuration file.

The connector stops immediately, logging this line to the application log:

ERROR: Method objConnector.Constructor failed ... No connector class: '...' could not be found in '...'

The class specified could not be found in the DLL specified. Check that the DotNetConnectorLibrary and DotNetConnectorClass configuration parameters are set correctly in the configuration file.

The connector stops immediately, logging this line to the application log:

ERROR: Method objConnector.Constructor failed ... Constructor on type '...' not found.

The class specified by the DotNetConnectorLibrary and DotNetConnectorClass configuration parameters was found but it did not have the expected constructor (taking two arguments – an IConfig and an ILog).

The connector stops immediately, logging this line to the application log:

ERROR: Method objConnector.Constructor failed ... No connector class: '...' in '...' is not of the correct type.

The class specified by the DotNetConnectorLibrary and DotNetConnectorClass configuration parameters was found but it did not have ConnectorBase as its base type.

The connector stops and logs this error to license.log:

No license found for My Connector

(where My Connector is the name of your connector).

A valid ConnectorLib .NET license could not be found. Check the settings in the [License] section of the configuration file, that the license server can be contacted, and that you have a valid ConnectorLib .NET license.