Start/notes.ini Parameters/DAOSBasePath

DAOSBasePath

DAOSBasePath defines the directory in which Domino stores the deduplicated attachments of the DAOS repository (NLO files). The parameter is the notes.ini equivalent of the field „DAOS base path“ in the Server document (tab „DAOS“).

Profile

Parameter
DAOSBasePath
Component
Server
Category
DAOS
Available since
Domino 8.5; currently documented in HCL Domino 9.0.x–14.5.1
Value format
Path string (relative or absolute)
GUI equivalent
Server document → „DAOS“ → „DAOS base path“

Description

DAOSBasePath is the root directory of the DAOS repository. Below it, Domino creates a two-level hash directory structure in which the individual NLO files as well as the catalog (daoscat.nsf, daos.cfg) are stored.
The path can be specified in two ways:
  • Relative to the Domino data directory, e.g. DAOS. Domino then creates the repository under <Data>\DAOS (Windows) or <Data>/DAOS (Linux/AIX).
  • Absolute, e.g. D:\DAOS (Windows), /local/daos (Linux), /var/domino/daos (Linux). Recommended as soon as the DAOS repository should reside on its own volume.

Best practice

According to HCL KB0079120, the DAOS directory should:
  • reside on its own volume (separate from the data and translog volumes),
  • be excluded from OS antivirus scans
  • be considered in the backup strategy (together with translog).

AIX/Linux: not at the root

KB0079120 explicitly notes that on AIX/Linux the DAOS directory must not be placed directly at the root volume:
  • Not recommended: DAOSBasePath=/daos/xxxxx
  • Recommended: DAOSBasePath=/<directory>/daos/xxxxx
The reason is that, otherwise, the root volume is at risk if the DAOS directory fills up, which can destabilize the system.

Examples

Windows server, DAOS on its own volume:
DAOSEnable=1
DAOSBasePath=D:\DAOS
DAOSMinObjSize=4096
DAOSDeferredDeleteInterval=30
Linux server, DAOS underneath a deliberate application directory:
DAOSEnable=1
DAOSBasePath=/local/domino/daos
DAOSMinObjSize=4096
DAOSDeferredDeleteInterval=30
Small server with default layout (relative path to the data directory):
DAOSEnable=1
DAOSBasePath=DAOS
DAOSMinObjSize=4096
DAOSDeferredDeleteInterval=30

Notes

  • Takes effect only after a server restart – changes to DAOSBasePath require a complete server stop including all running Domino API processes (compact, resync, backup, ...).
  • Mind the access rights – the Domino service account needs full read, write, and create rights on the specified directory.
  • Path change – when relocating the DAOS repository, do not just change DAOSBasePath; the entire directory including daoscat.nsf must be moved consistently, then run tell daosmgr resync.
  • Companion parameters – DAOSEnable, DAOSMinObjSize, DAOSDeferredDeleteInterval, DAOS_ENCRYPT_NLO, DAOS_LOAD, DAOSCatalogState.

Sources (HCL Product Documentation)