6.4. 数据库插件属性


数据库插件也组织在信息树中。数据库实例使用的所有插件技术都存储在 cn=ldbm 数据库 插件节点上。本节以 cn=ldbm database,cn=plugins,cn=config 信息树以粗体显示每个节点的附加属性信息。

本节介绍所有实例通用的全局配置属性,存储在 cn=config,cn=ldbm database,cn=plugins,cn=config tree 节点上。

6.4.1.1. nsslapd-backend-implement

nsslapd-backend-implement 参数定义目录服务器使用的数据库后端。

目录服务器支持以下数据库类型:

  • Berkeley 数据库(BDB)
  • lightning Memory-Mapped Database Manager (LMDB)
Expand
参数描述

条目 DN

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

有效值

bdb 或 mdb

默认值

bdb

语法

目录字符串

Example

nsslapd-backend-implement: mdb

6.4.1.2. nsslapd-backend-opt-level

这个参数可以触发实验代码以提高写入性能。

可能的值:

  • 0 :禁用参数。
  • 1: 在事务过程中,复制更新向量不会写入数据库
  • 2 :更改获取后端锁定并启动事务的顺序
  • 4 :将代码从事务中移出。

所有参数都可以合并。例如 7 会启用所有最佳功能。

警告

这个参数是实验性的。除非特别被红帽支持告知,否则请勿更改其值。

Expand
参数描述

条目 DN

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

有效值

0 | 1 | 2 | 4

默认值

0

语法

整数

示例

nsslapd-backend-opt-level: 0

6.4.1.3. nsslapd-db-deadlock-policy

nsslapd-db-deadlock-policy 参数设置 libdb library-internal deadlock 策略。

重要

只有红帽支持指示时更改此参数。

Expand
参数描述

条目 DN

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

有效值

0-9

默认值

0

语法

DirectoryString

示例

nsslapd-db-deadlock-policy: 9

6.4.1.4. nsslapd-db-private-import-mem

nsslapd-db-private-import-mem 参数管理目录服务器是否使用私有内存来分配数据库导入的区域和 mutexes。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

on

语法

DirectoryString

示例

nsslapd-db-private-import-mem: on

6.4.1.5. nsslapd-db-transaction-wait

如果您启用 nsslapd-db-transaction-wait 参数,目录服务器不会启动事务并等待锁定资源可用。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

off

语法

DirectoryString

示例

nsslapd-db-transaction-wait: off

6.4.1.6. nsslapd-directory

此属性指定数据库实例的绝对路径。如果手动创建数据库实例,则必须包含此属性。创建数据库实例后,请勿修改此路径,因为更改风险阻止服务器访问数据。

Expand
参数描述

条目 DN

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

有效值

数据库实例的任何有效绝对路径

默认值

 

语法

DirectoryString

示例

nsslapd-directory: /var/lib/dirsrv/slapd-instance/db

6.4.1.7. nsslapd-exclude-from-export

此属性包含在导出数据库时从条目中排除的属性名称列表。这主要用于某些特定于服务器实例的配置和操作属性。

不要删除此属性的任何默认值,因为这可能会影响服务器性能。

Expand
参数描述

条目 DN

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

有效值

任何有效的属性

默认值

entrydn entryid dncomp parentid numSubordinates entryusn

语法

DirectoryString

示例

nsslapd-exclude-from-export: entrydn entryid dncomp parentid numSubordinates entryusn

6.4.1.8. nsslapd-idlistscanlimit

nsslapd-idlistscanlimit 属性已弃用,因为属性对搜索性能的影响比有帮助更有害。只针对历史目的提供了进一步的描述。

默认情况下,这个与性能相关的属性指定搜索在搜索操作期间搜索的条目 ID 数量。对于 32 位签名整数,尝试设置不是数字或太大的值会返回 LDAP_UNWILLING_TO_PERFORM 错误消息,并解释此问题的额外错误消息。建议保留默认值以提高搜索性能。

此参数可以在服务器运行时更改,新值将影响后续搜索。

对应的 user-level 属性是 nsIDListScanLimit

Expand
参数描述

条目 DN

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

有效范围

100 到最大 32 位整数值(2147483647)条目 ID

默认值

2147483646

语法

整数

Example

nsslapd-idlistscanlimit: 50000

6.4.1.9. nsslapd-idl-switch

nsslapd-idl-switch 参数设置 IDL 格式目录服务器使用。请注意,红帽不再支持旧的 IDL 格式。

Expand
参数描述

条目 DN

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

有效值

新 | 旧

默认值

new

语法

目录字符串

示例

nsslapd-idl-switch: new

6.4.1.10. nsslapd-lookthroughlimit

此与性能相关的属性指定 Directory 服务器在响应搜索请求时检查候选条目时的最大条目数。但是,目录管理器 DN 默认是无限的,覆盖此处指定的任何其他设置。值得注意,对于这个限制,基于绑定的资源限值可以正常工作,这意味着,如果条目中存在 operational 属性 nsLookThroughLimit 的值,用户绑定绑定,默认限制会被覆盖。对于 32 位签名的整数,尝试设置不是数字或太大的值会返回 LDAP_UNWILLING_TO_PERFORM 错误消息,并解释此问题的额外错误消息。

Expand
参数描述

条目 DN

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

有效范围

-1 在条目中最大 32 位整数(其中 -1 代表无限)

默认值

5000

语法

整数

示例

nsslapd-lookthroughlimit: 5000

6.4.1.11. nsslapd-mode

此属性指定用于新创建的索引文件的权限。

Expand
参数描述

条目 DN

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

有效值

任何四位八进制数。但是,建议使用模式 0600。这允许对索引文件的所有者进行读写访问权限(即 ns-slapd 运行的用户),其他用户没有访问权限。

默认值

600

语法

整数

示例

nsslapd-mode: 0600

6.4.1.12. nsslapd-pagedidlistscanlimit

此与性能相关的属性指定搜索的条目 ID 数,特别是使用简单页面结果控制的搜索操作。

此属性的工作方式与 nsslapd-idlistscanlimit 属性相同,但它只适用于使用简单页面的结果控制进行搜索。

如果此属性不存在或设置为零,则使用 nsslapd-idlistscanlimit 进行页化搜索和非页搜索。

对应的 user-level 属性是 nsPagedIDListScanLimit

Expand
参数描述

条目 DN

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

有效范围

-1 在条目中最大 32 位整数(其中 -1 代表无限)

默认值

0

语法

整数

示例

nsslapd-pagedidlistscanlimit: 5000

6.4.1.13. nsslapd-pagedlookthroughlimit

此与性能相关的属性指定在检查使用简单页面结果控制的候选条目时,Directory 服务器将检查的最大条目数。

此属性的工作方式与 nsslapd-lookthroughlimit 属性相同,但它只适用于使用简单页面结果控制进行搜索。

如果此属性不存在或设置为零,则使用 nsslapd-lookthroughlimit 进行页化搜索和非页搜索。

对应的 user-level 属性是 nsPagedLookThroughLimit

Expand
参数描述

条目 DN

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

有效范围

-1 在条目中最大 32 位整数(其中 -1 代表无限)

默认值

0

语法

整数

示例

nsslapd-pagedlookthroughlimit: 25000

6.4.1.14. nsslapd-rangelookthroughlimit

此与性能相关的属性指定 Directory 服务器在响应范围搜索请求时检查候选条目时的最大条目数。

范围搜索使用运算符设置括号,以搜索和返回目录中整个条目子集。例如,这会搜索在 1 月 1 日午夜之后修改的每个条目:

(modifyTimestamp>=20200101010101Z)
Copy to Clipboard Toggle word wrap

范围搜索的性质是它必须评估目录中的每一条目,才能查看它是否位于给定的范围内。基本上,搜索范围始终是所有 ID 搜索。

对于大多数用户,look-through 限制将启动,并防止范围搜索转换为所有 ID 搜索。这提高了整体性能并加快了范围搜索结果。但是,某些客户端或管理用户(如 Directory Manager)可能没有设置 look-through 限制。在这种情况下,范围搜索可能需要几分钟才能完成,甚至无限期地继续。

nsslapd-rangelookthroughlimit 属性设置适用于所有用户(包括 Directory Manager)的独立范围查找限制。

这允许客户端和管理用户具有较高的查找限制,同时仍允许对性能有影响的范围搜索进行合理的限制。

