Start/notes.ini Parameters/DBDIR_DIRECTORY_SCAN_INTERVAL

DBDIR_DIRECTORY_SCAN_INTERVAL

Parameter: DBDIR_DIRECTORY_SCAN_INTERVAL
Short description: Interval (seconds) at which the Database Directory Cache is validated against the physical file system. Default 900 (15 min). Replaces DBDIR_REFRESH_INTERVAL.

Profile

Parameter
DBDIR_DIRECTORY_SCAN_INTERVAL
Category
Performance / Memory
Available since
At least 9.0.1 (HCL documentation)
GUI equivalent
notes.ini only (no GUI)
Possible values
Integer in seconds
Default
900 (15 minutes)

Description

According to HCL product documentation:
Specified in seconds, this setting controls how often the run time database directory cache is validated against the physical disk to check for files changed, added or deleted outside of Notes. A shorter interval will result in greater I/O utilization. The default is 900 seconds (15 minutes). This replaces DBDIR_REFRESH_INTERVAL.
So that the Database Directory Cache does not get out of sync with the file system — e.g. when NSFs have been added or removed outside of Notes (e.g. via backup restore, file move, external tools) — the server scans the physical data directory at regular intervals. DBDIR_DIRECTORY_SCAN_INTERVAL defines this interval in seconds.

Example configuration

DBDIR_DIRECTORY_SCAN_INTERVAL=900

Notes & pitfalls

  • Value in seconds.
  • Shorter intervals → faster detection of external changes, but noticeably more disk I/O.
  • On servers with large data directories (many thousands of NSFs), set defensively.
  • Replaces the older parameter DBDIR_REFRESH_INTERVAL.
  • Complementary to DBDIR_CACHE_SAVE_TO_DB_INTERVAL and DBDIR_REFRESH_FROM_DISK.

Sources (HCL Product Documentation)