附录 D 使用 LDAP 数据高速缓存

本附录介绍 Sun ONE Calendar Server LDAP 数据高速缓存，高速缓存可以确保 LDAP 数据在提交后立即可用，即使 LDAP 目录服务器被配置为数据在提交一段后才可用。本附录包含以下主题：

使用 LDAP 数据高速缓存的注意事项

按照以下原则决定您的站点是否需要配置 LDAP 数据高速缓存：

主/从 LDAP 配置

主/从 LDAP 配置包含一个主 (root) 目录服务器和一个或多个从属（用户或拷贝）目录服务器。Calendar Server 可直接（或通过从属目录服务器）访问主 LDAP 目录服务器：

在上述第二种配置中，由于提交的数据需要经过一段延迟方可在从属目录服务器上可用，因此可能会出现 LDAP 数据不准确的问题。

例如，Calendar Server 提交了 LDAP 数据更改，但由于主目录服务器更新每个从属目录服务器而造成延迟，导致新数据在一段时间后才可用。随后的 Calendar Server 客户端操作使用旧 LDAP 数据并显示旧视图。

如果更新从属目录服务器的延迟较短（只有几秒钟），客户端可能不会出现问题。然而，如果延迟较长（几分钟或几小时），客户端在延迟过程中将显示不准确的 LDAP 数据。

表 D-1 列出了受到主/从 LDAP 服务器配置（其中，Calendar Server 通过从属 LDAP 目录服务器访问主 LDAP 目录服务器）影响的 LDAP 属性。

表 D-1 受延迟影响的 Calendar Server LDAP 属性
操作	受影响的 LDAP 属性
自动置备	icsCalendar、icsSubscribed、icsCalendarOwned 和 icsDWPHost
日历组	icsSet
日历创建	icsCalendarOwned 和 icsSubscribed
日历订阅	icsSubscribed
用户选项	icsExtendedUserPrefs、icsFirstDay、icsTimeZone 和 icsFreeBusy
日历搜索	icsCalendarOwned

LDAP 数据高速缓存

LDAP 数据高速缓存通过为 Calendar Server 客户端提供最新的 LDAP 数据解决了主/从 LDAP 配置问题，即使主目录服务器还未更新每个从属目录服务器。

如果启用了 LDAP 数据高速缓存，Calendar Server 会将已提交的 LDAP 数据写入高速缓存数据库（ldapcache.db 文件）。默认情况下，LDAP 高速缓存数据库位于 cal_svr_base/var/opt/SUNWics5/csdb/ldap_cache 目录中，但如果需要，也可以配置其他位置。

客户端更改每个用户的 LDAP 数据时，Calendar Server 会将更改后的数据写入 LDAP 高速缓存数据库（同时也写入从属目录服务器）。随后的客户端操作将从高速缓存数据库中检索 LDAP 数据。此数据检索应用于单个用户的以下操作：

限制

在搜索项预期为条目列表时读取高速缓存。例如，搜索一个会议的出席者。此类搜索受所有 LDAP 延迟的限制。例如，如果 LDAP 搜索选项是活动的，在创建新日历后的延迟期间执行日历搜索将不会显示新创建的日历。

在多个前端服务器上读取和写入高速缓存。每个前端服务器都有自己的高速缓存，其高速缓存不能识别其他高速缓存中的数据。

处理并不总是登录到同一台服务器的用户的能力。此类用户将在每台服务器的高速缓存中生成不同的 LDAP 数据。

LDAP 数据高速缓存配置参数

表 D-2 介绍了 ics.conf 文件中有关 LDAP 数据高速缓存的配置参数。

表 D-2 LDAP 数据高速缓存配置参数
参数	说明
local.ldap.cache.enable	启用 (yes) 或禁用 (no) LDAP 数据高速缓存。默认值为 no。
local.ldap.cache.checkpointinterval	指定检查点线程休眠的秒数。默认时间为 60 秒。
local.ldap.cache.circularlogging	指定处理数据库日志文件后是否将其删除。默认值为 yes。
local.ldap.cache.homedir.path	指定 LDAP 数据高速缓存数据库的物理位置。默认值为 cal_svr_base/var/opt/SUNWics5/csdb/ldap_cache。
local.ldap.cache.logfilesizemb	以兆字节为单位指定检查点文件的最大大小。默认值为 10 兆字节。
local.ldap.cache.maxthreads	指定 LDAP 数据高速缓存数据库的最大线程数。默认值为 1000。
local.ldap.cache.mempoolsizemb	以兆字节为单位指定共享内存的大小。默认值为 4 兆字节。
local.ldap.cache.entryttl	以秒为单位指定 LDAP 数据高速缓存条目的生存时间 (TTL)。默认时间为 3600 秒（1 小时）。
local.ldap.cache.stat.enable	指定是否将访问记录到 LDAP 数据高速缓存，以及是否在日志文件中记录统计信息。默认值为 no。注意：此参数仅适用于调试模式。
local.ldap.cache.stat.interval	以秒为单位指定每个统计报告写入日志文件的时间间隔。默认值为 1800 秒（30 分钟）。
local.ldap.cache.cleanup.interval	以秒为单位指定清理数据库的时间间隔。默认值为 1800 秒（30 分钟）。


注意	如果没有正确关闭 Calendar Server 或正在运行 Calendar Server 的服务器，建议手动删除 ldap_cache 目录中的所有文件，以避免以后重新启动时发生数据库损坏问题。