注意

与其他资源限制不同,这适用于任何用户(包括目录管理器、常规用户和其他 LDAP 客户端)进行搜索。

Expand
参数描述

条目 DN

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

有效范围

-1 在条目中最大 32 位整数(其中 -1 代表无限)

默认值

5000

语法

整数

示例

nsslapd-rangelookthroughlimit: 5000

6.4.1.15. nsslapd-search-bypass-filter-test

如果您启用 nsslapd-search-bypass-filter-test 参数,Directory 服务器会在搜索期间构建候选列表时绕过过滤器检查。如果将参数设置为 验证,Directory 服务器将根据搜索候选条目评估过滤器。

Expand
参数描述

条目 DN

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

有效值

on | off | verify

默认值

on

语法

目录字符串

示例

nsslapd-search-bypass-filter-test: on

6.4.1.16. nsslapd-search-use-vlv-index

nsslapd-search-use-vlv-index 启用和禁用虚拟列表视图(VLV)搜索。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

on

语法

目录字符串

示例

nsslapd-search-use-vlv-index: on

本节介绍所有实例通用的全局配置属性,存储在 cn=bdb,cn=config,cn=ldbm database,cn=plugins,cn=config tree 节点上。

6.4.2.1. nsslapd-cache-autosize

此性能调优相关的属性设定数据库和条目缓存总量使用的可用内存百分比。例如,如果值设置为 10,则系统的可用 RAM 的 10% 都用于两个缓存。如果将此值设置为大于 0 的值,则会为数据库和条目缓存启用自动大小。

为了优化性能,红帽建议不要禁用自动大小。然而,在某些情况下,可能需要禁用自动大小。在这种情况下,将 nsslapd-cache-autosize 属性设置为 0 并手动设置:

  • nsslapd-dbcachesize 属性中的数据库缓存。
  • nsslapd-cachememsize 属性中的条目缓存。
注意

如果 nsslapd-cache-autosizensslapd-cache-autosize-split 属性都设置为高值,如 100,目录服务器将无法启动。要解决这个问题,请将这两个参数都设置为更合理的值。例如:

nsslapd-cache-autosize: 10
nsslapd-cache-autosize-split: 40
Copy to Clipboard Toggle word wrap
Expand
参数描述

条目 DN

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

有效范围

0 到 100。如果设置了 0,则使用默认值。

默认值

10

语法

整数

示例

nsslapd-cache-autosize: 10

6.4.2.2. nsslapd-cache-autosize-split

此性能调优相关的属性设定用于数据库缓存的 RAM 百分比。剩余百分比用于条目缓存。例如,如果值设为 40,数据库缓存使用 40%,并且条目缓存缓存在 nsslapd-cache-autosize 属性中保留的空闲 RAM 的剩余 60%。

注意

如果 nsslapd-cache-autosizensslapd-cache-autosize-split 属性都设置为高值,如 100,目录服务器将无法启动。要解决这个问题,请将这两个参数都设置为更合理的值。例如:

nsslapd-cache-autosize: 10
nsslapd-cache-autosize-split: 40
Copy to Clipboard Toggle word wrap
Expand
参数描述

条目 DN

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

有效范围

0 到 99。如果设置了 0,则使用默认值。

默认值

40

语法

整数

示例

nsslapd-cache-autosize-split: 40

6.4.2.3. nsslapd-dbcachesize

此性能调优相关的属性指定数据库索引缓存大小(以字节为单位)。这是控制目录服务器使用的物理 RAM 最重要的值之一。

这不是条目缓存。这是 Berkeley 数据库后端将用来缓存索引( .db 文件)和其他文件的内存量。这个值被传递给 Berkeley DB API 功能 set_cachesize。如果激活自动缓存调整大小,当服务器在服务器启动后续阶段将这些值替换为自己的猜测值时,此属性会被覆盖。

有关此属性的更多信息,请参阅 Berkeley DB 参考指南的缓存大小部分:https://docs.oracle.com/cd/E17076_04/html/programmer_reference/general_am_conf.html#am_conf_cachesize。

对于 32 位签名的整数,尝试设置不是数字或太大的值会返回 LDAP_UNWILLING_TO_PERFORM 错误消息,并解释此问题的额外错误消息。

注意

不要手动设置数据库缓存大小。红帽建议使用数据库缓存自动大小功能来优化性能。

必须重新启动服务器,才能使此属性的更改生效。

Expand
参数描述

条目 DN

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

有效范围

32 位平台 500 KB 到 4GB,64 位平台为 500 KB 到 2^641

默认值

 

语法

整数

示例

nsslapd-dbcachesize: 10000000

6.4.2.4. nsslapd-db-checkpoint-interval

这会设定目录服务器向数据库事务日志发送检查点条目的时间(以秒为单位)。数据库事务日志包含所有最新数据库操作的连续列表,仅用于数据库恢复。checkpoint 条目表示已将哪些数据库操作物理写入目录数据库。checkpoint 条目用于确定数据库事务日志中在系统失败后开始恢复的位置。dse.ldif 中缺少 nsslapd-db-checkpoint-interval 属性。要更改检查点间隔,请将属性添加到 dse.ldif。可以使用 ldapmodify 动态修改此属性。

此属性仅用于系统修改/无关,仅应在红帽技术支持或红帽咨询指导下更改。此属性和其他配置属性的设置不一致可能会导致目录服务器不稳定。

Expand
参数描述

条目 DN

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

有效范围

10 到 300 秒

默认值

60

语法

整数

示例

nsslapd-db-checkpoint-interval: 120

6.4.2.5. nsslapd-db-circular-logging

此属性为事务日志文件指定循环日志记录。如果此属性关闭,旧的事务日志文件不会被删除,并被重命名为旧的日志事务文件。关闭环形日志记录会严重降低服务器性能,因此只有红帽技术支持或红帽咨询的指导才应修改。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

on

语法

DirectoryString

示例

nsslapd-db-circular-logging: on

6.4.2.6. nsslapd-db-debug

此属性指定是否向目录服务器报告额外的错误信息。要报告错误信息,请在 上将 参数设置为。此参数用于故障排除;启用该参数可能会减慢目录服务器的速度。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

off

语法

DirectoryString

示例

nsslapd-db-debug: off

6.4.2.7. nsslapd-db-durable-transactions

此属性设定数据库事务日志条目是否立即写入磁盘。数据库事务日志包含所有最新数据库操作的连续列表,仅用于数据库恢复。启用持久事务后,每个目录更改将始终在日志文件中记录,因此可以在系统失败时恢复。但是,持久化事务功能也会降低目录服务器的性能。当禁用持久事务时,所有事务在逻辑上写入数据库事务日志,但可能无法立即写入磁盘。如果在目录更改物理上写入磁盘前系统出现故障,则该更改将无法被恢复。dse.ldif 中缺少 nsslapd-db-durable-transactions 属性。要禁用持久事务,请将属性添加到 dse.ldif

此属性仅用于系统修改/无关,仅应在红帽技术支持或红帽咨询指导下更改。此属性和其他配置属性的设置不一致可能会导致目录服务器不稳定。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

on

语法

DirectoryString

示例

nsslapd-db-durable-transactions: on

6.4.2.8. nsslapd-db-compactdb-interval

nsslapd-db-compactdb-interval 属性定义目录服务器压缩数据库和复制更改日志时的时间间隔(以秒为单位)。紧凑操作会将未使用的页面返回到文件系统和数据库文件大小缩小。

请注意,紧凑数据库是资源密集型,不应经常进行。

属性更改不需要服务器重启。但是,Directory 服务器从您更改值的时间计算新间隔值。例如,今天的压缩计划为 10:40。然后,在计划压缩前 10:35, 5 分钟,将新间隔(nsslapd-db-compactdb-interval)设置为 259200 秒(3 天)和新的压缩时间(nsslapd-db-compactdb-time)设为 20:30。现在,目录服务器在 10:40 中丢弃计划压缩,并在 20:30 天执行下一个压缩。

Expand
参数描述

条目 DN

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

有效值

0 (无压缩)到 2147483647 秒

默认值

2592000 (30 天)

语法

整数

示例

nsslapd-db-compactdb-interval: 2592000

6.4.2.9. nsslapd-db-compactdb-time

