====== Replication LDAP avec slurpd ======

:!: La methode de replication via slurpd n'est pas la méthode conseillée : on constate de nombreux problemes de synchronisation, il vaut mieux utiliser syncrepl pour la réplication (bientot un article la dessus). Pourquoi cet article alors ? tout simplement que syncrepl ne marche pas avec OpenLDAP 2.3 qui est inclus dans la Debian Etch par exemple

:!: Ebauche d'article : a compléter

===== Prérequis =====
  * Le serveur esclave doit être physiquement sur une autre machine que le serveur maître. Il n’est pas possible de faire de la réplication d’une base LDAP sur le même serveur que la base principale - de toutes manières cela n’a aucun intérêt.
  * Le type de backend utilisé doit être identique
  * Les versions (au moins majeures ) d’OpenLdap doivent etre identiques sur le maitre et l'esclave. Il est conseillé d'avoir la même version
  * Les serveurs maitre et esclave doivent être à la même l'heure

L'annuaire a répliquer est situé sur ldap-1.mondomaine.com, et la replication se fait sur ldap-2.mondomaine.com, la racine du LDAP a répliquer est "dc=local"

===== Préparatifs =====
  * Créer un compte dédié a la réplication dans l'annuaire LDAP. Ce compte sera nommé "Replicator" . Il ne sera pas utilisé sur le maitre, mais aura les droits d'ecriture sur le LDAP au niveau de l'esclave car il servira à effectuer les mises a jour. Le mot de passe de ce compte sera en clair dans le fichier de configuration /etc/ldap/slapd.conf

===== Configuration du maitre =====

Il faut maintenant configurer les services slapd et slurpd sur le maître pour que celui ci agisse en tant que tel. Cette configuration se fait dans le fichier /etc/openldap/slapd.conf :

Les directives suivantes sont à ajouter :
  * replogfile : fichier de réplication. C’est ce fichier qui est utilisé par slurpd pour la réplication.
  * replica : directive de compte de réplication. Ces informations seront utilisées par le maître pour contacter et mettre à jour l’esclave :
    * host : adresse IP et port ldap de l’esclave
    * binddn = compte à utiliser pour mettre à jour l’esclave.
    * bindmethod = methode de cryptage et mot de passe du compte de réplication (ici "simple")

La directive //replica// comprend les arguments host, binddn et bindmethod. Si vous passez une ligne entre les arguments assurez vous qu’il y ai au moins un espace en début de ligne comme dans l'exemple ci dessous.

Il faut donc ajouter dans le fichier slapd.conf :<code>
# Replication configuration (this computer is a slurpd master )
replogfile /var/lib/ldap/replog
replica host=ldap-2.mondomaine.com:389
         binddn="cn=Replicator,dc=local"
         bindmethod=simple credentials="MotDePasseEnClair"</code>
         
Il faut ensuite redémarrer le service pour prendre en compte ces modifications : <code>/etc/init.d/slapd restart</code>
<note> notez ici que le service slurpd demarre aussi a cuase des changements que nous avons fait dans la configuration</note>

On va en profiter pour faire un dump du LDAP qui servira plus tard : <code>
/etc/init.d/slapd stop ; slapcat -l /root/maitre.ldif ; /etc/init.d/slapd start</code>

<note>Il est nécessaire de stopper le maître à ce moment pour éviter des problèmes d’intégrité de la base.</note>

===== Configuration de l'esclave =====

  * installer le serveur LDAP sur le futur esclave :<code>apt-get install slapd</code>
  * stopper le serveur LDAP : <code>/etc/init.d/slapd stop</code>
  * copier les fichiers du maitre sur l'esclave (fichier slapd.conf, ainsi que les schémas additionnels de /etc/ldap/schema/ au besoin : le maitre comme l'esclave doivent utiliser les meme schémas) : (depuis l'esclave ) <code>
mv /etc/ldap /etc/ldap.orig
scp -r ldap-1.mondomaine.com:/etc/ldap /etc/
scp ldap-1.mondomaine.com:/root/maitre.ldif /root/
</code>
  * editer le fichier /etc/ldap/slapd.conf pour y commenter les lignes de réplication ajoutées précédemment sur le maitre
  * ajouter <code>#Replication configuration (this computer is a slurpd slave )
updatedn     "cn=Replicator,dc=local"
updateref    "ldap://ldap-1.mondomaine.com"
</code>
<note> la directive updateref n'est pas nécessaire, mais sert a pouvoir effectuer des modifications sur l'esclave : une modification effectuée sur l'esclave va etre "forwardée" sur le maitre pour etre appliquée</note>
  * Modifier les directives ACL pour donner les droits au compte Replicator de modifier l’esclave, ce qui donne par exemple :<code>access to *
        by dn="cn=Replicator,dc=local" write
        by dn="cn=admin,dc=local" write
        by * read</code>
   * Importer la base sur l’esclave :<code>slapadd -l /root/maitre.ldif</code>
   * Vérifier les droits d"écriture et de lecture dans le répertoire /var/lib/ldap qui doivent être positionnés pour l'utilisateur avec lequel tourne le service slapd (openldap:openldap sous debian) :<code>chown -R openldap:openldap /var/lib/ldap/</code>
   * démarrer le serveur esclave : <code>/etc/init.d/slapd start</code>