Start/notes.ini Parameter/JavaUserClasses

JavaUserClasses

🛠️
Parameter: JavaUserClasses
Kurzbeschreibung: Erweitert den Klassenpfad der Domino-/Notes-JVM – z. B. für eigene JAR-Dateien, JDBC-Treiber oder JNI-Bindings, die Java-Agenten erreichen sollen.

Steckbrief

Parameter
JavaUserClasses
Kategorie
Client-Konfiguration
Komponente
Server, Client
Verfügbar seit
6.0
Unterstützte Versionen
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Nur notes.ini (keine GUI)
Mögliche Werte
Plattformspezifisch getrennte Pfadangabe (Windows: ;, Linux/AIX: :)

Beschreibung

JavaUserClasses erweitert den Standard-Classpath der Domino-/Notes-JVM um zusätzliche JARs und Verzeichnisse. Damit lassen sich z. B. JDBC-Treiber, REST-/JSON-Bibliotheken oder eigene Helper-Klassen in Java-Agenten und XPages verwenden, ohne sie in die Datenbank einzubetten. Auf dem Server gilt der Pfad systemweit; im Notes Client wirkt er beim Ausführen lokaler Java-Agenten.

Beispiel-Konfiguration

JavaUserClasses=C:\\domino\\jvm\\extlib\\postgresql.jar;C:\\domino\\jvm\\extlib\\custom\\

Hinweise & Stolperfallen

  • Trennzeichen plattformabhängig: ; unter Windows, : unter Linux/AIX.
  • Änderungen erfordern einen Server- bzw. Client-Restart – ein einfacher tell http restart reicht meist nicht.
  • JARs sollten vom Domino-Service-Account lesbar und idealerweise read-only sein.
  • Für OSGi-/XPages-Komponenten besser dedizierte OSGi-Updatesites verwenden, statt sie hier einzukippen.
  • Versionskonflikte mit mitgelieferten JARs (z. B. JSON, Apache Commons) können schwer zu debuggen sein – vorab Kompatibilität prüfen.