KeyFilename – notes.ini-Parameter (HCL Notes & Domino)

Parameter: KeyFilename

Kurzbeschreibung: Vollständiger Pfad zur Notes/Domino-ID-Datei. Beim Notes-Client zeigt KeyFilename auf die User-ID, beim Domino-Server auf die Server-ID.

Steckbrief

Parameter	`KeyFilename`
Kategorie	Client-Konfiguration / Setup
Komponente	Notes-Client und Domino-Server
Wertebereich	Absoluter Dateipfad zu einer gültigen `.id`-Datei
Standardwert	Wird beim Setup automatisch gesetzt (Pfad zur User- bzw. Server-ID)
Verfügbar seit	Sehr früh (vor 9.0.1) – Standard-Setup-Parameter aller Notes-/Domino-Versionen
Wirksam ab	Beim Programmstart
GUI-Entsprechung	Keine direkte GUI – wird beim Setup gesetzt; am Client änderbar über File → Security → User Security (Switch ID); am Server über das Setup-Skript bzw. die ID-Vault-Wiederherstellung

Beschreibung

Vollständiger Pfad zur Notes/Domino-ID-Datei.

Am Notes-Client verweist KeyFilename auf die User-ID-Datei (z. B. user.id).

Am Domino-Server verweist KeyFilename auf die Server-ID-Datei (üblicherweise server.id).

Der Eintrag wird beim ersten Notes-/Domino-Setup automatisch in die notes.ini geschrieben und ist für den Start zwingend erforderlich. Auch der COM-Zugriff von Anwendungen auf Notes/Domino verwendet die in KeyFilename angegebene ID-Datei.

Beispiele


KeyFilename=C:\HCL\Notes\Data\user.id


KeyFilename=D:\Data\server.id


KeyFilename=/local/notesdata/server.id

Hinweise

Der Pfad muss auf eine existierende, gültige .id-Datei zeigen. Fehlt die Datei oder ist der Pfad ungültig, schlägt der Notes-/Domino-Start fehl.

Bei einem Server-Upgrade ist es wichtig, dass KeyFilename weiterhin auf die korrekte Server-ID zeigt (HCL KB0039523 empfiehlt explizit den Abgleich nach einem Upgrade).

Der direkte Eingriff in die notes.ini ist möglich, aber riskant. Auf Domino-Servern wird die Pflege über Configuration Settings-Dokumente bzw. Desktop-Policies empfohlen.

Pendant-Parameter am Server: ServerKeyFileName wird zusätzlich gepflegt (relativer Dateiname der Server-ID).

Quellen (HCL Product Documentation)

HCL Customer Support – KB0033472 „Where are all the Notes Preferences settings stored" (Applies to: Notes 9.x, 10.x, 11.x, 12.x): support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0033472

HCL Customer Support – KB0081077 „Moving the Domino Data directory to a different partition" (Beispiel KeyFilename=D:\Data\server.id): support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0081077

HCL Customer Support – KB0039523 „'Connection denied: The server you connected to has a different name…' after Domino server upgrade" (Hinweis zu serverkeyfilename in der notes.ini): support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0039523

HCL Domino Designer 9.0.1 – Requirements (COM): „The KeyFileName setting in the notes.ini file specifies the user ID that COM uses." help.hcl-software.com/dom_designer/9.0.1/appdev/H_ACCESSING_THE_DOMINO_OBJECTS_THROUGH_COM_REQUIREMENTS.html

HCL Domino 14.5.1 – NOTES.INI Settings (Übersicht): help.hcl-software.com/domino/14.5.1/admin/conf_notesinisettings_c.html