Nsslapd-db-checkpoint-interval, Nsslapd-db-circular-logging, Nsslapd-db-debug – Red Hat 8.1 User Manual

Page 122

Advertising
background image

cache the indexes (the .db4 files) and other files. This value is passed to the Berkeley DB API function
set_cachesize. If automatic cache resizing is activated, this attribute is overridden when the server
replaces these values with its own guessed values at a later stage of the server startup.

For more technical information on this attribute, see the cache size section of the Berkeley DB reference
guide at

http://www.oracle.com/technology/documentation/berkeley-db/db/api_c/env_set_cachesize.html

.

Attempting to set a value that is not a number or is too big for a 32-bit signed integer returns an
LDAP_UNWILLING_T O_PERFORM error message with additional error information explaining the
problem.

The server has to be restarted for changes to this attribute to go into effect.

Parameter

Description

Entry DN

cn=config, cn=ldbm database, cn=plugins,
cn=config

Valid Range

500 kilobytes to 4 gigabytes for 32-bit platforms
and 500 kilobytes to 2^64-1 for 64-bit platforms

Default Value

10000000 (bytes)

Syntax

Integer

Example

nsslapd-dbcachesize: 10000000

3.4 .1.6. nsslapd-db-checkpoint-interval

This sets the amount of time in seconds after which the Directory Server sends a checkpoint entry to the
database transaction log. The database transaction log contains a sequential listing of all recent
database operations and is used for database recovery only. A checkpoint entry indicates which
database operations have been physically written to the directory database. The checkpoint entries are
used to determine where in the database transaction log to begin recovery after a system failure. The
nsslapd-db-checkpoint-interval attribute is absent from dse.ldif. To change the checkpoint
interval, add the attribute to dse.ldif. This attribute can be dynamically modified using ldapmodify.
For further information on modifying this attribute, see the "Tuning Directory Server Performance"
chapter in the Directory Server Administrator's Guide.

This attribute is provided only for system modification/diagnostics and should be changed only with the
guidance of Red Hat technical support or Red Hat professional services. Inconsistent settings of this
attribute and other configuration attributes may cause the Directory Server to be unstable.

For more information on database transaction logging, refer to the "Monitoring Server and Database
Activity" chapter in the Directory Server Administrator's Guide.

Parameter

Description

Entry DN

cn=config, cn=ldbm database, cn=plugins,
cn=config

Valid Range

10 to 300 seconds

Default Value

60

Syntax

Integer

Example

nsslapd-db-checkpoint-interval: 120

3.4 .1.7. nsslapd-db-circular-logging

This attribute specifies circular logging for the transaction log files. If this attribute is switched off, old
transaction log files are not removed and are kept renamed as old log transaction files. Turning circular
logging off can severely degrade server performance and, as such, should only be modified with the
guidance of Red Hat Technical Support or Red Hat Professional Services.

Parameter

Description

Entry DN

cn=config, cn=ldbm database, cn=plugins,
cn=config

Valid Values

on | off

Default Value

on

Syntax

DirectoryString

Example

nsslapd-db-circular-logging: on

3.4 .1.8. nsslapd-db-debug

This attribute specifies whether additional error information is to be reported to Directory Server. To
report error information, set the parameter to on. This parameter is meant for troubleshooting; enabling
the parameter may slow down the Directory Server.

Parameter

Description

122

Chapter 3. Plug-in Implemented Server Functionality Reference

Advertising