OpenLDAP镜像模式部署失败：slapd启动报syncprov-checkpoint指令错误

我之前也碰到过一模一样的问题！你看到的unknown directive <syncprov-checkpoint> inside backend database definition报错，核心原因是把syncprov overlay的专属指令直接放到了backend数据库定义块里，slapd根本不认识这个位置的这些指令。

问题根源 #

syncprov是OpenLDAP的同步提供器overlay，它的配置指令（比如syncprov-checkpoint）属于overlay层级的配置，必须放在overlay syncprov的专属配置块中，而不是直接写在backend的database定义段落里。

修正步骤 #

1. 确保syncprov模块已加载
   先检查你的slapd.conf里有没有加载syncprov模块，如果没有，加上这一行（大部分发行版的OpenLDAP都是动态加载模块的）：

   moduleload syncprov.la
   

   要是你的OpenLDAP是静态编译的，这一步可以跳过。

2. 调整配置结构
   把原来放在backend数据库定义里的syncprov相关指令，移到overlay syncprov块中，正确的配置结构应该是这样的：

   # 先定义backend和数据库基础配置
   backend mdb
   database mdb
   suffix "dc=yourdomain,dc=com"
   rootdn "cn=admin,dc=yourdomain,dc=com"
   rootpw {SSHA}xxxxxxxxxxxxxxxxxxx
   # 其他数据库配置（比如maxsize、directory存储路径等）...
   
   # 加载syncprov模块（如果之前没添加）
   moduleload syncprov.la
   
   # 配置syncprov overlay
   overlay syncprov
   syncprov-checkpoint 100 10  # 每100次操作或10分钟创建一次检查点
   syncprov-sessionlog 100     # 保留最近100条同步会话日志
   # 其他syncprov相关指令（比如syncprov-reloadhint等）...
   

3. 验证配置并重启服务
   先测试配置文件的合法性：

   slapd -t -f /etc/openldap/slapd.conf
   

   如果没有报错输出，再重启slapd服务：

   systemctl restart slapd
   

额外提示 #

• 不同版本的OpenLDAP对syncprov的指令可能有细微调整，你可以通过man syncprov查看对应版本的官方文档确认参数细节。
• 镜像模式部署时，两台服务器的syncprov配置要保持一致，同时还要确保syncrepl的配置正确指向对方节点。

内容的提问来源于stack exchange，提问作者sleepy