Parameter:
FT_USE_ATTACHMENT_WHITE_LISTShort description: Activates the default whitelist when full-text indexing attachments; only extensions on the whitelist are processed via the Tika filter.
Profile
Parameter | FT_USE_ATTACHMENT_WHITE_LIST |
Category | Performance / Memory |
Component | Server, Client |
Available since | 9.0.1 |
Supported versions | 9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1 |
GUI equivalent | Configuration document (NOTES.INI tab) or Desktop Settings Policy → Custom Settings → notes.ini |
Possible values | 0 = only the default ignore list applies (default), 1 = default whitelist active (additionally extendable via FT_INDEX_FILTER_ATTACHMENT_TYPES) |
Description
FT_USE_ATTACHMENT_WHITE_LIST=1 activates the default whitelist of the FT indexer. This list contains the file extensions that HCL Domino has hard-coded as "safe and useful to index" (all formats supported by Tika minus the default ignore list such as *.exe, *.dll, *.zip, *.png, *.jpg, etc.).In contrast to FT_USE_MY_ATTACHMENT_WHITE_LIST, the default list is not discarded but used as a baseline. It can be extended with custom extensions via FT_INDEX_FILTER_ATTACHMENT_TYPES ("extending the white list").
Behavior: with the whitelist active, an attachment is processed by the Tika conversion filter only if its extension is explicitly on the whitelist. This is the strictest form of control — if the ignore list and the whitelist collide, the whitelist takes precedence.
Example configuration
FT_USE_ATTACHMENT_WHITE_LIST=1 FT_INDEX_FILTER_ATTACHMENT_TYPES=*.csv,*.json,*.log
Runtime variant (server console):
set config FT_USE_ATTACHMENT_WHITE_LIST=1
Notes & pitfalls
- The whitelist takes precedence over the ignore list — if an extension is on both lists, it is indexed, not ignored.
- Only effective in combination with the Apache Tika conversion filter; with "brute force text-stripping" the whitelist does not apply.
- Changes only take effect after a rebuild of the FT index (
load updall -f).
- Complementary: FT_USE_MY_ATTACHMENT_WHITE_LIST (discards the default list), FT_INDEX_FILTER_ATTACHMENT_TYPES (extends the active whitelist), FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB (size limit), FT_INDEX_IGNORE_ATTACHMENT_TYPES (blacklist).
- Easiest deployment across many servers via configuration document → NOTES.INI tab; on Notes clients via Desktop Settings Policy.