Start/notes.ini Parameters/UPDATE_IDLE_TIME

UPDATE_IDLE_TIME

Parameter: UPDATE_IDLE_TIME
Short description: Pause (in seconds) between two Update task operations. Default 5. Lower values speed up index maintenance when Updater queues are heavily loaded.

Profile

Parameter
UPDATE_IDLE_TIME
Syntax
UPDATE_IDLE_TIME=<seconds>
Default
5 (seconds pause between two Update operations)
Values
Integer in seconds (value 0 = no pause, very aggressive)
Category
Performance / Memory (Updater tuning)
GUI equivalent
none (notes.ini only)
Related
UPDATE_IDLE_TIME_MS, FTUPDATE_IDLE_TIME, FTUPDATE_IDLE_TIME_MS, UPDATE_FULLTEXT_THREAD, Updaters
Available since
Domino 6

Description

  • Between two database updates, the Update task by default waits 5 seconds, so that the indexer doesn't load the server constantly.
  • On servers whose Updater queues grow, this value can be lowered — the Updater then has more time to work through new requests.
  • Values:
    • 5 = default (moderate Updater load)
    • 2–3 = more aggressive tuning, significantly higher Updater load
    • 0 = continue immediately, very high CPU load possible
  • For finer control, since Domino 7 there is also UPDATE_IDLE_TIME_MS (same function in milliseconds).
  • With an active second FT thread (UPDATE_FULLTEXT_THREAD=1), UPDATE_IDLE_TIME only affects the view thread — for the FT thread there is FTUPDATE_IDLE_TIME.

Example

UPDATE_IDLE_TIME=2
  • Update task only waits 2 seconds between updates.
  • For even finer control:
UPDATE_IDLE_TIME_MS=500
  • 500 ms pause between Update operations.

Notes

  • Takes effect only after a server restart or restart of the Update task.
  • Set sub-second values via UPDATE_IDLE_TIME_MS.
  • Before lowering the value, check:
    • CPU utilization of the server,
    • length of the Updater queue (console: show stat),
    • whether options like UPDATE_DISABLE_VIEWS=1 or UPDATE_DISABLE_FULLTEXT=1 would be more appropriate.
  • Has no effect on the Updall task; affects only the continuously running Update task.

Sources (HCL Product Documentation)