Salesforce Connector 25.3
Salesforce Connector Help

# Troubleshoot the Connector

This section describes how to troubleshoot problems that might occur when you set up the Salesforce Connector.

The error "token validity expired" appears in the logs

This can occur when your OAuth refresh token has expired. Use the procedure in Configure OAuth Authentication to run the OAuth configuration tool and obtain new OAuth tokens.

In the settings for your Salesforce Connected App (that you created in Create an Application to Represent the Connector) you can configure how long a refresh token remains valid. OpenText recommends choosing either "Refresh token is valid until revoked" or "Expire refresh token if not used for <time duration>". If you choose the latter option, ensure the time duration exceeds the amount of time between synchronize cycles.

The error "invalid query locator" appears in the logs

This can occur when the connector, or multiple connectors using the same account, send too many concurrent requests to SalesForce. SalesForce limits the number of concurrent queries when there are many results that must be paged. You can limit the number of requests by editing the configuration file `SalesforceConnector.exe.config` in the connector installation directory. If the file does not exist you can create it from the example below.

TIP: The file name might be different if you chose a different name for the connector service when installing the connector, but the extension is always `.exe.config`.

The following example limits the connector to two concurrent connections.

    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
        <system.net>
            <connectionManagement>
                <add address = "*" maxconnection = "2" />
            </connectionManagement>
        </system.net>
    </configuration>

Copyright 2025 Open Text
Version 25.3 | Last updated July 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 Salesforce Connector 25.3

Topic Title: Troubleshoot the Connector