ConnectorLib C++ 25.2
ConnectorLib C++ SDK Programming Guide

# 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.

Copyright 2025 Open Text
Version 25.2 | Last updated April 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery ConnectorLib C++ 25.2

Topic Title: Troubleshoot Errors