Modifying Hidden IBM Notes Source Parameters

The Add Source and Source: ... General pages of the Administration Tool present the parameters with which you can configure the connector for most IBM Notes setups. More advanced and more rarely used parameters are hidden. You can choose to make one or more of these parameters appear in the Add Source and Source: ... General pages of the Administration Tool so that you can change their default value. Consider changing values of hidden parameters when you encounter issues.

The following list describes the advanced hidden parameters available with IBM Notes sources. The parameter type (integer, string…) appears between parentheses following the parameter name.

TreatLookupErrorsAsWarnings (Boolean)

This is used to ignore any error during user lookup in the Domino address book at the beginning of an indexing run. The default value is false.

HandledNetworkErrorCodes (String)

This parameter is used to define the list of network error codes handled by the connector as fatal exceptions, that is, error codes that will stop any indexing run (without wiping out the entire index). The default values are 2055,2561,2562,2570,2604,2645,7267,7287.

UsersCacheLifeSpan (Integer)

This parameter is used to define the life span of the users cache built from the Domino address book. Once the default 24-hour period has passed, the next crawling run (Rebuild/Refresh/Live Indexing) will trigger an update of the users cache. This update is not a complete rebuild; the connector only considers modifications made to the Domino address book since the last rebuild/update of the users cache. The default value is 1440 min (24 h).

AddressBookServerURL (String)

This parameter is used to customize the address book server used by the connector. The address book is used to retrieve several fields from Notes users, such as their email address, mail filenames, etc. The correct syntax for this parameter is either: notes://[server_name] for a specific Domino server or notes:/// for a local server (personal address book). The default value is none.

LocalDatabaseMappingFilePath (String)

This parameter is used to specify a mapping file specifically for local Notes databases. The mapping file can be used to override security permissions and to fill emailsearch-related fields on indexed documents, even if your Personal address book is incomplete. With a mapping file that is properly configured, you can crawl both remote and local databases using the same source, meaning that you can have a security provider assigned to your source (for remote databases) and also a mapping file (for local databases). When you don't use this parameter, the current security permission option in your source will be used for local databases. Basically, it means that emailsearch-related fields as well as security permissions may be incorrect on indexed documents. The default value is none.

GetFormsTimeout (Integer)

This is the time period (in seconds) allowed for the extraction of forms and fields when we access the Fields section of a Notes source. The extraction can take up to several minutes, depending on the complexity of your database design. The default value is 30 sec.

DisableSecurityMappingCache (Boolean)

Select true would disable the SecurityMappingCache. When every single document has a different security, changing the value to true could speed up the crawling. For most other setups, changing the DisableSecurityMappingCache value for true significantly slows down the crawling process. The default value is false.

IgnoreDatabaseSecurityChangeOnLiveIndexing (Boolean)

The default value is false. True would disregard any security change on a database when live indexing. It still would update those changes to the internal structures, but would not reindex because of them. Unless you know that the security has not changed, it is not recommended to use this flag as it will go over security changes.

SampleDatabase (Boolean)

The default value is true. Change the value to false when you want to edit the field mappings.

Use the following procedure only when you want to modify one or more of the above hidden source parameters.

To modify hidden IBM Notes source parameters

1. Refer to Adding an Explicit Connector Parameter to add one or more IBM Notes hidden source parameters.

2. For a new IBM Notes source, access the Add Source page of the Administration Tool to modify the value of the newly added advanced parameter:

   1. Select Index > Sources and Collections.

   2. Under Collections, select the collection in which you want to add the source.

   3. Under Sources, click Add.

   4. In the Add Source page, edit the newly added advanced parameter value.

3. For an existing IBM Notes source, access the Source: ... General page of the Administration Tool to modify the value of the newly added advanced parameter:

   1. Select Index > Sources and Collections.

   2. Under Collections, select the collection containing the source you want to modify.

   3. Under Sources, click the existing IBM Notes source in which you want to modify the newly added advanced parameter.

   4. In the Source: ... General page, edit the newly added advanced parameter value.

4. Rebuild your IBM Notes source to apply the changes to the parameters (see Applying an Action to a Collection or a Source).