Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Restaurer une sauvegarde de l’annuaire

Ce guide sert quand l’annuaire a perdu des données : suppression par erreur, disque défaillant ou serveur réinstallé. Comptez 10 minutes. L’annuaire est interrompu de quelques secondes à quelques minutes, selon sa taille.

Ce que vous avez

Chaque nuit à 02 h 30, le serveur de l’annuaire écrit deux fichiers dans /var/backups/open-iam/. Ils sont chiffrés avec age et conservés 30 jours :

  • AAAAMMJJ-HHMMSS-donnees.ldif.gz.age : toutes les entrées de l’annuaire (utilisateurs, groupes, comptes de service, politiques de mots de passe).
  • AAAAMMJJ-HHMMSS-config.ldif.gz.age : la configuration du serveur (cn=config).

La clé de déchiffrement se trouve dans /etc/open-iam/sauvegarde/age.key sur le serveur, et dans le fichier récapitulatif remis à la fin de l’installation. Sans cette clé, une sauvegarde est illisible. Si vous perdez le serveur, seule la copie du récapitulatif vous permet de la déchiffrer.

Chaque dimanche à 04 h 00, open-iam-test-restauration vérifie que la dernière sauvegarde se restaure, dans un annuaire temporaire, sans toucher au service. La supervision, si elle est installée, lève une alerte quand une sauvegarde échoue.

Restaurer les données

Sur le serveur de l’annuaire, en root :

  1. Listez les sauvegardes disponibles :

    open-iam-restauration
    

    Sans argument, le script affiche son usage et la liste des fichiers -donnees.

  2. Lancez la restauration en donnant l’horodatage choisi (ou le chemin complet du fichier) :

    open-iam-restauration 20261103-023000
    

    Le script procède dans cet ordre :

    • Il déchiffre la sauvegarde et compte ses entrées.
    • Il fait une sauvegarde préalable de l’annuaire en service, pour pouvoir revenir en arrière.
    • Il arrête slapd-ltb, écarte les bases actuelles dans /usr/local/openldap/var/avant-restauration-<date>, et recharge les données avec slapadd.
    • Il redémarre slapd-ltb et vérifie que le nombre d’entrées en service est celui de la sauvegarde.

    Résultat attendu :

    Restauration de 20261103-023000-donnees.ldif.gz.age : 42 entrées.
    Sauvegarde préalable de l'annuaire en service…
    Sauvegarde 20261103-171205 terminée.
    Restauration réussie : 42 entrées. Les bases précédentes sont conservées dans /usr/local/openldap/var/avant-restauration-20261103-171205 (à supprimer après vérification).
    
  3. Vérifiez depuis un poste qu’une connexion fonctionne (changement de mot de passe sur https://mdp.<domaine>, ou ldapwhoami en LDAPS), puis supprimez le dossier avant-restauration-<date> une fois rassuré.

Si une étape échoue après l’arrêt du service, le script remet les bases écartées en place et redémarre slapd-ltb. L’annuaire revient dans l’état d’avant la restauration.

Ce que la restauration ne fait pas

  • La configuration du serveur (cn=config) n’est pas restaurée, parce que l’installeur la produit. Pour un serveur réinstallé, rejouez l’installation avec le même openiam.yaml, puis restaurez avec ce guide.
  • Le journal d’accès (accesslog) repart à vide. Il sert à compter les échecs de connexion pour verrouiller les comptes.
  • Les outils web et la supervision n’ont pas de données à restaurer : leur état est dans l’annuaire ou se reconstruit.

Restaurer sur un serveur neuf

  1. Rejouez l’installation sur le serveur neuf avec le openiam.yaml téléchargé au récapitulatif (bouton « Télécharger openiam.yaml ») : même domaine, même base, mêmes composants.
  2. Copiez la clé age.key du récapitulatif dans /etc/open-iam/sauvegarde/age.key sur ce serveur (droits 0600). Elle remplace la clé générée par l’installation. Copiez aussi le fichier de sauvegarde dans /var/backups/open-iam/.
  3. Suivez « Restaurer les données » ci-dessus.

La sauvegarde contient les mots de passe des utilisateurs. Les comptes de service des outils (changement de mot de passe, pages blanches, support, supervision) posent un problème : ils reprennent les mots de passe de l’ancienne installation, alors que les outils du serveur neuf ont été configurés avec de nouveaux. Ce cas est prévu avec « Faire évoluer l’installation », qui rejouera l’installation et réinstallera ces mots de passe. D’ici là, restaurez de préférence sur le serveur d’origine, ou reportez à la main les mots de passe de l’ancien récapitulatif dans les outils.