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 connectorLibCpp.log:

File I/O: readFile failed: connectorLibCpp.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:

connectorLibCpp.cfg

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

exampleconnector: Unable to load library. File does not exist.

Ensure your connector library (in this example exampleconnector.dll or libexampleconnector.so) and all of its dependencies are present in the connector directory. Also ensure that the configuration parameter ConnectorLibrary is set correctly in the configuration file.

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

EXCEPTION: Failed to find ... function in exampleconnector

The library specified by the ConnectorLibrary configuration parameter (in this case exampleconnector) does not export the necessary function. This is either the wrong library, or the library needs to be recompiled with the appropriate corrections. The main include file autonomy/connector/connector.hpp does define and export the necessary functions, so make sure that this is being included in the source code.

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 C++ 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 C++ license.