🏠/notes.ini Parameter/FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB

FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB

Parameter: FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB
Kurzbeschreibung: Companion-Setting zur Whitelist: setzt eine obere Größengrenze (in MiB) für Anhänge; größere Dateien werden nicht indiziert.

Steckbrief

Parameter
FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB
Kategorie
Performance / Memory
Komponente
Server, Client
Verfügbar seit
14.0 (HCL Domino — Companion-Setting in modifying_file_attachment_indexing ab 14.0/14.5)
Unterstützte Versionen
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
Ganzzahl in MiB (Mebibytes), z. B. 25, 50, 100, 250

Beschreibung

FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB ist laut HCL-Doku ein Companion-Setting zu
FT_INDEX_FILTER_ATTACHMENT_TYPES. Während FT_INDEX_FILTER_ATTACHMENT_TYPES festlegt, welche Datei-Endungen über die Whitelist in den Volltextindex aufgenommen werden, definiert FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB die maximale Dateigröße dieser Anhänge. Der Wert ist eine Ganzzahl und wird in MiB (Mebibytes) interpretiert.
Anhänge, die größer sind als der hier konfigurierte Wert, werden auch dann nicht indiziert, wenn ihre Endung auf der Whitelist steht. Der Parameter wirkt also als eine Art Bremse für ungewollt große PDFs, ZIP-Container oder Office-Dateien, die den Tika-Konversionsfilter und das FT-Subsystem (Memory, CPU, Indexgröße) sonst überproportional belasten würden.
Typischer Einsatz: Mailfiles oder Archiv-Datenbanken mit großen Office- oder PDF-Anhängen, in denen die Volltextsuche nur Inhalte bis zu einer praktischen Größe (z. B. 50 MiB) erfassen soll.

Beispiel-Konfiguration

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

Hinweise & Stolperfallen

  • Wirkt ausschließlich in Verbindung mit der Whitelist (FT_INDEX_FILTER_ATTACHMENT_TYPES plus optional FT_USE_ATTACHMENT_WHITE_LIST oder FT_USE_MY_ATTACHMENT_WHITE_LIST). Ohne aktive Whitelist hat das Setting keine Wirkung.
  • Einheit ist MiB, nicht MB — 50 MiB = 52 428 800 Bytes (Faktor 1024², nicht 1000²).
  • Anhänge oberhalb des Limits werden weder mit Tika noch mit Brute-Force-Text-Stripping erfasst — der Anhang ist im FT-Index schlicht nicht vorhanden.
  • Änderung greift erst beim nächsten Indexlauf — load updall -f für betroffene Datenbanken erzwingt einen Rebuild.

Quellen (HCL Product Documentation)