nsslapd-db-compactdb-time 属性设置目录服务器压缩所有数据库及其复制更改日志的时间。超过压缩间隔后运行压缩任务(nsslapd-db-compactdb-interval)。

属性更改不需要服务器重启。但是,当 nsslapd-db-compactdb-interval 中设置压缩间隔过期时,Directory 服务器会应用新的时间值。例如,今天的压缩计划为 10:40。然后,在计划压缩前 10:35, 5 分钟,将新间隔(nsslapd-db-compactdb-interval)设置为 259200 秒(3 天)和新的压缩时间(nsslapd-db-compactdb-time)设为 20:30。现在,目录服务器在 10:40 中丢弃计划压缩,并在 20:30 天执行下一个压缩。

Expand
参数描述

条目 DN

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

有效值

H:MM.时间以 24 小时格式设置

默认值

23:59

语法

DirectoryString

示例

nsslapd-db-compactdb-time: 23:59

6.4.2.10. nsslapd-db-home-directory

这个参数指定目录服务器数据库的内存映射文件的位置。出于性能考虑,此参数的默认值指的是使用 tmpfs 文件系统的 /dev/shm/ 目录。

Expand
参数描述

条目 DN

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

有效值

任何有效目录

默认值

/dev/shm/

语法

DirectoryString

Example

nsslapd-db-home-directory: /dev/shm/

6.4.2.11. nsslapd-db-idl-divisor

此属性按每个数据库页面的块数量来指定索引块大小。块大小是通过将数据库页大小除以此属性的值来计算的。值 1 使块大小等于页大小。默认值 0 将块大小设置为页大小减去了内部数据库开销的估算。对于大多数安装,除非有特定的调整需要,否则不应更改默认值。

在修改此属性的值之前,请使用 db2ldif 脚本导出所有数据库。完成修改后,使用 ldif2db 脚本重新加载数据库。

警告

这个参数应该只被非常高级的用户使用。

Expand
参数描述

条目 DN

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

有效范围

0 到 8

默认值

0

语法

整数

示例

nsslapd-db-idl-divisor: 2

6.4.2.12. nsslapd-db-locks

目录服务器中的锁定机制控制目录服务器进程可以同时运行多少个副本。nsslapd-db-locks 参数设置最大锁定数。

只有在 Directory 服务器没有锁定并且日志 libdb: Lock 表没有可用的锁定错误消息时,才会将 这个参数设置为更高的值。如果您在不需要设置更高的值,这会增加 /var/lib/dirsrv/slapd-instance_name/db__db decisions 文件的大小,而无需任何好处。

必须重启该服务才能使此属性生效。

Expand
参数描述

条目 DN

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

有效范围

0 - 2147483647

默认值

10000

语法

整数

示例

nsslapd-db-locks: 10000

6.4.2.13. nsslapd-db-locks-monitoring-enabled

不使用数据库锁定可能会导致数据崩溃。使用 nsslapd-db-locks-monitoring-enabled 参数,您可以启用或禁用数据库锁定监控。如果启用了该参数(这是默认设置),如果活跃数据库锁定的数量高于 nsslapd-db-locks-monitoring-threshold 中配置的百分比阈值,则目录服务器会终止所有搜索。如果出现问题,管理员可以在 nsslapd-db-locks 参数中增加数据库锁定的数量。

重启该服务以使更改生效。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

on

语法

DirectoryString

Example

nsslapd-db-locks-monitoring-enabled: on

6.4.2.14. nsslapd-db-locks-monitoring-pause

如果在 nsslapd-db-locks-monitoring-enable 参数中启用了数据库锁定,nsslapd-db-locks-monitoring-pause 会定义监控线程在检查之间休眠的时间间隔,以毫秒为单位。

如果将此参数设置为过高的值,服务器可以在监控检查发生前耗尽数据库锁定。但是,设置太低的值可能会减慢服务器的速度。

您不必重新启动服务器才能使此设置生效。

Expand
参数描述

条目 DN

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

有效值

0 - 2147483647 (以毫秒为单位的值)

默认值

500

语法

DirectoryString

示例

nsslapd-db-locks-monitoring-pause: 500

6.4.2.15. nsslapd-db-locks-monitoring-threshold

如果在 nsslapd-db-locks-monitoring-enable 参数中启用了数据库锁定,nsslapd-db-locks-monitoring-threshold 会在 Directory 服务器终止搜索前设置使用数据库锁定的最大百分比,以避免进一步锁定。

重启该服务以使更改生效。

Expand
参数描述

条目 DN

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

有效值

70 - 95

默认值

90

语法

DirectoryString

示例

nsslapd-db-locks-monitoring-threshold: 90

6.4.2.16. nsslapd-db-logbuf-size

此属性指定日志信息缓冲区大小。日志信息保存在内存中,直到缓冲区填满或事务提交强制将缓冲区写入到磁盘。较大的缓冲区大小可在长时间运行的事务、高度并发应用程序或事务生成大量数据的情况下显著提高吞吐量。日志信息缓冲大小是事务日志大小除以 4 个。

只有 nsslapd-db-durable-transactions 属性设置为 on 时,nsslapd-db-logbuf-size 属性才有效。

Expand
参数描述

条目 DN

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

有效范围

32k 最多 32 位整数(仅限于机器上可用内存)

默认值

32K

语法

整数

示例

nsslapd-db-logbuf-size: 32K

6.4.2.17. nsslapd-db-logdirectory

此属性指定包含数据库事务日志的目录的路径。数据库事务日志包含所有最新数据库操作的连续列表。目录服务器使用此信息在实例意外关闭后恢复数据库。

默认情况下,数据库事务日志存储在与目录数据库相同的目录中。要更新此参数,您必须手动更新 /etc/dirsrv/slapd-instance_name/dse.ldif 文件。

Expand
参数描述

条目 DN

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

有效值

任何有效的路径

默认值

 

语法

DirectoryString

示例

nsslapd-db-logdirectory: /var/lib/dirsrv/slapd-instance_name/db/

6.4.2.18. nsslapd-db-logfile-size

此属性指定日志中单个文件的最大大小(以字节为单位)。默认情况下,或者如果值设为 0, 则使用最大 10MB。最大大小是一个未签名的 4 字节值。

Expand
参数描述

条目 DN

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

有效范围

0 到未签名的 4 字节整数

默认值

10MB

语法

整数

示例

nsslapd-db-logfile-size: 10 MB

6.4.2.19. nsslapd-dbncache

此属性可以将 LDBM 缓存分成同样大小的内存。可以指定足够大的缓存,以便无法在某些构架上连续分配它们;例如,一些系统会限制进程连续分配的内存量。如果 nsslapd-dbncache01,则缓存将在内存中连续分配。如果大于 1,则缓存将划分为 ncache,平均大小为单独的内存片段。

要配置大于 4GB 的 dbcache 大小,请将 nsslapd-dbncache 属性添加到 cn=config,cn=ldbm database,cn=plugins,cn=config between the nsslapd-dbcachesizensslapd-db-logdirectory 属性行。

将此值设置为 1-quarter (1/4)内存大小(以 GB 为单位)。例如,对于 12GB 系统,将 nsslapd-dbncache 值设置为 3; 对于 8GB 系统,将其设置为 2

此属性仅用于系统修改/无关,仅应在红帽技术支持或红帽专业服务的指导下更改。此属性和其他配置属性的设置不一致可能会导致目录服务器不稳定。

必须重新启动服务器,才能使此属性的更改生效。

Expand
参数描述

条目 DN

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

有效值

1 到 4

默认值

1

语法

整数

示例

nsslapd-dbncache: 1

6.4.2.20. nsslapd-db-page-size

此属性指定用于存放数据库中项目的页面大小(以字节为单位)。最小大小为 512 字节,最大大小为 64 KB。如果没有显式设置页面大小,Directory 服务器默认为 8 KB 的页大小。更改此默认值可能会对性能有重大影响。如果页面大小太小,则会导致大量页面分割和复制,而如果页大小太大,则可能会浪费磁盘空间。

在修改此属性的值之前,请使用 db2ldif 脚本导出所有数据库。完成修改后,使用 ldif2db 脚本重新加载数据库。

Expand
参数描述

条目 DN

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

有效范围

512 字节到 64 KB

默认值

8KB

语法

整数

示例

nsslapd-db-page-size: 8KB

