Start/notes.ini Parameter/HTTP_PRELOAD_FILTERS

HTTP_PRELOAD_FILTERS

🛠️
Parameter: HTTP_PRELOAD_FILTERS
Kurzbeschreibung: Gibt an, welche DSAPI-Filter beim HTTP-Start vorab geladen werden sollen – vermeidet längere Ladezeiten beim ersten Request.

Steckbrief

Parameter
HTTP_PRELOAD_FILTERS
Kategorie
HTTP / Web
Komponente
Server
Verfügbar seit
10.0
Unterstützte Versionen
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Nur notes.ini (keine GUI)
Mögliche Werte
Kommaseparierte Dateinamen der DSAPI-Filter (ohne Pfad)

Beschreibung

DSAPI-Filter werden normalerweise lazy geladen – also erst, wenn der erste passende Request eintrifft. Beim ersten Aufruf entstehen so unter Umständen mehrere Sekunden Verzögerung, weil Bibliotheken und Konfigurationen erst zur Laufzeit eingelesen werden. HTTP_PRELOAD_FILTERS listet die Filter, die der HTTP-Task direkt nach dem Start mitladen soll. Damit ist die HTTP-Pipeline ab dem ersten Request voll ausgestattet, was insbesondere für SSO-/Auth-Filter wichtig ist.

Beispiel-Konfiguration

HTTP_PRELOAD_FILTERS=domsaml.dll,iwaredir.dll

Hinweise & Stolperfallen

  • Nur Dateinamen angeben (kein Pfad). Die Filter müssen über den üblichen DSAPI-Suchpfad auffindbar sein.
  • Reihenfolge ist relevant, wenn Filter aufeinander aufbauen – Reihenfolge wie im Server-/Internet-Site-Dokument einhalten.
  • Änderungen erfordern einen HTTP-Restart (tell http restart).
  • Falsch geschriebene Filter werden mit Fehler im console.log quittiert; HTTP startet trotzdem, der Filter ist dann inaktiv.