Start/notes.ini Parameter/SetupLeaveServerTasks

SetupLeaveServerTasks

Beschreibung

Verhindert, dass HCL Domino während eines Upgrade-Installs die ServerTasks- und ServerTasksAt<N>-Einträge in der notes.ini auf die neuen Default-Werte zurücksetzt. Mit SetupLeaveServerTasks=1 bleiben individuell angepasste Task-Listen über das Upgrade hinweg erhalten.
Laut HCL KB0104793 ist es working as designed, dass das Upgrade die Standardwerte für ServerTasks und ServerTasksAt in die notes.ini schreibt – dies geschieht, damit neue Server-Tasks aktueller Versionen zuverlässig aktiv werden. Wer bewusst eine reduzierte oder erweiterte Task-Liste betreibt, muss die Variable SetupLeaveServerTasks=1 vor dem Upgrade setzen. Im Server-Log ist die Wirkung dann an einer Zeile wie „Default server task Catalog will NOT be added to ServerTasksAt1 in NOTES.INI because SetupLeaveServerTasks is set" erkennbar.

Steckbrief

Parameter
SetupLeaveServerTasks
Kategorie
Startup / Tasks (Upgrade-Verhalten)
Komponente
Domino-Server (Setup/Upgrade-Routine)
Wertebereich
0 (Standard, Defaults werden geschrieben) oder 1 (vorhandene Werte bleiben unberührt)
Standardwert
0 (nicht gesetzt = Default-Verhalten: Upgrade überschreibt ServerTasks/ServerTasksAt)
Verfügbar seit
Sehr früh (vor 9.0.1) – historisch in allen unterstützten Notes-/Domino-Versionen
Wirksam ab
Beim nächsten Upgrade-Install (Setup-Phase liest die Variable vor dem Schreiben der Defaults)
GUI-Entsprechung
Keine GUI – ausschließlich über notes.ini

Beispiel

SetupLeaveServerTasks=1

Hinweise

  • Setting muss vor dem Upgrade-Install in der notes.ini stehen – nachträgliches Setzen hilft nicht, wenn die Default-Werte bereits geschrieben wurden.
  • Empfohlenes Vorgehen vor einem Upgrade: vorhandene ServerTasks/ServerTasksAt<N>-Einträge sichern, SetupLeaveServerTasks=1 setzen, Upgrade durchführen, anschließend prüfen, ob neue Default-Tasks der Zielversion ggf. manuell hinzugefügt werden müssen.
  • Verifizierung im Server-Log: Eintrag „... will NOT be added to ServerTasks... because SetupLeaveServerTasks is set" belegt, dass das Setting greift.
  • Auf Cluster-Servern oder bei standardisierten Umgebungen ist der bessere Weg, Wartungs-Tasks über Programm-Dokumente im Domino-Directory zu steuern – dann sind ServerTasks/ServerTasksAt-Anpassungen in der notes.ini ohnehin minimal und das Upgrade-Reset fällt weniger ins Gewicht.
  • Setting hat keinen Einfluss auf den laufenden Betrieb – es wird nur während Setup/Upgrade ausgewertet.

Quellen (HCL Product Documentation)