6.4.2.21. nsslapd-db-spin-count

此属性指定 test-and-set mutexes 应该在不阻止的情况下启动的次数。

警告

除非您对 Berkeley DB 的内部工作或被红帽支持特别告知,否则永远不会联系这个值。

默认值 0 会导致 BDB 通过乘以可用 CPU 内核数(由 nproc 实用程序或 sysconf (_SC_NPROCESSORS_ONLN) 调用来计算实际值。例如,如果处理器有 8 个逻辑内核,使此属性设置为 0 相当于将其设置为 400。无法完全关闭中断 - 如果您要尽可能减少 test-and-set mutexes 将启动的次数,如果没有阻塞,将此属性设置为 1

Expand
参数描述

条目 DN

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

有效范围

0 到 2147483647 (2^31-1)

默认值

0

语法

整数

示例

nsslapd-db-spin-count: 0

6.4.2.22. nsslapd-db-transaction-batch-max-wait

如果设置了 nsslapd-db-transaction-batch-val,则达到 set batch 值时由单独的线程清除事务。但是,如果只有几个更新,这个过程可能需要很长时间。此参数控制何时应刷新事务,独立于批处理计数。这些值以毫秒为单位定义。

警告

这个参数是实验性的。除非特别被红帽支持告知,否则请勿更改其值。

Expand
参数描述

条目 DN

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

有效范围

0 - 2147483647 (以毫秒为单位的值)

默认值

50

语法

整数

示例

nsslapd-db-transaction-batch-max-wait: 50

6.4.2.23. nsslapd-db-transaction-batch-min-wait

如果设置了 nsslapd-db-transaction-batch-val,则达到 set batch 值时由单独的线程清除事务。但是,如果只有几个更新,这个过程可能需要很长时间。此参数控制何时应独立于批处理计数单独清空事务。这些值以毫秒为单位定义。

警告

这个参数是实验性的。除非特别被红帽支持告知,否则请勿更改其值。

Expand
参数描述

条目 DN

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

有效范围

0 - 2147483647 (以毫秒为单位的值)

默认值

50

语法

整数

示例

nsslapd-db-transaction-batch-min-wait: 50

6.4.2.24. nsslapd-db-transaction-batch-val

此属性指定在提交前将批处理多少个事务。当不需要完整的事务持久性时,此属性可以提高更新的性能。可以使用 ldapmodify 动态修改此属性。

警告

设置此值将降低数据一致性,并可能导致数据丢失。这是因为,如果服务器可以在服务器刷新批处理事务前出现电源中断,则批处理中的这些事务将会丢失。

除非被红帽支持特别请求,否则不要设置这个值。

如果此属性未定义或设置为 0,则事务批处理将关闭,并且无法使用 LDAP 对此属性进行远程修改。但是,将此属性设置为大于 0 的值会导致服务器延迟提交事务,直到排队的事务数量等于属性值。大于 0 的值还允许使用 LDAP 远程修改此属性。此属性的 1 值允许使用 LDAP 远程修改属性设置,但不会批处理行为。因此,在服务器启动时,1 代表保持正常的持久性,同时允许在需要时远程打开和关闭事务批处理。请记住,此属性的值可能需要修改 nsslapd-db-logbuf-size 属性,以确保为批处理事务进行足够的日志缓冲区大小。

注意

只有 nsslapd-db-durable-transaction 属性设置为 on 时,nsslapd-db-transaction-batch-val 属性才有效。

Expand
参数描述

条目 DN

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

有效范围

0 到 30

默认值

0 (或关闭)

语法

整数

示例

nsslapd-db-transaction-batch-val: 5

6.4.2.25. nsslapd-db-trickle-percentage

此属性设置,通过将脏页面写入其后备文件,来至少在 shared-memory 池中指定页面百分比进行清理。这是为了确保页面始终可用于读取新信息,而无需等待写入。

Expand
参数描述

条目 DN

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

有效范围

0 到 100

默认值

40

语法

整数

示例

nsslapd-db-trickle-percentage: 40

6.4.2.26. nsslapd-db-verbose

此属性指定在搜索检查点、进行死锁检测和执行恢复时是否记录额外的信息和调试信息。此参数用于故障排除,启用该参数可能会减慢目录服务器的速度。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

off

语法

DirectoryString

示例

nsslapd-db-verbose: off

6.4.2.27. nsslapd-import-cache-autosize

这个与性能调优相关的属性会自动设置在基于命令行的 LDIF 文件导入过程中使用的导入缓存(importCache)的大小( ldif2db 操作)。

在目录服务器中,导入操作可以作为服务器任务运行,或者只在命令行中运行。在任务模式中,导入操作作为常规目录服务器操作运行。nsslapd-import-cache-autosize 属性允许在命令行上运行导入操作时自动将导入缓存设置为预先确定的大小。目录服务器在任务模式导入过程中也可以使用属性来分配指定的百分比用于导入缓存。

默认情况下,nsslapd-import-cache-autosize 属性被启用,并设置为 -1 的值。这个值会自动调整 ldif2db 操作的导入缓存,从而自动为导入缓存分配可用物理内存的有限百分比(50%)。百分比值(50%)被硬编码,不可更改。

将 attribute 值设置为 50 (nsslapd-import-cache-autosize: 50)在 ldif2db 操作过程中对性能有同样的影响。但是,当导入操作作为 Directory Server 任务运行时,此类设置会对性能产生同样的影响。-1 值会自动调整仅针对 ldif2db 操作(包括导入、常规目录服务器任务)的导入缓存。

注意

a -1 设置的目的是使 ldif2db 操作从空闲的物理内存中受益,但同时,不与条目缓存竞争,它不用于目录服务器的常规操作。

nsslapd-import-cache-autosize 属性设置为 0 可关闭导入缓存自动大小的功能 - 也就是说,导入操作的任何模式都不会自动进行。相反,Directory 服务器使用 nsslapd-import-cachesize 属性导入缓存大小,默认值为 20000000

目录服务器上下文中有三个缓存:数据库缓存、条目缓存和导入缓存。导入缓存仅在导入操作过程中使用。nsslapd-cache-autosize 属性用于自动调整条目缓存和数据库缓存,仅在 Directory 服务器操作过程中使用,而不在 ldif2db 命令行操作过程中使用;属性值是要为条目缓存和数据库缓存分配的空闲物理内存的百分比。

如果自动化属性、nsslapd-cache-autosizensslapd-import-cache-autosize 均已启用,请确保其 sum 小于 100。

Expand
参数描述

条目 DN

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

有效范围

-1, 0 (将导入缓存自动设置为 100)

默认值

-1 (只为 ldif2db 暂停导入缓存,并分配 50% 的空闲物理内存以导入缓存)

语法

整数

示例

nsslapd-import-cache-autosize: -1

6.4.2.28. nsslapd-search-bypass-filter-test

如果您启用 nsslapd-search-bypass-filter-test 参数,Directory 服务器会在搜索期间构建候选列表时绕过过滤器检查。如果将参数设置为 验证,Directory 服务器将根据搜索候选条目评估过滤器。

Expand
参数描述

条目 DN

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

有效值

on | off | verify

默认值

on

语法

目录字符串

示例

nsslapd-search-bypass-filter-test: on

部分涵盖了全局 Lightning Memory-Mapped Database Manager (LMDB)配置属性,这些配置存储在 cn=mdb,cn=config,cn=ldbm database,cn=plugins,cn=config tree node 中,适用于所有实例。

6.4.3.1. nsslapd-mdb-max-dbs

nsslapd-mdb-max-dbs 属性设置可包含在内存映射数据库文件中的指定数据库实例的最大数量。如果属性值设为零(0),Directory 服务器会计算此属性值。每个后缀和默认索引都使用名为 database 的 35。每个额外索引都会使用一个命名的数据库。使用默认值 512,您可以创建最多 14 后缀。

要将更改应用到属性值,您必须重启服务器。

Expand
参数描述

条目 DN

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

有效值

0-2147483647

默认值

512

语法

整数

Example

nsslapd-mdb-max-dbs: 512

6.4.3.2. nsslapd-mdb-max-readers

nsslapd-mdb-max-readers 属性设置可以同时打开的读取操作的 maximun 数量。如果属性值设为零(0),Directory 服务器会计算此属性值。

要将更改应用到属性值,您必须重启服务器。

Expand
参数描述

条目 DN

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

有效值

0-2147483647

默认值

0

语法

整数

Example

nsslapd-mdb-max-readers:0

6.4.3.3. nsslapd-mdb-max-size

nsslapd-mdb-max-size 属性以字节为单位设置数据库最大大小。Lightning Memory-Mapped Database Manager (LMDB)数据库的最大大小受系统可寻址的内存的限制。

重要

确保 nsslapd-mdb-max-size 的值足够高,以存储所有预期数据。但是,该值不能对性能造成负面影响,因为数据库文件是内存映射。您可以使用 Directory Server 硬件要求 中的数据库大小作为参考。

要将更改应用到属性值,您必须重启服务器。

Expand
参数描述

条目 DN

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

有效值

512 最大 32 位整数(仅限于机器上可用内存)

默认值

21474836480

语法

整数

Example

nsslapd-mdb-max-size:21474836480

全局只读属性,包含数据库上监控活动的数据库统计信息,存储在 cn=monitor,cn=ldbm database,cn=plugins,cn=config tree 节点上。

6.4.4.1. currentNormalizedDNcachecount

规范化缓存的 DN 数量。

6.4.4.2. currentNormalizedDNcachesize

规范化 DN 缓存的当前大小(以字节为单位)。

6.4.4.3. dbcachehitratio

此属性显示在数据库缓存中的请求页面的百分比(hits/tries)。

6.4.4.4. dbcachehits

此属性显示数据库中找到的请求页面。

6.4.4.5. dbcachepagein

此属性显示读取到数据库缓存的页面。

6.4.4.6. dbcachepageout

此属性显示从数据库缓存写入后备文件的页面。

6.4.4.7. dbcacheroevict

此属性显示从缓存中强制使用的清理页面。

6.4.4.8. dbcacherwevict

此属性显示强制从缓存中有脏页面。

6.4.4.9. dbcachetries

此属性显示缓存查找总数。

6.4.4.10. maxNormalizedDNcachesize

nsslapd-ndn-cache-max-size 参数的当前值。有关如何更新此设置的详情,请参阅 nsslapd-ndn-cache-max-size

6.4.4.11. normalizedDNcachehitratio

在缓存中找到规范化 DN 的百分比。

6.4.4.12. normalizedDNcachehits

在缓存中找到的规范化 DN。

6.4.4.13. normalizedDNcachemisses

在缓存中未找到规范化 DN。

6.4.4.14. normalizedDNcachetries

实例启动以来的缓存查找总数。

cn=database_name 子树包含用户定义的数据库的所有配置数据。

cn=userRoot 子树默认称为 userRoot。但是,这不是硬编码的,事实上会存在多个数据库实例,此名称由用户更改,并在添加新数据库时定义此名称。引用的 cn=userRoot 数据库可以是任何用户数据库。

以下属性对数据库是通用的,如 cn=userRoot

6.4.5.1. nsslapd-cachememsize

此性能调优相关的属性指定条目缓存的可用内存空间大小(以字节为单位)。最简单的方法是以占用的内存方式限制缓存大小。激活自动缓存大小会覆盖此属性,在服务器启动时用自己的猜测值替换这些值。

对于 32 位签名的整数(在 32 位系统中),尝试设置不是数字或太大的值会返回 LDAP_UNWILLING_TO_PERFORM 错误消息,并解释此问题的额外错误消息。

此设置的性能计数器会进入最高 64 位整数,即使在 32 位系统中,但由于系统地址内存的方式,在 32 位系统中设置本身也限制为最高 32 位整数。

注意

不要手动设置数据库缓存大小。红帽建议使用条目缓存自动大小功能来优化性能。

Expand
参数描述

条目 DN

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

有效范围

64位系统上的 500 KB 到 2 641

默认值

209715200 (200 MiB)

语法

整数

示例

nsslapd-cachememsize: 209715200

6.4.5.2. nsslapd-cachesize

nsslapd-cachesize 属性已弃用。要调整条目缓存的大小,请使用 nsslapd-cachememsize 属性。

此性能调优相关的属性在可保存的条目数中指定缓存大小。但是,此属性已弃用,而是使用 nsslapd-cachememsize 属性,它为条目缓存大小设置 RAM 绝对分配,如 nsslapd-cachememsize 部分所述。

对于 32 位签名的整数(在 32 位系统中),尝试设置不是数字或太大的值会返回 LDAP_UNWILLING_TO_PERFORM 错误消息,并解释此问题的额外错误消息。

必须重新启动服务器,才能使此属性的更改生效。

注意

此设置的性能计数器会进入最高 64 位整数,即使在 32 位系统中,但由于系统地址内存的方式,在 32 位系统中设置本身也限制为最高 32 位整数。

Expand
参数描述

条目 DN

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

有效范围

1 到32位系统上的 321,或 64 位系统上的 263-1,这意味着无限

默认值

-1

语法

整数

示例

nsslapd-cachesize: -1

6.4.5.3. nsslapd-directory

此属性指定数据库实例的路径。如果它是一个相对路径,它将从全局数据库条目 cn=config,cn=ldbm database,cn=plugins,cn=confignsslapd-directory 指定的路径开始。数据库实例目录以实例名称命名,默认情况下位于全局数据库目录中。创建数据库实例后,请不要修改此路径,因为任何更改风险都会阻止服务器访问数据。

Expand
参数描述

条目 DN

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

有效值

数据库实例的任何有效路径

默认值

 

语法

DirectoryString

示例

nsslapd-directory: /var/lib/dirsrv/slapd-instance/db/userRoot

6.4.5.4. nsslapd-dncachememsize

此性能调优相关的属性指定 DN 缓存的可用内存空间大小(以字节为单位)。DN 缓存与数据库的条目缓存类似,只有其表仅存储条目 ID 和条目 DN。这允许更快地查找 rename 和 moddn 操作。

最简单的方法是以占用的内存方式限制缓存大小。

对于 32 位签名的整数(在 32 位系统中),尝试设置不是数字或太大的值会返回 LDAP_UNWILLING_TO_PERFORM 错误消息,并解释此问题的额外错误消息。

注意

此设置的性能计数器会进入最高 64 位整数,即使在 32 位系统中,但由于系统地址内存的方式,在 32 位系统中设置本身也限制为最高 32 位整数。

Expand
参数描述

条目 DN

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

有效范围

32位系统上的 500 KB 到 2 321,64位系统上的 2 641

默认值

10,485,760 (10 MB)

语法

整数

示例

nsslapd-dncachememsize: 10485760

6.4.5.5. nsslapd-readonly

此属性为单个后端实例指定只读模式。如果此属性的值为 off,则用户具有其访问权限所允许的读取、写入和执行权限。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

off

语法

DirectoryString

示例

nsslapd-readonly: off

6.4.5.6. nsslapd-require-index

切换到 上的 时,此属性允许一个拒绝未索引的搜索。此与性能相关的属性可避免服务器出现错误搜索的饱和。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

off

语法

DirectoryString

示例

nsslapd-require-index: off

6.4.5.7. nsslapd-require-internalop-index

当插件修改数据时,它在数据库中有一个写入锁定。在大型数据库中,如果插件随后执行未索引的搜索,该插件可以使用所有数据库锁定并损坏数据库,或者服务器变得无响应。要避免这个问题,您可以通过启用 nsslapd-require-internalop-index 参数来拒绝内部未索引的搜索。

Expand
参数描述

条目 DN

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

有效值

on | off

默认值

off

语法

DirectoryString

示例

nsslapd-require-internalop-index: off

6.4.5.8. nsslapd-suffix

此属性指定数据库链接的后缀。这是一个单值属性,因为每个数据库实例只能有一个后缀。在以前的版本中,在单个数据库实例上可以有多个后缀,但这不再是这种情况。因此,此属性为单值,用于强制每个数据库实例只能有一个后缀条目。只有在创建条目后对此属性所做的任何更改仅在包含数据库链接的服务器重启后生效。

Expand
参数描述

条目 DN

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

有效值

任何有效的 DN

默认值

 

语法

DirectoryString

示例

nsslapd-suffix: o=Example

6.4.5.9. vlvBase

此属性设置创建浏览或虚拟列表视图(VLV)索引的基本 DN。

Expand
参数描述

条目 DN

cn=index_name,cn=userRoot,cn=ldbm database,cn=plugins,cn=config

有效值

任何有效的 DN

默认值

 

语法

DirectoryString

示例

vlvBase: ou=People,dc=example,dc=com

6.4.5.10. vlvEnabled

vlvEnabled 属性提供有关特定 VLV 索引的状态信息,而 Directory 服务器在运行时设置此属性。虽然配置中显示 vlvEnabled,但您无法修改此属性。

Expand
参数描述

条目 DN

cn=index_name,cn=userRoot,cn=ldbm database,cn=plugins,cn=config

有效值

0 (禁用)| 1 (启用)

默认值

1

语法

DirectoryString

示例

vlvEnbled: 0

6.4.5.11. vlvFilter

浏览或虚拟列表视图(VLV)索引是通过根据过滤器运行搜索来创建的,并在索引中包含与该过滤器匹配的条目。过滤器在 vlvFilter 属性中指定。

Expand
参数描述

条目 DN

cn=index_name,cn=userRoot,cn=ldbm database,cn=plugins,cn=config

有效值

任何有效的 LDAP 过滤器

默认值

 

语法

DirectoryString

Example

vlvFilter: (|(objectclass=*)(objectclass=ldapsubentry))

6.4.5.12. vlvIndex

浏览索引 或虚拟列表视图(VLV)索引 会动态生成条目标头的缩写索引,从而可以更快地浏览大型索引。VLV 索引定义有两个部分:一个定义索引,它定义了用于标识要添加到索引中的条目的搜索。vlvIndex 对象类定义索引条目。

此对象类在 Directory Server 中定义。

卓越的类

top

OID

2.16.840.1.113730.3.2.42

Expand
表 6.2. 所需属性
属性定义

objectClasses

定义条目的对象类。

cn (commonName)

提供条目的通用名称。

vlvSort

标识浏览索引(虚拟列表视图索引)所排序的属性列表。

Expand
表 6.3. 允许的属性
属性定义

vlvEnabled

存储浏览索引的可用性。

vlvUses

包含使用浏览索引的数量。

6.4.5.13. vlvScope

此属性设置搜索范围,以针对浏览或虚拟列表视图(VLV)索引中的条目运行。

Expand
参数描述

条目 DN

cn=pass:_index_name_,cn=userRoot,cn=ldbm database,cn=plugins,cn=config

有效值

* 1 (一个级别或子搜索)

* 2 (subtree search)

默认值

 

语法

整数

示例

vlvScope: 2

6.4.5.14. vlvSearch

浏览索引 或虚拟列表视图(VLV)索引 会动态生成条目标头的缩写索引,从而可以更快地浏览大型索引。VLV 索引定义有两个部分:一个定义索引,它定义了用于标识要添加到索引中的条目的搜索。vlvSearch 对象类定义搜索过滤器条目。

此对象类在 Directory Server 中定义。

卓越的类

top

OID

2.16.840.1.113730.3.2.38

Expand
表 6.4. 所需属性
属性定义

objectClasses

定义条目的对象类。

vlvBase

标识创建浏览索引的基本 DN。

vlvScope

标识要定义浏览索引的范围。

vlvFilter

标识用于定义浏览索引的过滤器字符串。

Expand
表 6.5. 允许的属性
属性定义

multiLineDescription

提供条目的文本描述。

6.4.5.15. vlvSort

此属性为浏览或虚拟列表视图(VLV)索引中的返回条目设置排序顺序。

注意

此属性的条目是 vlvSearch 条目下的 vlvIndex 条目。

Expand
参数描述

条目 DN

cn=index_name,cn=index_name,cn=userRoot,cn=ldbm database,cn=plugins,cn=config

有效值

任何目录服务器属性,以空格分隔

默认值

 

语法

DirectoryString

示例

vlvSort: cn givenName o ou sn

6.4.5.16. vlvUses

vlvUses 属性包含浏览索引使用的计数,而 Directory 服务器在运行时设置此属性。虽然配置中显示 vlvUses,但您无法修改此属性。

Expand
参数描述

条目 DN

cn=index_name,cn=userRoot,cn=ldbm database,cn=plugins,cn=config

有效值

N/A

默认值

 

语法

DirectoryString

示例

vlvUses:800

此树节点条目中的属性都是只读的、数据库性能计数器。这些属性的所有值都是 32 位整数,但 entrycachehitsentrycachetries 除外。

如果在 上将 cn=config 中的 nsslapd-counters 属性设置为,那么 Directory Server 实例使用 64 位整数保留的一些计数器使用 64 位整数,即使在 32 位机器上或使用 32 位目录服务器版本。对于数据库监控,entrycachehitsentrycachetries 计数器使用 64 位整数。

注意

nsslapd-counters 属性启用对这些特定数据库和服务器计数器的 64 位支持。使用 64 位整数的计数器不可配置;对于所有允许的计数器,可启用 64 位整数,或为所有允许的计数器禁用 64 位整数。

6.4.6.1. currentdncachecount

此属性显示 DN 缓存中当前存在的 DN 数量。

6.4.6.2. currentdncachesize

此属性显示 DN 缓存中当前存在的 DN 的总大小(以字节为单位)。

6.4.6.3. maxdncachesize

此属性显示可在数据库 DN 缓存中维护的 DN 的最大大小(以字节为单位)。

6.4.6.4. nsslapd-db-abort-rate

此属性显示已中止的事务数量。

6.4.6.5. nsslapd-db-active-txns

此属性显示当前活跃的事务数量。

6.4.6.6. nsslapd-db-cache-hit

此属性显示缓存中找到的请求页面。

6.4.6.7. nsslapd-db-cache-region-wait-rate

此属性显示在获取区域锁定前强制等待的控制线程的次数。

6.4.6.8. nsslapd-db-cache-size-bytes

此属性显示缓存的总大小(以字节为单位)。

6.4.6.9. nsslapd-db-cache-try

此属性显示缓存查找总数。

6.4.6.10. nsslapd-db-clean-pages

此属性显示当前在缓存中的清理页面。

6.4.6.11. nsslapd-db-commit-rate

此属性显示已提交的事务数量。

6.4.6.12. nsslapd-db-deadlock-rate

此属性显示检测到的死锁数量。

6.4.6.13. nsslapd-db-dirty-pages

此属性显示当前缓存中的脏页面。

6.4.6.14. nsslapd-db-hash-buckets

此属性显示缓冲区散列表中哈希 bucket 的数量。

6.4.6.15. nsslapd-db-hash-elements-examine-rate

此属性显示哈希表查找过程中遍历的 hash 元素总数。

6.4.6.16. nsslapd-db-hash-search-rate

此属性显示缓冲区哈希表查找的总数。

6.4.6.17. nsslapd-db-lock-conflicts

此属性显示因为冲突而无法立即可用的锁定总数。

6.4.6.18. nsslapd-db-lockers

此属性显示当前锁定者的数量。

6.4.6.19. nsslapd-db-lock-region-wait-rate

此属性显示在获取区域锁定前强制等待的控制线程的次数。

6.4.6.20. nsslapd-db-lock-request-rate

此属性显示请求的锁定总数。

6.4.6.21. nsslapd-db-log-bytes-since-checkpoint

此属性显示自上次检查点以来写入此日志的字节数。

6.4.6.22. nsslapd-db-log-region-wait-rate

此属性显示在获取区域锁定前强制等待的控制线程的次数。

6.4.6.23. nsslapd-db-log-write-rate

此属性显示写入此日志的 MB 和字节数。

6.4.6.24. nsslapd-db-longest-chain-length

此属性显示在缓冲区哈希表查找中遇到的最大链。

6.4.6.25. nsslapd-db-page-create-rate

此属性显示缓存中创建的页面。

6.4.6.26. nsslapd-db-page-read-rate

此属性显示读取到缓存的页面。

6.4.6.27. nsslapd-db-page-ro-evict-rate

此属性显示从缓存中强制使用的清理页面。

6.4.6.28. nsslapd-db-page-rw-evict-rate

此属性显示强制从缓存中有脏页面。

6.4.6.29. nsslapd-db-pages-in-use

此属性显示当前正在使用的页面(清理或脏)。

6.4.6.30. nsslapd-db-page-trickle-rate

此属性显示使用 memp_trickle 接口编写的脏页面。

6.4.6.31. nsslapd-db-page-write-rate

此属性显示读取到缓存的页面。

6.4.6.32. nsslapd-db-txn-region-wait-rate

此属性显示线程控制在获取区域锁定前等待的次数。

在 multi-supplier 复制中,Directory 服务器在 cn=changelog,cn=database_name,cn=ldbm database,cn=plugins,cn=config 条目下存储 changelog 配置条目,其具有 topextensibleObject 对象类。

注意

术语 changelog 可以引用:

变更日志
使用本章中描述的属性的多层次复制中的实际更改日志。
retro Changelog
目录服务器用于与某些传统应用程序兼容的插件。如需更多信息,请参阅 Retro changelog 插件

6.4.7.1. cn

cn 属性设置 changelog 条目的相对可分辨名称(RDN)。此属性是必需的。

Expand
参数描述

条目 DN

cn=changelog,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效值

任何字符串

默认值

changelog

语法

DirectoryString

Example

cn=changelog,cn=userRoot,cn=ldbm database,cn=plugins

6.4.7.2. nsslapd-changelogmaxage

与消费者同步时,目录服务器将每个更新存储在更改日志中,并带有一个时间戳。nsslapd-changelogmaxage 属性设置存储在 changelog 中的记录的最长期限。目录服务器自动删除成功传输到所有消费者的旧记录。默认情况下,Directory 服务器会删除 7 天以上的记录。但是,如果您禁用 nsslapd-changelogmaxagensslapd-changelogmaxentries 属性,目录服务器会将所有记录保留在更改日志中,并可能导致 changelog 文件的过度增长。

注意

retro changelog 有自己的 nsslapd-changelogmaxage 属性。如需更多信息,请参阅 Retro changelog nsslapd-changelogmaxage

属性更改不需要服务器重启,但更改会在根据 nsslapd-changelogtrim-interval 属性调度的 trim 操作后生效。

Expand
参数描述

条目 DN

cn=changelog,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效范围

0 (条目不会根据其年龄删除)最多 32 位整数(2147483647)

默认值

7d

语法

DirectoryString IntegerAgeID,其中 AgeID 为:

  • s (S) (秒)
  • M (M)分钟
  • H (H)小时
  • D(D)表示天数
  • W (W)周

如果您只设置没有 AgeID 的整数值,则 Directory Server 将它取为秒。

Example

nsslapd-changelogmaxage: 30d

6.4.7.3. nsslapd-changelogmaxentries

nsslapd-changelogmaxentries 属性设置 changelog 中存储的记录的最大数量。如果成功传输到所有消费者的最旧记录数量超过 nsslapd-changelogmaxentries 值,则目录服务器会自动从更改日志中删除这些记录。如果将 nsslapd-changelogmaxentriesnsslapd-changelogmaxage 属性设置为 0,目录服务器会将所有记录保留在 changelog 中,这可能会导致 changelog 文件的过度增长。

注意

如果您在 nsslapd-changelogmaxentries 属性中设置了较低值,则目录服务器不会自动减少复制更改日志的文件大小。

属性更改不需要服务器重启,但更改会在根据 nsslapd-changelogtrim-interval 属性调度的 trim 操作后生效。

Expand
参数描述

条目 DN

cn=changelog,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效范围

0 (唯一最大限制是磁盘大小)最大 32 位整数(2147483647)

默认值

0

语法

整数

示例

nsslapd-changelogmaxentries: 5000

6.4.7.4. nsslapd-changelogtrim-interval

目录服务器在 changelog 上重复运行修剪过程。要更改两个运行之间的时间,请更新 nsslapd-changelogtrim-interval 属性并设置间隔(以秒为单位)。

属性更改不需要服务器重启,但更改会在修剪操作后生效。

Expand
参数描述

条目 DN

cn=changelog,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效范围

0 到最大 32 位整数值(2147483647)

默认值

300 (5 分钟)

语法

DirectoryString

示例

nsslapd-changelogtrim-interval: 300

6.4.7.5. nsslapd-encryptionalgorithm

nsslapd-encryptionalgorithm 属性指定 Directory 服务器用于 changelog 加密的加密算法。要启用 changelog 加密,您必须在目录服务器中安装服务器证书。

您必须重启服务器以应用属性值更改。

Expand
参数描述

条目 DN

cn=changelog,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效范围

AES 或 3DES

默认值

语法

DirectoryString

示例

nsslapd-encryptionalgorithm: AES

6.4.7.6. nsSymmetricKey

nsSymmetricKey 属性存储内部生成的对称密钥。

您必须重启服务器以应用属性值更改。

Expand
参数描述

条目 DN

cn=changelog,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效范围

基本 64 编码的密钥

默认值

None

语法

DirectoryString

示例

None

此树节点条目中的属性都是只读的、数据库性能计数器。

如果在 上将 cn=config 中的 nsslapd-counters 属性设置为,那么 Directory Server 实例使用 64 位整数保留的一些计数器使用 64 位整数,即使在 32 位机器上或使用 32 位目录服务器版本。对于数据库监控,entrycachehitsentrycachetries 计数器使用 64 位整数。

注意

nsslapd-counters 属性启用对这些特定数据库和服务器计数器的 64 位支持。使用 64 位整数的计数器不可配置;对于所有允许的计数器,可启用 64 位整数,或为所有允许的计数器禁用 64 位整数。

6.4.8.1. currentDNcachecount

缓存的 DN 数量。

6.4.8.2. currentDNcachesize

DN 缓存的当前大小(以字节为单位)。

6.4.8.3. dbfilecachehit-number

此属性给出执行此文件数据的搜索次数,并且数据从缓存中成功获取。此属性名称中的数字对应于 dbfilename 中的数字。

6.4.8.4. dbfilecachemiss-number

此属性提供执行此文件数据的搜索数量,并且无法从缓存中获取数据。此属性名称中的数字对应于 dbfilename 中的数字。

6.4.8.5. dbfilename-number

此属性提供文件的名称,并为该文件提供顺序整数标识符(从 0 开始)。文件的所有关联统计数据都会获得同样的数字标识符。

6.4.8.6. dbfilepagein-number

此属性提供此文件中放入缓存的页面数量。此属性名称中的数字对应于 dbfilename 中的数字。

6.4.8.7. dbfilepageout-number

此属性提供从缓存写入到磁盘的此文件的页面数。此属性名称中的数字对应于 dbfilename 中的数字。

6.4.8.8. DNcachehitratio

缓存中找到的 DN 的百分比。

6.4.8.9. DNcachehits

在缓存中找到的 DNS。

6.4.8.10. DNcachemisses

在缓存中没有找到 DNS。

6.4.8.11. DNcachetries

实例启动以来的缓存查找总数。

6.4.8.12. maxDNcachesize

nsslapd-ndn-cache-max-size 参数的当前值。有关如何更新此设置的详情,请参阅 nsslapd-ndn-cache-max-size

默认索引集合存储在此处。默认索引会按后端配置,以针对大多数设置场景优化目录服务器功能。除系统基本索引外,所有索引都可以删除,但应小心谨慎,以免造成不必要的中断。

6.4.9.1. cn

此属性提供要索引的属性的名称。

Expand
参数描述

条目 DN

cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config

有效值

任何有效的索引 cn

默认值

语法

DirectoryString

示例

cn: aci

6.4.9.2. nsIndex

此对象类在后端数据库中定义一个索引。此对象在 Directory Server 中定义。

卓越的类

top

OID

2.16.840.1.113730.3.2.44

Expand
表 6.6. 所需属性
属性定义

objectClasses

定义条目的对象类。

cn (commonName)

提供条目的通用名称。

nsSystemIndex

确定索引是否为系统定义的索引。

Expand
表 6.7. 允许的属性
属性定义

description

提供条目的文本描述。

nsIndexType

标识索引类型。

nsMatchingRule

标识匹配的规则。

6.4.9.3. nsIndexType

此可选, multi-valued 属性指定 Directory Server 操作的索引类型,并取要索引的属性值。必须在单独的行中输入每个所需的索引类型。

Expand
参数描述

条目 DN

cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config

有效值

* pres = 存在索引

* EQ = 平等索引

* Approx = 大约索引

* sub = 子字符串索引

* 匹配规则 = 国际索引

* index browse = 浏览索引

默认值

 

语法

DirectoryString

示例

nsIndexType: eq

6.4.9.4. nsMatchingRule

此可选,multi-valued 属性指定用于匹配值和为属性生成索引键的排序匹配规则名称或 OID。这最常用于确保对英语(7-bit ASCII)以外的语言正确搜索相同和范围。

这也用于允许范围搜索正常工作,对于在架构定义中没有指定排序匹配规则的整数语法属性。uidNumbergidNumber 是两个常用的两个属性,它们属于这个类别。

例如,对于使用整数语法的 uidNumber,rule 属性可以是 nsMatchingRule: integerOrderingMatch

注意

在保存更改并且使用 db2index 命令重新构建索引之前,对此属性的任何更改都不会生效。

Expand
参数描述

条目 DN

cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config

有效值

任何有效的 collation order 对象标识符(OID)

默认值

语法

DirectoryString

示例

nsMatchingRule: 2.16.840.1.113730.3.3.2.3.1 (For Bulgarian)

6.4.9.5. nsSystemIndex

此强制属性指定索引是否为 系统索引,这是一个对目录服务器操作至关重要的索引。如果此属性的值为 true,则代表 system-essential。系统索引不应被删除,因为这会严重破坏服务器功能。

Expand
参数描述

条目 DN

cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config

有效值

true | false

默认值

 

语法

DirectoryString

示例

nssystemindex: true

除了 cn=default index,cn= config,cn=ldbm database,cn=plugins,cn=config 中保存的默认 索引集合外,可以为用户定义的后端实例创建自定义索引;它们存储在 cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config.

例如,o=UserRoot 下的 aci 属性的索引文件会出现在 Directory Server 中,如下所示:

dn:cn=aci,cn=index,cn=UserRoot,cn=ldbm database,cn=plugins,cn=config
objectclass:top
objectclass:nsIndex
cn:aci
nsSystemIndex:true
nsIndexType:pres
Copy to Clipboard Toggle word wrap

这些条目共享 cn=default index,cn=config ,cn=ldbm database,cn=plugins,cn=config 下为默认索引属性 列出的所有索引属性。

6.4.10.1. nsIndexIDListScanLimit

这个多值参数定义了特定索引的搜索限制,或者不使用 ID 列表。

Expand
参数描述

条目 DN

cn=attribute_name,cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效值

 

默认值

 

语法

DirectoryString

示例

nsIndexIDListScanLimit: limit=0 type=eq values=inetorgperson

6.4.10.2. nsSubStrBegin

默认情况下,要索引搜索,搜索字符串必须至少有三个字符,而无需计算任何通配符字符。例如,字符串 abc 将是一个索引的搜索,而 ab* 不是一个索引的搜索。索引的搜索比未索引搜索要快,因此更改搜索键的最小长度有助于增加索引搜索数量。

根据任何通配符字符的位置,可以编辑此子字符串长度。nsSubStrBegin 属性设置索引字符串开头所需的字符数,在通配符之前。例如:

abc*
Copy to Clipboard Toggle word wrap

如果更改了此属性的值,则必须使用 db2index 重新生成索引。

Expand
参数描述

条目 DN

cn=attribute_name,cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效值

任何整数

默认值

3

语法

整数

示例

nsSubStrBegin: 2

6.4.10.3. nsSubStrEnd

默认情况下,要索引搜索,搜索字符串必须至少有三个字符,而无需计算任何通配符字符。例如,字符串 abc 将是一个索引的搜索,而 ab* 不是一个索引的搜索。索引的搜索比未索引搜索要快,因此更改搜索键的最小长度有助于增加索引搜索数量。

根据任何通配符字符的位置,可以编辑此子字符串长度。nsSubStrEnd 属性在通配符后设置索引搜索结尾的字符数。例如:

*xyz
Copy to Clipboard Toggle word wrap

如果更改了此属性的值,则必须使用 db2index 重新生成索引。

Expand
参数描述

条目 DN

cn=attribute_name,cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效值

任何整数

默认值

3

语法

整数

示例

nsSubStrEnd: 2

6.4.10.4. nsSubStrMiddle

默认情况下,要索引搜索,搜索字符串必须至少有三个字符,而无需计算任何通配符字符。例如,字符串 abc 将是一个索引的搜索,而 ab* 不是一个索引的搜索。索引的搜索比未索引搜索要快,因此更改搜索键的最小长度有助于增加索引搜索数量。

根据任何通配符字符的位置,可以编辑此子字符串长度。nsSubStrMiddle 属性设置索引搜索所需的字符数,其中搜索字符串中间使用通配符。例如:

ab*z
Copy to Clipboard Toggle word wrap

如果更改了此属性的值,则必须使用 db2index 重新生成索引。

Expand
参数描述

条目 DN

cn=attribute_name,cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效值

任何整数

默认值

3

语法

整数

示例

nsSubStrMiddle: 3

除了 cn=default index,cn= config,cn=ldbm database,cn=plugins,cn=config 中保存的默认 索引集合外,可以为用户定义的后端实例创建自定义索引;它们存储在 cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config.

例如,o=UserRoot 下的 aci 属性的索引文件会出现在 Directory Server 中,如下所示:

dn:cn=aci,cn=index,cn=UserRoot,cn=ldbm database,cn=plugins,cn=config
objectclass:top
objectclass:nsIndex
cn:aci
nsSystemIndex:true
nsIndexType:pres
Copy to Clipboard Toggle word wrap

这些条目共享 cn=default index,cn=config ,cn=ldbm database,cn=plugins,cn=config 下为默认索引属性 列出的所有索引属性。

6.4.11.1. nsIndexIDListScanLimit

这个多值参数定义了特定索引的搜索限制,或者不使用 ID 列表。

Expand
参数描述

条目 DN

cn=attribute_name,cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效值

 

默认值

 

语法

DirectoryString

示例

nsIndexIDListScanLimit: limit=0 type=eq values=inetorgperson

6.4.11.2. nsSubStrBegin

默认情况下,要索引搜索,搜索字符串必须至少有三个字符,而无需计算任何通配符字符。例如,字符串 abc 将是一个索引的搜索,而 ab* 不是一个索引的搜索。索引的搜索比未索引搜索要快,因此更改搜索键的最小长度有助于增加索引搜索数量。

根据任何通配符字符的位置,可以编辑此子字符串长度。nsSubStrBegin 属性设置索引字符串开头所需的字符数,在通配符之前。例如:

abc*
Copy to Clipboard Toggle word wrap

如果更改了此属性的值,则必须使用 db2index 重新生成索引。

Expand
参数描述

条目 DN

cn=attribute_name,cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效值

任何整数

默认值

3

语法

整数

示例

nsSubStrBegin: 2

6.4.11.3. nsSubStrEnd

默认情况下,要索引搜索,搜索字符串必须至少有三个字符,而无需计算任何通配符字符。例如,字符串 abc 将是一个索引的搜索,而 ab* 不是一个索引的搜索。索引的搜索比未索引搜索要快,因此更改搜索键的最小长度有助于增加索引搜索数量。

根据任何通配符字符的位置,可以编辑此子字符串长度。nsSubStrEnd 属性在通配符后设置索引搜索结尾的字符数。例如:

*xyz
Copy to Clipboard Toggle word wrap

如果更改了此属性的值,则必须使用 db2index 重新生成索引。

Expand
参数描述

条目 DN

cn=attribute_name,cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效值

任何整数

默认值

3

语法

整数

示例

nsSubStrEnd: 2

6.4.11.4. nsSubStrMiddle

默认情况下,要索引搜索,搜索字符串必须至少有三个字符,而无需计算任何通配符字符。例如,字符串 abc 将是一个索引的搜索,而 ab* 不是一个索引的搜索。索引的搜索比未索引搜索要快,因此更改搜索键的最小长度有助于增加索引搜索数量。

根据任何通配符字符的位置,可以编辑此子字符串长度。nsSubStrMiddle 属性设置索引搜索所需的字符数,其中搜索字符串中间使用通配符。例如:

ab*z
Copy to Clipboard Toggle word wrap

如果更改了此属性的值,则必须使用 db2index 重新生成索引。

Expand
参数描述

条目 DN

cn=attribute_name,cn=index,cn=database_name,cn=ldbm database,cn=plugins,cn=config

有效值

任何整数

默认值

3

语法

整数

示例

nsSubStrMiddle: 3

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat