Start/notes.ini Parameter/FT_USE_MY_ATTACHMENT_WHITE_LIST

FT_USE_MY_ATTACHMENT_WHITE_LIST

Parameter: FT_USE_MY_ATTACHMENT_WHITE_LIST
Kurzbeschreibung: Verwirft die Default-Whitelist beim FT-Indexieren von Anhängen und erzwingt ausschließlich die in FT_INDEX_FILTER_ATTACHMENT_TYPES definierten Datei-Endungen.

Steckbrief

Parameter
FT_USE_MY_ATTACHMENT_WHITE_LIST
Kategorie
Performance / Memory
Komponente
Server, Client
Verfügbar seit
9.0.1
Unterstützte Versionen
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Konfigurations-Dokument (NOTES.INI-Tab) bzw. Desktop Settings Policy → Custom Settings → notes.ini
Mögliche Werte
0 = Default-Whitelist (Default), 1 = ausschließlich die in FT_INDEX_FILTER_ATTACHMENT_TYPES definierte Custom-Liste verwenden

Beschreibung

FT_USE_MY_ATTACHMENT_WHITE_LIST steuert das Whitelist-Verhalten beim Volltext-Indexieren von Datei-Anhängen über den Apache-Tika-Konversionsfilter. Steht der Wert auf 1, verwirft Domino die mitgelieferte Default-Whitelist (alle von Tika unterstützten Formate abzüglich der Default-Ignore-Liste) vollständig und indiziert ausschließlich die in FT_INDEX_FILTER_ATTACHMENT_TYPES aufgeführten Datei-Endungen.
Der Parameter ist die strikte Variante des Whitelistings:
  • FT_USE_ATTACHMENT_WHITE_LIST=1 aktiviert zusätzlich die Default-Whitelist (kann via FT_INDEX_FILTER_ATTACHMENT_TYPES erweitert werden).
  • FT_USE_MY_ATTACHMENT_WHITE_LIST=1 ersetzt die Default-Whitelist und arbeitet ausschließlich mit der vom Admin definierten Liste.
Typischer Einsatz: streng regulierte Umgebungen (Banken, Behörden, GxP, Public Sector), in denen genau festgelegt werden muss, welche Anhang-Typen durch den Tika-Konversionsfilter und damit in den Volltextindex gehen.

Beispiel-Konfiguration

FT_USE_MY_ATTACHMENT_WHITE_LIST=1
FT_INDEX_FILTER_ATTACHMENT_TYPES=*.pdf,*.docx,*.xlsx,*.pptx,*.txt
Laufzeit-Variante (Server-Konsole):
set config FT_USE_MY_ATTACHMENT_WHITE_LIST=1

Hinweise & Stolperfallen

  • Achtung Falle (HCL-dokumentiert): Ist FT_USE_MY_ATTACHMENT_WHITE_LIST=1 gesetzt, ohne dass FT_INDEX_FILTER_ATTACHMENT_TYPES definiert wurde, werden gar keine Anhänge mehr indiziert — und zwar serverweit über alle Datenbanken.
  • Wirkt nur in Verbindung mit dem Apache-Tika-Konversionsfilter; Datenbanken, deren FT-Index ohne Konversionsfilter („brute force text-stripping") erstellt wird, werden nicht durch diese Whitelist gesteuert.
  • Änderungen an der Whitelist greifen erst nach Neuaufbau des FT-Index der betroffenen Datenbanken (load updall -f).
  • Deployment auf vielen Servern am einfachsten via Konfigurations-Dokument → NOTES.INI-Tab, auf Notes-Clients via Desktop-Settings-Policy (Custom Settings → notes.ini).

Quellen (HCL Product Documentation)