Troubleshooting IBM Notes Connector Issues

NameLookups are limited on this server to a size smaller than what would be returned. See your Domino Administrator for more information.

Possible cause

The global address book on the server contains too many entries to be returned in a single batch. The server is not configured to handle this.

Possible solution

Add the NAMELOOKUP_MAX_MB variable in notes.ini on the server. Assign it a value of 2 (MB), then increase it gradually until you no longer see the error message. Otherwise, it is possible to add the custom source parameter TreatLookupErrorsAsWarnings and set it to True (see Modifying Hidden IBM Notes Source Parameters). However, expect the metadata fields to have incorrect email addresses.

Unable to instantiate the Lotus Notes classes: Failed to read from an IPC port: The pipe has been ended.

Possible causes

• The timeout value is not large enough when initializing the Notes API.

• The notes.ini file being used by the connector is invalid.

• More than one Notes source is running and one of them is currently crawling a corrupted database. Thus, one of the sources stopped.

Possible solutions

• Increase the value of the source parameter Server Query Timeout.

• Configure the notes.ini file properly by opening at least one database on the targeted Domino server using the Notes client installed on the CES server.

• Add the parameter EnableSafeMode on all Notes sources and on the Notes security provider (see Modifying Hidden IBM Notes Source Parameters and Configuring an IBM Notes Security Provider).

Mapping (FormType) not found in the metadata mappings.

Possible cause

There is no mapping defined for the specified form type.

Possible solution

Define the mapping for the specified form type through the Fields section of your source. Otherwise, ignore this form by adding it to the Ignored Forms source parameter (see Modifying Hidden IBM Notes Source Parameters).

Closing the Notes processes and resetting the API. Additionally, if CES is running in standalone mode (CESService7.exe –standalone), you may see empty command prompt windows popping up intermittently.

Possible cause

The connector tried to retrieve a corrupted document but the Notes API crashed by doing so.

Possible solution

There is no required user action; the connector handles this situation automatically by resetting the API to a proper state and resuming the crawling where it stopped.

Note: Any other process using the Notes API will be aborted (Lotus Notes client, Domino Administrator, Domino Designer, ...). If other Notes sources may run at the same time, refer to the Configuration section of this documentation, specifically for the EnableSafeMode parameter (see Modifying Hidden IBM Notes Source Parameters).

Cannot load security provider: [error/warning message]

Possible cause

An invalid parameter prevents the security provider from loading.

Possible solution

Read the error message carefully as it describes the cause of the error. In case no error/warning message is displayed, either the DLL Path or the AssemblyPath parameter is incorrect (see Configuring an IBM Notes Security Provider).

Only one Resolution Method is allowed for the Notes Security Provider. To use several resolution methods, use the AllowMultitpleResolutionMethods parameter.

Possible cause

The security mapping file contains either no resolution method or several resolution methods although the Allow Multiple Resolutions Methods parameter was not enabled (see Configuring an IBM Notes Security Provider).

Possible solutions

• Define at least one resolution method in the security mapping file if it does not contain any.

• In case several resolution methods are used, select the Allow Multiple Resolutions Methods checkbox in the security provider parameters list (see Configuring an IBM Notes Security Provider).

class Notes::DatabaseOpenFailedException: Unable to find path to server. Check that your network connection is working. If you have a working connection, go to Preferences - Notes Ports and click Trace to discover where it breaks down. (2051)

Possible cause

Either the notes.ini file or the user.id file used by the connector or the security provider is invalid for the targeted Domino server.

Possible solution

Make sure that the notes.ini file is properly configured to connect to the targeted Domino Server. Otherwise, verify that the user.id file has proper access to the Domino server.

Getting a blank page when accessing the Fields section of a Notes source.

Possible symptoms

• As soon as you try to access the section, you get a blank page.

• You try to access the section but it takes a while before you get the blank page (about 1min 30sec)

Possible causes

• The credentials you use in your source are incorrect (user identity), or there is some network problem (server unreachable).

• Retrieving the fields and forms from the database(s) in the starting address(es) takes too much time, either because the design complexity of these database(s) is high or because the network connection is slow.

Possible solutions

• Fix the user identity used by your source. The password is most likely incorrect. Also, make sure that you can ping the servers pointed to by your starting addresses.

• Add the GetFormsTimeout parameter to your source. The default value is 30 sec. Increase its value until you no longer get the blank page (see Modifying Hidden IBM Notes Source Parameters).